dsh-image-gen 0.6.7 → 0.6.8

package/lib/index.js

@@ -6006,6 +6006,15 @@ const CLOUD_IMAGE_PROVIDERS = [
 	"zhipu"
 ];
 /**
+* Providers the browser workbench can drive: the BYOK cloud set plus the
+* logged-in subscription channels. ComfyUI stays out; it has its own workflow
+* pipeline and no shared request shape.
+*/
+const STUDIO_PROVIDERS = [...CLOUD_IMAGE_PROVIDERS, ...SUBSCRIPTION_PROVIDERS];
+/** Timeout for one subscription image call, shared by the tool path and the
+* studio route so neither drifts from the other. */
+const SUBSCRIPTION_TIMEOUT_MS = 3e5;
+/**
 * Credential references resolved through the DSH Credentials service (BYOK).
 * These are POSIX-style reference names, not environment variables: the host
 * layers the process environment and its managed store behind them, so a name
@@ -7510,7 +7519,7 @@ async function editDashScopeImage(options) {
 			model: options.model,
 			input: { messages: [{
 				role: "user",
-				content: [...options.sourceImages.map((sourceImage) => ({ image: toDataUrl$2(sourceImage) })), { text: options.prompt }]
+				content: [...options.sourceImages.map((sourceImage) => ({ image: toDataUrl$3(sourceImage) })), { text: options.prompt }]
 			}] },
 			parameters: {
 				prompt_extend: true,
@@ -7527,7 +7536,7 @@ function formatSize(size) {
 	if (size === void 0 || size.length === 0) return void 0;
 	return size.replace("x", "*");
 }
-function toDataUrl$2(image) {
+function toDataUrl$3(image) {
 	return `data:${image.mediaType};base64,${Buffer.from(image.data).toString("base64")}`;
 }
 async function requestQwenImage(options) {
@@ -8117,7 +8126,7 @@ async function editOpenAICompatibleImage(input) {
 	if (input.editFormat === "jsonImageUrlArray") {
 		const body = {
 			model: input.model,
-			images: input.sourceImages.map((sourceImage) => ({ image_url: toDataUrl$1(sourceImage) })),
+			images: input.sourceImages.map((sourceImage) => ({ image_url: toDataUrl$2(sourceImage) })),
 			prompt: input.prompt,
 			n: 1,
 			size: "auto",
@@ -8178,7 +8187,7 @@ function imageEndpoint$1(baseURL, operation) {
 		throw new Error("Image endpoint must be an absolute URL");
 	}
 }
-function toDataUrl$1(image) {
+function toDataUrl$2(image) {
 	return `data:${image.mediaType};base64,${Buffer.from(image.data).toString("base64")}`;
 }
 function firstImage$1(value) {
@@ -8295,7 +8304,7 @@ async function editSeedreamImage(input) {
 		body: JSON.stringify({
 			model: input.model,
 			prompt: input.prompt,
-			image: input.sourceImages.map(toDataUrl),
+			image: input.sourceImages.map(toDataUrl$1),
 			...input.size === void 0 || input.size.length === 0 ? {} : { size: input.size },
 			response_format: "b64_json"
 		})
@@ -8323,7 +8332,7 @@ function imageEndpoint(baseURL) {
 		throw new Error("Seedream image endpoint must be an absolute URL");
 	}
 }
-function toDataUrl(image) {
+function toDataUrl$1(image) {
 	return `data:${image.mediaType};base64,${Buffer.from(image.data).toString("base64")}`;
 }
 function firstImage(value) {
@@ -8598,6 +8607,8 @@ const CODEX_TOKEN = "https://auth.openai.com/oauth/token";
 const CODEX_SCOPE = "openid profile email offline_access api.connectors.read api.connectors.invoke";
 /** Where the ChatGPT subscription image request goes. */
 const CODEX_IMAGE_URL = "https://chatgpt.com/backend-api/codex/images/generations";
+/** Where the ChatGPT subscription image edit request goes. */
+const CODEX_IMAGE_EDIT_URL = "https://chatgpt.com/backend-api/codex/images/edits";
 /** The model served by this endpoint (probed live: gpt-image-2.5-flare works
 * on the ChatGPT internal generations route as of 2026-09-14). */
 const CODEX_IMAGE_MODEL = "gpt-image-2.5-flare";
@@ -8695,6 +8706,8 @@ const GROK_TOKEN = "https://auth.x.ai/oauth2/token";
 const GROK_SCOPE = "openid profile email offline_access grok-cli:access api:access conversations:read conversations:write";
 /** Where the Grok subscription image request goes. */
 const GROK_IMAGE_URL = "https://api.x.ai/v1/images/generations";
+/** Where the Grok subscription image edit request goes. */
+const GROK_IMAGE_EDIT_URL = "https://api.x.ai/v1/images/edits";
 /** The model served by this endpoint. */
 const GROK_IMAGE_MODEL = "grok-imagine-image-2.0";
 /** Public client id of the grok-cli; vendor-fixed redirect on 127.0.0.1:56121. */
@@ -9039,15 +9052,22 @@ function platformOf() {
 * Build the streamGenerateContent request body for one image generation.
 * Ported from the reference buildImageRequest + the wrapping envelope: no
 * tools, no systemInstruction, no thinkingConfig; responseModalities asks
-* for TEXT+IMAGE.
+* for TEXT+IMAGE. Reference images (edits) ride along as inlineData parts
+* before the text part, mirroring the reference implementation.
 */
 function antigravityImageBody(options) {
 	const imageConfig = { aspectRatio: options.aspectRatio !== void 0 && ASPECT_RATIOS.includes(options.aspectRatio) ? options.aspectRatio : "1:1" };
 	if (options.hd === true) imageConfig.imageSize = "4K";
+	const parts = [];
+	for (const image of options.referenceImages ?? []) parts.push({ inlineData: {
+		mimeType: image.mediaType,
+		data: Buffer.from(image.data).toString("base64")
+	} });
+	parts.push({ text: options.prompt });
 	return {
 		contents: [{
 			role: "user",
-			parts: [{ text: options.prompt }]
+			parts
 		}],
 		generationConfig: {
 			candidateCount: 1,
@@ -9081,7 +9101,8 @@ async function antigravityGenerateImage(options) {
 	const inner = antigravityImageBody({
 		prompt: options.prompt,
 		...options.aspectRatio !== void 0 ? { aspectRatio: options.aspectRatio } : {},
-		...options.hd !== void 0 ? { hd: options.hd } : {}
+		...options.hd !== void 0 ? { hd: options.hd } : {},
+		...options.referenceImages !== void 0 ? { referenceImages: options.referenceImages } : {}
 	});
 	const body = antigravityEnvelope(options.projectId, inner);
 	let lastError = "no endpoint succeeded";
@@ -9296,6 +9317,8 @@ var SubscriptionManager = class {
 		const session = await this.ensureFresh(vendor);
 		const text = prompt.trim();
 		if (text.length === 0) throw new Error("prompt must be a non-empty string");
+		const references = options.referenceImages ?? [];
+		if (references.length > 5) throw new Error(`订阅生图最多支持 ${String(5)} 张参考图，当前 ${String(references.length)} 张`);
 		if (vendor === "antigravity") {
 			const projectId = await this.ensureAntigravityProject(session);
 			const aspectRatio = antigravityAspectRatioOf(options.size);
@@ -9305,6 +9328,7 @@ var SubscriptionManager = class {
 				prompt: text,
 				...aspectRatio !== void 0 ? { aspectRatio } : {},
 				hd: options.quality === "hd" || options.quality === "high",
+				...references.length > 0 ? { referenceImages: references } : {},
 				...options.signal !== void 0 ? { signal: options.signal } : {}
 			})).b64 }];
 		}
@@ -9312,16 +9336,17 @@ var SubscriptionManager = class {
 		let headers;
 		let body;
 		if (vendor === "codex") {
-			url = CODEX_IMAGE_URL;
+			url = references.length > 0 ? CODEX_IMAGE_EDIT_URL : CODEX_IMAGE_URL;
 			headers = codexIdentityHeaders(session);
 			body = {
 				prompt: text,
 				model: CODEX_IMAGE_MODEL,
+				...references.length > 0 ? { images: references.map((image) => ({ image_url: toDataUrl(image) })) } : {},
 				...options.size !== void 0 && options.size.length > 0 ? { size: options.size } : {},
 				...options.quality !== void 0 && options.quality.length > 0 ? { quality: options.quality } : {}
 			};
 		} else {
-			url = GROK_IMAGE_URL;
+			url = references.length > 0 ? GROK_IMAGE_EDIT_URL : GROK_IMAGE_URL;
 			headers = grokIdentityHeaders(session);
 			const aspect = {
 				"1024x1024": "1:1",
@@ -9334,6 +9359,10 @@ var SubscriptionManager = class {
 				prompt: text,
 				model: GROK_IMAGE_MODEL,
 				response_format: "b64_json",
+				...references.length > 0 ? { images: references.map((image) => ({
+					type: "image_url",
+					image_url: toDataUrl(image)
+				})) } : {},
 				...options.size !== void 0 && aspect[options.size] !== void 0 ? { aspect_ratio: aspect[options.size] } : {},
 				...level !== void 0 ? { quality: level } : {}
 			};
@@ -9380,6 +9409,10 @@ function antigravityAspectRatioOf(size) {
 	if (mapped !== void 0) return mapped;
 	return /^\d+:\d+$/.test(size) ? size : "1:1";
 }
+/** Encode one reference image as the data URL the edit endpoints accept. */
+function toDataUrl(image) {
+	return `data:${image.mediaType};base64,${Buffer.from(image.data).toString("base64")}`;
+}
 /** Response parsing: both vendors reply in the same `{data:[{b64_json}]}` shape. */
 function parseImages(payload) {
 	const body = typeof payload === "object" && payload !== null ? payload : {};
@@ -9524,20 +9557,21 @@ function jsonError$3(res, status, code) {
 }
 //#endregion
 //#region lib/types/subscription.js
-/** Timeout for one subscription image call, mirroring the other adapters. */
-const SUBSCRIPTION_TIMEOUT_MS = 3e5;
 /**
 * Generate one image through a logged-in subscription account. Returns the
 * same `{ data, mediaType }` contract as the API-key adapters so the caller
-* can feed it straight into `saveGenerated`.
+* can feed it straight into `saveGenerated`. With sourceImages the call is
+* an edit: the vendor layer picks the channel's edit endpoint.
 */
 async function generateSubscriptionImage(options) {
 	const { manager, provider, prompt, maxBytes, signal } = options;
 	const size = options.size?.trim();
+	const sourceImages = options.sourceImages ?? [];
 	const result = await withTimeout(manager.generate({
 		vendor: vendorOf(provider),
 		prompt,
 		...size !== void 0 && size.length > 0 ? { size } : {},
+		...sourceImages.length > 0 ? { referenceImages: sourceImages } : {},
 		signal
 	}), signal);
 	const first = Array.isArray(result) ? result[0] : void 0;
@@ -9552,10 +9586,6 @@ async function generateSubscriptionImage(options) {
 		...typeof first.revisedPrompt === "string" && first.revisedPrompt.length > 0 ? { revisedPrompt: first.revisedPrompt } : {}
 	};
 }
-/** Subscription channels are prompt-only today; edit_image is rejected outright. */
-function assertSubscriptionEditUnsupported(provider) {
-	throw new Error(`edit_image with ${SUBSCRIPTION_PROVIDER_DISPLAY_NAMES[provider]} is not supported yet: the subscription channel only accepts text prompts. Retry with an API-key provider (for example google or openai) through the provider argument.`);
-}
 /** Run one promise with the subscription timeout and the call's abort signal. */
 async function withTimeout(promise, signal) {
 	let timer;
@@ -20467,24 +20497,63 @@ const RATIO_LABELS = {
 	"9:16": "9:16 竖屏"
 };
 /** Return only browser-safe capability data. */
-async function describeStudio(ctx, config) {
+async function describeStudio(ctx, config, subscriptions) {
 	const configuredEntries = await Promise.all(CLOUD_IMAGE_PROVIDERS.map(async (provider) => {
 		return [provider, await resolveApiKey(ctx, provider) !== void 0];
 	}));
 	const configured = Object.fromEntries(configuredEntries);
-	const profiles = CLOUD_IMAGE_PROVIDERS.map((provider) => studioProfile(config, provider, configured[provider]));
+	const cloudProfiles = CLOUD_IMAGE_PROVIDERS.map((provider) => studioProfile(config, provider, configured[provider]));
+	const subStatuses = await Promise.all(SUBSCRIPTION_PROVIDERS.map(async (provider) => {
+		return [provider, subscriptions !== void 0 && (await subscriptions.loginStatus(vendorOf(provider))).state === "logged-in"];
+	}));
+	const subProfiles = SUBSCRIPTION_PROVIDERS.map((provider) => {
+		return subscriptionStudioProfile(provider, subStatuses.find((entry) => entry[0] === provider)?.[1] === true);
+	});
+	const profiles = [...cloudProfiles, ...subProfiles];
 	const preferred = config.provider;
 	return {
 		providers: profiles,
-		activeProvider: preferred !== void 0 && cloudProvider$1(preferred) ? preferred : profiles.find((profile) => profile.configured)?.provider ?? "google"
+		activeProvider: isStudioPreferred(preferred) ? preferred : profiles.find((profile) => profile.configured)?.provider ?? "google"
+	};
+}
+/** The persisted default provider is usable directly when the workbench can drive it. */
+function isStudioPreferred(preferred) {
+	return preferred !== void 0 && CLOUD_IMAGE_PROVIDERS.includes(preferred) || preferred !== void 0 && SUBSCRIPTION_PROVIDERS.includes(preferred);
+}
+/** Fixed parameter shape for subscription channels: one "channel default" pair. */
+function subscriptionStudioProfile(provider, signedIn) {
+	const channelDefault = {
+		value: "auto",
+		label: "通道默认"
+	};
+	return {
+		provider,
+		label: SUBSCRIPTION_DISPLAY_LABELS[provider],
+		model: DEFAULT_SUBSCRIPTION_MODELS[provider],
+		configured: signedIn,
+		supportsEditing: true,
+		ratioOptions: [channelDefault],
+		qualityOptions: [channelDefault],
+		defaultRatio: "auto",
+		defaultQuality: "auto"
 	};
 }
+/** Short display names for the workbench subscription rows. */
+const SUBSCRIPTION_DISPLAY_LABELS = {
+	"chatgpt-sub": "ChatGPT 订阅",
+	"grok-sub": "Grok 订阅",
+	"google-sub": "Google 订阅"
+};
 /** Execute one validated browser workbench request using the existing provider adapters. */
-async function generateFromStudio(ctx, config, input, signal, fallbackWorkspaceRoot) {
+async function generateFromStudio(ctx, config, input, signal, fallbackWorkspaceRoot, subscriptions) {
+	if (isSubscriptionProvider(input.provider)) {
+		if (subscriptions === void 0) throw new Error("订阅生图不可用：订阅管理器未初始化");
+		assertAllowed(subscriptionStudioProfile(input.provider, true), input);
+		return generateSubscriptionFromStudio(ctx, subscriptions, input, signal);
+	}
 	assertAllowed(studioProfile(config, input.provider, true), input);
 	const active = resolveProvider(withProviderOverrides(config, input.provider, input.model));
 	if (active.provider === "comfyui") throw new Error("ComfyUI 暂未接入工作台");
-	if (isSubscriptionProvider(active.provider)) throw new Error("订阅生图暂未接入工作台，请通过对话或设置切换默认 Provider 使用");
 	const wired = active;
 	const credential = await requireApiKey(ctx, input.provider);
 	const rawRefs = input.references ?? (input.reference ? [input.reference] : []);
@@ -20672,6 +20741,76 @@ async function runPool(tasks, concurrency = 2) {
 	await Promise.all(workers);
 	return results;
 }
+/**
+* Subscription workbench generation: one prompt, channel-default parameters,
+* through the shared generateSubscriptionImage wrapper (timeout, b64 decode,
+* size check) so the downstream attachment flow is identical to API keys.
+*/
+async function generateSubscriptionFromStudio(ctx, subscriptions, input, signal) {
+	const provider = input.provider;
+	const rawRefs = input.references ?? (input.reference ? [input.reference] : []);
+	if (input.mode === "edit" && rawRefs.length === 0) throw new Error("图生图需要至少一张参考图");
+	const sourceImages = input.mode === "edit" ? await Promise.all(rawRefs.map((ref) => readStudioReference(ctx, ref, signal))) : [];
+	const startedAt = Date.now();
+	const count = input.count ?? 1;
+	const generateSingle = async (index) => {
+		const generated = await generateSubscriptionImage({
+			manager: subscriptions,
+			provider,
+			prompt: input.prompt,
+			...sourceImages.length > 0 ? { sourceImages } : {},
+			maxBytes: ctx.attachments.imageLimits.maxImageBytes,
+			signal
+		});
+		if (!ctx.attachments.imageLimits.mediaTypes.includes(generated.mediaType)) throw new Error(`当前 DSH 不支持保存 ${generated.mediaType} 图片`);
+		return {
+			attachment: await ctx.attachments.saveImage({
+				data: generated.data,
+				mediaType: generated.mediaType,
+				name: count > 1 ? `studio-image-${index + 1}` : "studio-image"
+			}),
+			output: "通道默认"
+		};
+	};
+	if (count === 1) {
+		const single = await generateSingle(0);
+		return subscriptionResponse(input, startedAt, 1, 0, [single], single);
+	}
+	const poolResults = await runPool(Array.from({ length: count }, (_, i) => () => generateSingle(i)), 2);
+	const successes = [];
+	const errors = [];
+	for (let i = 0; i < poolResults.length; i++) {
+		const r = poolResults[i];
+		if (r.status === "fulfilled") successes.push(r.value);
+		else errors.push({
+			index: i,
+			message: r.reason instanceof Error ? r.reason.message : String(r.reason)
+		});
+	}
+	if (successes.length === 0) {
+		const firstReason = poolResults[0] && poolResults[0].status === "rejected" ? poolResults[0].reason : /* @__PURE__ */ new Error("订阅生图全部失败");
+		throw firstReason instanceof Error ? firstReason : new Error(String(firstReason));
+	}
+	const first = successes[0];
+	return subscriptionResponse(input, startedAt, count, errors.length, successes, first, errors);
+}
+/** Assemble the subscription workbench response with exactOptionalPropertyTypes-safe spreads. */
+function subscriptionResponse(input, startedAt, requestedCount, failedCount, items, primary, errors) {
+	return {
+		attachment: primary.attachment,
+		output: primary.output,
+		provider: input.provider,
+		model: input.model,
+		prompt: input.prompt,
+		createdAt: Date.now(),
+		elapsedMs: Date.now() - startedAt,
+		requestedCount,
+		failedCount,
+		items,
+		...primary.savedTo ? { savedTo: primary.savedTo } : {},
+		...errors !== void 0 && errors.length > 0 ? { errors } : {}
+	};
+}
 function studioProfile(config, provider, configured) {
 	let active;
 	try {
@@ -20725,7 +20864,7 @@ function studioProfile(config, provider, configured) {
 function profile(provider, model, configured, ratioOptions, qualityOptions, defaultRatio, defaultQuality) {
 	return {
 		provider,
-		label: PROVIDER_DISPLAY_NAMES[provider],
+		label: CLOUD_DISPLAY_LABELS[provider],
 		model,
 		configured,
 		supportsEditing: true,
@@ -20735,6 +20874,16 @@ function profile(provider, model, configured, ratioOptions, qualityOptions, defa
 		defaultQuality
 	};
 }
+/** Display names for the BYOK cloud rows, mirroring the settings card. */
+const CLOUD_DISPLAY_LABELS = {
+	google: "Google Gemini",
+	openai: "OpenAI",
+	"openai-compat": "OpenAI 兼容",
+	seedream: "Seedream",
+	dashscope: "DashScope",
+	xai: "xAI Grok",
+	zhipu: "智谱 GLM"
+};
 function option(value) {
 	return {
 		value,
@@ -20788,9 +20937,6 @@ function dashScopeSize(ratio) {
 		"9:16": "928*1664"
 	}[ratio] ?? "1024*1024";
 }
-function cloudProvider$1(value) {
-	return CLOUD_IMAGE_PROVIDERS.includes(value);
-}
 //#endregion
 //#region lib/types/studio-route.js
 /** Serve workbench capabilities and generation requests without exposing provider credentials. */
@@ -20804,8 +20950,10 @@ async function serveStudio(req, res, deps) {
 	if (req.method !== "POST") return jsonError$1(res, 405, "method-not-allowed");
 	if (!(req.headers["content-type"] ?? "").toLowerCase().startsWith("application/json")) return jsonError$1(res, 415, "json-required");
 	const controller = new AbortController();
-	const upstreamTimeout = AbortSignal.timeout(15e4);
-	const signal = AbortSignal.any([controller.signal, upstreamTimeout]);
+	const watchdog = new AbortController();
+	const CLOUD_WATCHDOG_MS = 15e4;
+	let subscriptionChannel = false;
+	const signal = AbortSignal.any([controller.signal, watchdog.signal]);
 	const onConnectionClose = () => {
 		if (!res.writableEnded) controller.abort(/* @__PURE__ */ new Error("The browser closed the image generation request."));
 	};
@@ -20821,11 +20969,15 @@ async function serveStudio(req, res, deps) {
 		} catch (error) {
 			return jsonError$1(res, 400, errorMessage(error, "invalid-request"));
 		}
+		subscriptionChannel = isSubscriptionProvider(input.provider);
+		setTimeout(() => {
+			watchdog.abort();
+		}, subscriptionChannel ? SUBSCRIPTION_TIMEOUT_MS : CLOUD_WATCHDOG_MS).unref?.();
 		const output = await deps.generate(input, signal);
 		if (!res.headersSent && !res.writableEnded && !res.destroyed) json$1(res, 200, output);
 	} catch (error) {
 		if (res.headersSent || res.writableEnded || res.destroyed) return;
-		if (upstreamTimeout.aborted) return jsonError$1(res, 504, "上游生成超时（150 秒未返回），请检查网络或代理后重试");
+		if (watchdog.signal.aborted) return jsonError$1(res, 504, subscriptionChannel ? "上游生成超时（订阅通道 300 秒未返回），请稍后重试" : "上游生成超时（150 秒未返回），请检查网络或代理后重试");
 		jsonError$1(res, controller.signal.aborted ? 499 : 502, errorMessage(error, "generation-failed"));
 	} finally {
 		res.off("close", onConnectionClose);
@@ -20837,7 +20989,7 @@ function parseStudioGenerateRequest(value) {
 	const input = record$1(value);
 	if (input === void 0) throw new Error("请求格式无效");
 	if (input.mode !== "generate" && input.mode !== "edit") throw new Error("请选择生成类型");
-	if (!cloudProvider(input.provider)) throw new Error("不支持该图像 Provider");
+	if (!studioProvider(input.provider)) throw new Error("不支持该图像 Provider");
 	const prompt = requiredText(input.prompt, "请输入提示词", 2e3);
 	const model = requiredText(input.model, "请选择模型", 200);
 	const ratio = requiredText(input.ratio, "请选择比例", 32);
@@ -20889,8 +21041,8 @@ function requiredText(value, message, maxLength) {
 	if (text.length > maxLength) throw new Error(`${message}（最多 ${String(maxLength)} 个字符）`);
 	return text;
 }
-function cloudProvider(value) {
-	return typeof value === "string" && CLOUD_IMAGE_PROVIDERS.includes(value);
+function studioProvider(value) {
+	return typeof value === "string" && STUDIO_PROVIDERS.includes(value);
 }
 function imageMediaType(value) {
 	return value === "image/png" || value === "image/jpeg" || value === "image/webp" || value === "image/gif";
@@ -21386,7 +21538,7 @@ function apply(ctx, config = {}) {
 		path: STUDIO_ROUTE,
 		handler: (req, res) => serveStudio(req, res, {
 			describe: async () => {
-				const base = await describeStudio(ctx, current());
+				const base = await describeStudio(ctx, current(), subscriptionManager);
 				const workspaces = await getDshWorkspacesFull().catch(() => []);
 				const activeRoot = Array.from(knownWorkspaceRoots)[0] || workspaces[0]?.path || process.cwd();
 				return {
@@ -21397,7 +21549,7 @@ function apply(ctx, config = {}) {
 			},
 			generate: (input, signal) => {
 				const fallbackRoot = Array.from(knownWorkspaceRoots)[0] || process.cwd();
-				return generateFromStudio(ctx, current(), input, signal, fallbackRoot);
+				return generateFromStudio(ctx, current(), input, signal, fallbackRoot, subscriptionManager);
 			},
 			maxBodyBytes: Math.ceil(ctx.attachments.imageLimits.maxImageBytes * 1.4 * 5) + 262144
 		})
@@ -21560,7 +21712,7 @@ function apply(ctx, config = {}) {
 					"grok-sub",
 					"google-sub"
 				],
-				description: "Optional provider for this call only (for example when the user asks to use a specific provider); omit to use the configured default. chatgpt-sub, grok-sub, and google-sub cannot edit images yet; the subscription channel is text-prompt only, so retry editing with an API-key provider instead."
+				description: "Optional provider for this call only (for example when the user asks to use a specific provider); omit to use the configured default. chatgpt-sub, grok-sub, and google-sub edit images through the logged-in subscription account instead of an API key."
 			},
 			model: {
 				type: "string",
@@ -21623,7 +21775,6 @@ function apply(ctx, config = {}) {
 		output: imageOutput("Edited"),
 		async execute(args, exec) {
 			const active = resolveProvider(withProviderOverrides(current(), providerOverrideOf(args.provider), args.model));
-			if (active.provider === "chatgpt-sub" || active.provider === "grok-sub" || active.provider === "google-sub") assertSubscriptionEditUnsupported(active.provider);
 			const canvasSelection = args.source === "canvas_selection";
 			if (canvasSelection && (args.source_attachment_id !== void 0 || Array.isArray(args.source_attachment_ids) || args.source_path !== void 0 || Array.isArray(args.source_paths))) throw new Error("edit_image source=canvas_selection cannot be combined with source_attachment_id, source_attachment_ids, source_path, or source_paths; provide exactly one selector");
 			const sourceImages = canvasSelection ? await resolveCanvasSelectionReferences({
@@ -21660,6 +21811,18 @@ function apply(ctx, config = {}) {
 					signal: exec.signal
 				}), active.provider, workflow.name, "API workflow", current(), exec, knownWorkspaceRoots);
 			}
+			if (active.provider === "chatgpt-sub" || active.provider === "grok-sub" || active.provider === "google-sub") {
+				if (sourceImages.length === 0) throw new Error("edit_image requires a reference image");
+				return saveGenerated(ctx, await generateSubscriptionImage({
+					manager: subscriptionManager,
+					provider: active.provider,
+					prompt: args.prompt,
+					sourceImages,
+					...args.size !== void 0 ? { size: args.size } : {},
+					maxBytes: ctx.attachments.imageLimits.maxImageBytes,
+					signal: exec.signal
+				}), active.provider, active.model, "subscription edit", current(), exec, knownWorkspaceRoots);
+			}
 			const credential = await requireApiKey(ctx, active.provider, "edit_image");
 			if (active.provider === "google") {
 				const aspectRatio = args.aspect_ratio ?? active.aspectRatio;

package/lib/types/client/conversation-image-revisions.d.ts

@@ -1,10 +1,10 @@
 import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
-import { type CloudImageProvider } from '../shared.js';
+import { type StudioProvider } from '../shared.js';
 /** One regenerated version displayed in place of an original conversation image. */
 export interface ConversationImageRevision {
     attachment: ImageAttachmentRef;
     prompt: string;
-    provider: CloudImageProvider;
+    provider: StudioProvider;
     model: string;
     output: string;
     createdAt: number;

package/lib/types/client/gallery-view.d.ts

@@ -192,6 +192,10 @@ export interface GalleryViewTabProps {
     useSession?: (selector: (state: any) => any) => any;
     useSessions?: (selector: (state: any) => any) => any;
     useWorkspaces?: (selector: (state: any) => any) => any;
+    /** Host credential-change notifier; forwarded to the studio workbench. */
+    credentialEvents?: {
+        listen(callback: () => void): () => void;
+    } | undefined;
     /**
      * Right-sidebar variant (DSH official `sidebar.right.pane.tab` seat). The
      * native conversation stays in the main area, so the composer must NOT be

package/lib/types/client/multi-model-compare.d.ts

@@ -1,4 +1,4 @@
-import type { CloudImageProvider, StudioProviderProfile } from '../shared.js';
+import type { StudioProvider, StudioProviderProfile } from '../shared.js';
 export interface ComparisonTarget {
     profile: StudioProviderProfile;
     ratio: string;
@@ -6,6 +6,6 @@ export interface ComparisonTarget {
     adjusted: boolean;
 }
 /** Map one shared output intent to settings accepted by every target model. */
-export declare function buildComparisonTargets(profiles: readonly StudioProviderProfile[], selectedProviders: readonly CloudImageProvider[], ratio: string, quality: string): ComparisonTarget[];
+export declare function buildComparisonTargets(profiles: readonly StudioProviderProfile[], selectedProviders: readonly StudioProvider[], ratio: string, quality: string): ComparisonTarget[];
 /** Start with two models, not every configured API, to avoid surprise spend. */
-export declare function initialComparisonProviders(profiles: readonly StudioProviderProfile[], activeProvider: CloudImageProvider): CloudImageProvider[];
+export declare function initialComparisonProviders(profiles: readonly StudioProviderProfile[], activeProvider: StudioProvider): StudioProvider[];

package/lib/types/client/provider-pill.d.ts

@@ -45,5 +45,5 @@ export declare function pillModelOf(provider: ImageProvider, value: PillSettings
 /** One fixed-position provider menu anchored to the pill button. */
 export declare function ImageProviderPill(props: ProviderPillFace): import("react").JSX.Element | null;
 /** Styles for the pill and its fixed-position menu; injected by the client entry. */
-export declare const PROVIDER_PILL_STYLE = "\n.dsh-ig-pill-root{position:relative;display:inline-flex;align-items:center;height:26px}\n.dsh-ig-pill-button{display:inline-flex;align-items:center;gap:5px;height:26px;padding:0 8px 0 7px;border:1px solid var(--dsw-alias-border-l2,#e5e7eb);border-radius:13px;background:var(--dsw-alias-bg-layer-3,#fff);color:var(--dsw-alias-label-secondary,#4b5563);font:inherit;font-size:12px;line-height:1;cursor:pointer;transition:border-color .15s,background .15s,color .15s;-webkit-user-select:none;user-select:none}\n.dsh-ig-pill-button:hover:not(:disabled){border-color:var(--dsw-alias-label-dimmed,#9ca3af);color:var(--dsw-alias-label-primary,#111827)}\n.dsh-ig-pill-button:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#4c78ff);outline-offset:1px}\n.dsh-ig-pill-button:disabled{opacity:.5;cursor:not-allowed}\n.dsh-ig-pill-button-open{border-color:var(--dsw-alias-brand-primary,#4c78ff);color:var(--dsw-alias-label-primary,#111827)}\n.dsh-ig-pill-icon{flex:none;color:var(--dsw-alias-brand-primary,#4c78ff)}\n.dsh-ig-pill-provider{max-width:96px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}\n.dsh-ig-pill-caret{display:inline-flex;flex:none;transition:transform .15s}\n.dsh-ig-pill-caret-open{transform:rotate(180deg)}\n.dsh-ig-pill-menu{position:fixed;z-index:1000;min-width:264px;max-width:min(320px,calc(100vw - 24px));padding:6px;border:1px solid var(--dsw-alias-border-l2,#e5e7eb);border-radius:12px;background:var(--dsw-alias-bg-layer-3,#fff);box-shadow:0 12px 32px rgba(0,0,0,.16),0 2px 8px rgba(0,0,0,.08);max-height:min(320px,calc(100vh - 48px));overflow-y:auto}\n.dsh-ig-pill-menu-title{padding:6px 8px 4px;font-size:11px;font-weight:600;color:var(--dsw-alias-label-tertiary,#6b7280)}\n.dsh-ig-pill-option{display:flex;width:100%;align-items:center;gap:9px;padding:7px 8px;border:0;border-radius:8px;background:none;font:inherit;color:inherit;text-align:left;cursor:pointer}\n.dsh-ig-pill-option:hover:not(:disabled){background:var(--dsw-alias-bg-layer-2,#f3f4f6)}\n.dsh-ig-pill-option:disabled{opacity:.6;cursor:default}\n.dsh-ig-pill-option:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#4c78ff);outline-offset:-2px}\n.dsh-ig-pill-option-active{background:var(--dsw-alias-brand-primary-soft,rgba(76,120,255,.10))}\n.dsh-ig-pill-dot{flex:none;width:7px;height:7px;border-radius:50%}\n.dsh-ig-pill-dot-ok{background:#22c55e}\n.dsh-ig-pill-dot-missing{background:#9ca3af}\n.dsh-ig-pill-dot-neutral{background:#4c78ff}\n.dsh-ig-pill-option-text{flex:1;min-width:0;display:flex;flex-direction:column;gap:2px}\n.dsh-ig-pill-option-name{font-size:12.5px;font-weight:500;color:var(--dsw-alias-label-primary,#111827);line-height:1.2}\n.dsh-ig-pill-option-sub{font-size:11px;color:var(--dsw-alias-label-tertiary,#6b7280);line-height:1.2;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}\n.dsh-ig-pill-check{flex:none;color:var(--dsw-alias-brand-primary,#4c78ff)}\n.dsh-ig-pill-error{margin-top:4px;padding:6px 8px;border-radius:8px;background:rgba(239,68,68,.08);color:#ef4444;font-size:11.5px;line-height:1.4;word-break:break-all}\n";
+export declare const PROVIDER_PILL_STYLE = "\n.dsh-ig-pill-root{position:relative;display:inline-flex;align-items:center;height:28px}\n.dsh-ig-pill-button{display:inline-flex;align-items:center;gap:5px;height:28px;padding:0 9px 0 8px;border:1px solid var(--dsw-alias-border-l2,#e5e7eb);border-radius:14px;background:var(--dsw-alias-bg-layer-3,#fff);color:var(--dsw-alias-label-secondary,#4b5563);font:inherit;font-size:13px;line-height:20px;cursor:pointer;transition:border-color .15s,background .15s,color .15s;-webkit-user-select:none;user-select:none}\n.dsh-ig-pill-button:hover:not(:disabled){border-color:var(--dsw-alias-label-dimmed,#9ca3af);color:var(--dsw-alias-label-primary,#111827)}\n.dsh-ig-pill-button:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#4c78ff);outline-offset:1px}\n.dsh-ig-pill-button:disabled{opacity:.5;cursor:not-allowed}\n.dsh-ig-pill-button-open{border-color:var(--dsw-alias-brand-primary,#4c78ff);color:var(--dsw-alias-label-primary,#111827)}\n.dsh-ig-pill-icon{flex:none;color:var(--dsw-alias-brand-primary,#4c78ff)}\n.dsh-ig-pill-provider{max-width:150px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}\n.dsh-ig-pill-caret{display:inline-flex;flex:none;transition:transform .15s}\n.dsh-ig-pill-caret-open{transform:rotate(180deg)}\n@container (max-width:700px){\n  .dsh-ig-pill-caret{display:none}\n  .dsh-ig-pill-button{padding:0 7px 0 6px}\n}\n.dsh-ig-pill-menu{position:fixed;z-index:1000;min-width:264px;max-width:min(320px,calc(100vw - 24px));padding:6px;border:1px solid var(--dsw-alias-border-l2,#e5e7eb);border-radius:12px;background:var(--dsw-alias-bg-layer-3,#fff);box-shadow:0 12px 32px rgba(0,0,0,.16),0 2px 8px rgba(0,0,0,.08);max-height:min(320px,calc(100vh - 48px));overflow-y:auto}\n.dsh-ig-pill-menu-title{padding:6px 8px 4px;font-size:11px;font-weight:600;color:var(--dsw-alias-label-tertiary,#6b7280)}\n.dsh-ig-pill-option{display:flex;width:100%;align-items:center;gap:9px;padding:7px 8px;border:0;border-radius:8px;background:none;font:inherit;color:inherit;text-align:left;cursor:pointer}\n.dsh-ig-pill-option:hover:not(:disabled){background:var(--dsw-alias-bg-layer-2,#f3f4f6)}\n.dsh-ig-pill-option:disabled{opacity:.6;cursor:default}\n.dsh-ig-pill-option:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#4c78ff);outline-offset:-2px}\n.dsh-ig-pill-option-active{background:var(--dsw-alias-brand-primary-soft,rgba(76,120,255,.10))}\n.dsh-ig-pill-dot{flex:none;width:7px;height:7px;border-radius:50%}\n.dsh-ig-pill-dot-ok{background:#22c55e}\n.dsh-ig-pill-dot-missing{background:#9ca3af}\n.dsh-ig-pill-dot-neutral{background:#4c78ff}\n.dsh-ig-pill-option-text{flex:1;min-width:0;display:flex;flex-direction:column;gap:2px}\n.dsh-ig-pill-option-name{font-size:12.5px;font-weight:500;color:var(--dsw-alias-label-primary,#111827);line-height:1.2}\n.dsh-ig-pill-option-sub{font-size:11px;color:var(--dsw-alias-label-tertiary,#6b7280);line-height:1.2;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}\n.dsh-ig-pill-check{flex:none;color:var(--dsw-alias-brand-primary,#4c78ff)}\n.dsh-ig-pill-error{margin-top:4px;padding:6px 8px;border-radius:8px;background:rgba(239,68,68,.08);color:#ef4444;font-size:11.5px;line-height:1.4;word-break:break-all}\n";
 export {};

package/lib/types/client/studio-chat-panel.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Workbench chat panel: the right-side DSH conversation surface.
+ *
+ * A dedicated archived agent session lives on the host side (studio-chat.ts);
+ * this panel pulls its projected event feed through CHAT_ROUTE with adaptive
+ * polling (?since=<seq> increments; faster while a turn is running, slower
+ * when idle, paused while the webview is hidden) and submits user turns with
+ * POST. Tool-generated images are mirrored onto the tldraw canvas through the
+ * landing queue and upserted into the gallery (the recent list refreshes via
+ * its subscription). The panel is intentionally unmount-friendly: re-pulls
+ * from seq 0 on remount, and both landing and gallery writes are deduped by
+ * attachmentId, so tab switches are safe.
+ */
+import { type FC } from 'react';
+/** Workspace scoping mirrored onto gallery records; shape-compatible with StudioWorkspaceProps. */
+export interface ChatWorkspaceScope {
+    workspaceId?: string | undefined;
+    path?: string | undefined;
+}
+export declare const StudioChatPanel: FC<{
+    lang: 'zh' | 'en';
+    workspace?: ChatWorkspaceScope | null | undefined;
+}>;

package/lib/types/client/studio-view.d.ts

@@ -15,6 +15,10 @@ export interface StudioWorkspaceProps {
 }
 export declare const StudioView: FC<{
     locale?: LocaleService | undefined;
+    /** Host credential-change notifier; re-reads provider sign-in state silently. */
+    credentialEvents?: {
+        listen(callback: () => void): () => void;
+    } | undefined;
     workspace?: StudioWorkspaceProps | null | undefined;
     initialPrompt?: string | undefined;
     /**