@logictan/dsh-imagegen 2.0.0 → 2.0.2

package/lib/index.js

@@ -0,0 +1,3326 @@
+import * as settingsModule from "@deepseek-ai/dsh-settings";
+import { SettingsConflictError } from "@deepseek-ai/dsh-settings";
+import z from "@deepseek-ai/schemastery";
+import "@deepseek-ai/cordis";
+import { randomUUID } from "node:crypto";
+import { defineTool } from "@deepseek-ai/dsh-tools";
+//#region src/settings-compat.ts
+const compatModule = settingsModule;
+/** Strip volatile markers for the pre-0.1.7 settings providers. */
+function plainSettingsSchema(schema) {
+	const clone = schema.toJSON();
+	const seen = /* @__PURE__ */ new WeakSet();
+	const walk = (node) => {
+		if (typeof node !== "object" || node === null || seen.has(node)) return;
+		seen.add(node);
+		const record = node;
+		const meta = record.meta;
+		if (typeof meta === "object" && meta !== null) delete meta.volatile;
+		if (typeof record.dict === "object" && record.dict !== null) for (const child of Object.values(record.dict)) walk(child);
+		walk(record.inner);
+		walk(record.sKey);
+		if (Array.isArray(record.list)) for (const child of record.list) walk(child);
+	};
+	walk(clone);
+	return clone;
+}
+/** The loader entry id of the plugin instance owning `ctx`, when available. */
+function entryNamespaceOf(ctx) {
+	const compat = ctx;
+	const entry = compat.fiber?.entry;
+	const candidates = [
+		entry?.options?.id,
+		entry?.id,
+		compat.loader?.locate?.(compat.fiber)
+	];
+	for (const candidate of candidates) if (typeof candidate === "string" && candidate !== "") return candidate;
+}
+/** Brand namespaces where the installed settings package still exposes it. */
+function settingsNamespaceCompat(value) {
+	return compatModule.settingsNamespace?.(value) ?? value;
+}
+/**
+* Register an optional settings section across the rc.7, alpha.2 and managed
+* forms APIs. The first two expose an installer; 0.1.7 derives forms directly
+* from the plugin's volatile Config and only needs the custom-page policy.
+*/
+function installSettingsSectionCompat(ctx, ns, schema, entry, hooks) {
+	const legacyInstaller = compatModule.installSettingsSection;
+	if (legacyInstaller !== void 0) {
+		legacyInstaller(ctx, ns, plainSettingsSchema(schema), entry, hooks);
+		return;
+	}
+	ctx.inject(["settings"], (sctx) => {
+		const provider = sctx.get("settings");
+		if (provider.installSection !== void 0) {
+			provider.installSection(ctx, ns, plainSettingsSchema(schema), entry, hooks);
+			return;
+		}
+		if (provider.configure === void 0) throw new TypeError("dsh-settings does not expose installSection or configure");
+		sctx.effect(() => {
+			const dispose = provider.configure?.({ auto: false }, ctx.fiber);
+			return typeof dispose === "function" ? dispose : () => {};
+		});
+		const namespace = entryNamespaceOf(ctx);
+		if (namespace !== void 0) {
+			const settingsEvents = sctx;
+			sctx.effect(() => settingsEvents.on("settings/document-updated", (updated) => {
+				if (String(updated) === namespace) hooks.onChange();
+			}));
+		}
+	});
+}
+//#endregion
+//#region src/protocol.ts
+/**
+* Wire contract shared by the host and client halves of dsh-imagegen: the
+* settings namespace, the route paths, and the generate payload/result shapes.
+* Pure types + constants 鈥?safe for the client bundle to inline.
+*/
+/** Settings namespace this plugin owns (host settings seam + bridge). */
+const IMAGEGEN_SETTINGS_NAMESPACE = "imagegen";
+/** Same-origin route family (loopback-only, mirroring the dsh-ssh fence). */
+const SETTINGS_API = {
+	describe: "/api/dsh-imagegen/settings/describe",
+	mutate: "/api/dsh-imagegen/settings/mutate"
+};
+/** Subscription account login and status routes. */
+const SUBSCRIPTION_API = {
+	status: "/api/dsh-imagegen/subscription/status",
+	login: "/api/dsh-imagegen/subscription/login"
+};
+/** Official/subscription-backed image providers. */
+const SUBSCRIPTION_PROVIDERS = [
+	"chatgpt-sub",
+	"grok-sub",
+	"google-sub",
+	"openrouter-sub"
+];
+/** Whether an endpoint URL explicitly names an OpenAI-compatible chat route. */
+function isChatCompletionsUrl(value) {
+	const trimmed = value.trim();
+	if (trimmed === "") return false;
+	try {
+		return /\/chat\/completions\/?$/.test(new URL(trimmed).pathname);
+	} catch {
+		return /\/chat\/completions\/?$/.test(trimmed.split(/[?#]/, 1)[0] ?? "");
+	}
+}
+/** Whether a stored value is one of the accepted protocol preferences. */
+function isChannelProtocolPreference(value) {
+	return value === "auto" || value === "images" || value === "chat-completions";
+}
+/** Resolve a channel preference without changing legacy behavior by default. */
+function resolveChannelProtocol(apiUrl, preference = "auto") {
+	if (preference === "images" || preference === "chat-completions") return preference;
+	return isChatCompletionsUrl(apiUrl) ? "chat-completions" : "images";
+}
+/** Subscription channels with a fixed image model. */
+const DEFAULT_SUBSCRIPTION_MODELS = {
+	"chatgpt-sub": "gpt-image-2.5-flare",
+	"grok-sub": "grok-imagine-image-2.0",
+	"google-sub": "gemini-3-pro-image",
+	"openrouter-sub": "google/gemini-3-pro-image"
+};
+/** The image-generation proxy route. */
+const GENERATE_API = "/api/dsh-imagegen/generate";
+/** Host-mediated OpenAI-compatible prompt enhancement endpoints. */
+const PROMPT_ENHANCE_API = {
+	models: "/api/dsh-imagegen/prompt-enhance/models",
+	enhance: "/api/dsh-imagegen/prompt-enhance"
+};
+/** Host-mediated candidate discovery for the configured image API. */
+const IMAGE_MODEL_API = { models: "/api/dsh-imagegen/image-models" };
+/** Host-served built-in provider catalog (channels the user can instantiate). */
+const PRESETS_API = "/api/dsh-imagegen/presets";
+/** Loopback-only image reader for Agent tool-result previews. */
+const AGENT_IMAGE_API = "/api/dsh-imagegen/agent-image";
+/** Store the current composer image for the direct edit_image command. */
+const CONVERSATION_IMAGE_API = "/api/dsh-imagegen/conversation-image";
+/** Host-resident generation queue endpoints. */
+const TASK_API = {
+	submit: "/api/dsh-imagegen/tasks/submit",
+	list: "/api/dsh-imagegen/tasks/list",
+	get: "/api/dsh-imagegen/tasks/get",
+	cancel: "/api/dsh-imagegen/tasks/cancel",
+	retry: "/api/dsh-imagegen/tasks/retry"
+};
+//#endregion
+//#region src/model-catalog.ts
+const ENTRIES = {
+	"gpt-image": {
+		label: "gpt-image",
+		labelZh: "GPT 图像",
+		known: true,
+		supportsEdit: true,
+		supportsAspectRatio: false,
+		qualityTiers: [
+			"1K",
+			"2K",
+			"4K"
+		]
+	},
+	"dall-e": {
+		label: "DALL·E",
+		labelZh: "DALL·E",
+		known: true,
+		supportsEdit: true,
+		supportsAspectRatio: false,
+		qualityTiers: ["auto"]
+	},
+	grok: {
+		label: "grok",
+		labelZh: "Grok",
+		known: true,
+		supportsEdit: true,
+		supportsAspectRatio: true,
+		qualityTiers: ["1K", "2K"]
+	},
+	nanobanana: {
+		label: "nanobanana",
+		labelZh: "Nano Banana",
+		known: true,
+		supportsEdit: true,
+		supportsAspectRatio: true,
+		qualityTiers: [
+			"1K",
+			"2K",
+			"4K"
+		]
+	},
+	seedream: {
+		label: "seedream",
+		labelZh: "Seedream",
+		known: true,
+		supportsEdit: true,
+		supportsAspectRatio: true,
+		qualityTiers: ["1K", "2K"]
+	},
+	zhipu: {
+		label: "GLM-Image",
+		labelZh: "智谱图像",
+		known: true,
+		supportsEdit: false,
+		supportsAspectRatio: false,
+		qualityTiers: ["HD"]
+	},
+	qwen: {
+		label: "qwen-image",
+		labelZh: "千问图像",
+		known: true,
+		supportsEdit: true,
+		supportsAspectRatio: true,
+		qualityTiers: ["auto"]
+	},
+	minimax: {
+		label: "MiniMax",
+		labelZh: "MiniMax 图像",
+		known: true,
+		supportsEdit: true,
+		supportsAspectRatio: true,
+		qualityTiers: ["auto"]
+	}
+};
+/** Documented upstream prompt hard limits (UTF-16 code units). The engine
+*  fast-fails on these before any network call and the panel counter shows
+*  them live; families absent here have no documented limit. */
+const PROMPT_CHAR_LIMITS = { minimax: 1500 };
+/** The documented prompt character limit for a model id, or null when the
+*  family has no known limit. Single source of truth for engine enforcement
+*  and the panel's live counter. */
+function promptCharLimit(model) {
+	const { family } = describeModel(model);
+	return (family !== "unknown" ? PROMPT_CHAR_LIMITS[family] : void 0) ?? null;
+}
+/** Official Gemini image ids served by Nano Banana gateways. */
+const NANOBANANA_GEMINI_IDS = /* @__PURE__ */ new Set([
+	"gemini-3-pro-image",
+	"gemini-3-pro-image-preview",
+	"gemini-3.1-flash-image",
+	"gemini-3.1-flash-image-preview",
+	"gemini-3.1-flash-lite-image",
+	"gemini-2.5-flash-image"
+]);
+/** Classify one upstream model id into its request-shaping family. */
+function describeModel(model) {
+	const id = model.trim();
+	if (/^gpt-image/i.test(id)) return {
+		family: "gpt-image",
+		...ENTRIES["gpt-image"]
+	};
+	if (/^dall-e/i.test(id)) return {
+		family: "dall-e",
+		...ENTRIES["dall-e"]
+	};
+	if (/^grok-imagine(?:-|$)/.test(id)) return {
+		family: "grok",
+		...ENTRIES.grok
+	};
+	if (/^nanobanana/i.test(id) || NANOBANANA_GEMINI_IDS.has(id)) return {
+		family: "nanobanana",
+		...ENTRIES.nanobanana
+	};
+	if (/^(?:doubao-)?seedream/i.test(id)) return {
+		family: "seedream",
+		...ENTRIES.seedream
+	};
+	if (/^(?:glm-image|cogview(?:-|$))/i.test(id)) return {
+		family: "zhipu",
+		...ENTRIES.zhipu
+	};
+	if (/^qwen-image(?:[-_.]|$)/i.test(id)) return {
+		family: "qwen",
+		...ENTRIES.qwen
+	};
+	if (/^(?:minimax[-_/])?image-\d+/i.test(id)) return {
+		family: "minimax",
+		...ENTRIES.minimax
+	};
+	return {
+		family: "unknown",
+		label: "unknown",
+		labelZh: "未知协议",
+		known: false,
+		supportsEdit: true,
+		supportsAspectRatio: false,
+		qualityTiers: []
+	};
+}
+/** Conservative fallback for providers whose /models response only has ids.
+*  Metadata-aware filtering lives in prompt-enhancer.ts; this catches common
+*  image model naming conventions without treating every unknown model as an
+*  image model. */
+function isLikelyImageModelId(model) {
+	return /(?:^|[-_.])(?:image|img|diffusion|flux|cogview|imagen|seedream|nanobanana|grok-imagine|dall-e|stable-diffusion|sdxl|pixart|kolors|ideogram|midjourney|recraft|hunyuan|jimeng|wanx|hidream|playground)(?:$|[-_.])/i.test(model.trim());
+}
+/** The family a model id routes its request through. */
+function modelFamily(model) {
+	return describeModel(model).family;
+}
+//#endregion
+//#region src/prompt-enhancer.ts
+/** OpenAI-compatible chat helpers used by the optional prompt-enhancement UI. */
+function endpoint(base, suffix) {
+	return `${base.replace(/\/+$/, "")}${suffix}`;
+}
+function headers(apiKey) {
+	return {
+		"content-type": "application/json",
+		...apiKey.trim() === "" ? {} : { authorization: `Bearer ${apiKey.trim()}` }
+	};
+}
+async function responseJson(response) {
+	const body = await response.json().catch(() => void 0);
+	if (!response.ok || body === void 0 || body === null || typeof body !== "object") {
+		const message = body !== null && typeof body === "object" && typeof body.error?.message === "string" ? body.error.message : `HTTP ${response.status}`;
+		throw new Error(message);
+	}
+	return body;
+}
+async function listModelRecords(config) {
+	if (config.apiUrl.trim() === "") throw new Error("API URL is required");
+	const base = config.apiUrl.trim().replace(/\/+$/, "");
+	let modelsUrl = endpoint(base, "/models");
+	if (resolveChannelProtocol(base, config.protocol) === "chat-completions" && isChatCompletionsUrl(base)) {
+		const url = new URL(base);
+		url.pathname = `${url.pathname.replace(/\/chat\/completions\/?$/, "")}/models`;
+		url.search = "";
+		url.hash = "";
+		modelsUrl = url.toString();
+	}
+	const body = await responseJson(await fetch(modelsUrl, { headers: headers(config.apiKey) }));
+	return (Array.isArray(body.data) ? body.data : []).flatMap((item) => {
+		if (item === null || typeof item !== "object" || typeof item.id !== "string") return [];
+		const id = item.id.trim();
+		return id === "" ? [] : [{
+			...item,
+			id
+		}];
+	});
+}
+function textOf(value) {
+	if (typeof value === "string") return [value];
+	if (!Array.isArray(value)) return [];
+	return value.filter((item) => typeof item === "string");
+}
+function hasImageGenerationCapability(record) {
+	const capability = record.capabilities;
+	if (capability !== null && typeof capability === "object") {
+		const values = capability;
+		for (const key of [
+			"image_generation",
+			"imageGeneration",
+			"text_to_image",
+			"textToImage",
+			"image_gen"
+		]) if (typeof values[key] === "boolean") return values[key];
+		const serialized = JSON.stringify(values).toLowerCase();
+		if (/image[ _-]?generation|text[ _-]?to[ _-]?image/.test(serialized)) return true;
+	}
+	const taskText = [
+		...textOf(record.task),
+		...textOf(record.task_type),
+		...textOf(record.taskType),
+		...textOf(record.type),
+		...textOf(record.model_type),
+		...textOf(record.modelType),
+		...textOf(record.tasks),
+		...textOf(record.description)
+	].join(" ").toLowerCase();
+	if (/image[ _-]?generation|text[ _-]?to[ _-]?image|image[ _-]?gen/.test(taskText)) return true;
+	if (/^image(?:[ _-]?generation)?$/.test(taskText.trim())) return true;
+	if (/embedding|rerank|moderation|transcri|speech|audio|video|chat[ _-]?completion/.test(taskText)) return false;
+	for (const key of [
+		"output_modalities",
+		"outputModalities",
+		"supported_output_modalities"
+	]) {
+		const modalities = textOf(record[key]).map((value) => value.toLowerCase());
+		if (modalities.length > 0) return modalities.includes("image");
+	}
+}
+function isImageModelRecord(record) {
+	return hasImageGenerationCapability(record) ?? isLikelyImageModelId(record.id);
+}
+/** List candidates exposed by an OpenAI-compatible endpoint. */
+async function listOpenAIModels(config) {
+	return [...new Set((await listModelRecords(config)).map((record) => record.id))].sort((a, b) => a.localeCompare(b));
+}
+/** List only models that advertise or conventionally represent image generation. */
+async function listImageModels(config) {
+	return [...new Set((await listModelRecords(config)).filter(isImageModelRecord).map((record) => record.id))].sort((a, b) => a.localeCompare(b));
+}
+/** List chat models exposed by an OpenAI-compatible endpoint. */
+async function listPromptModels(config) {
+	return listOpenAIModels(config);
+}
+/** Remove reasoning-model artifacts from a chat model's visible content:
+*  complete `<think>…</think>` blocks first, then anything from a dangling
+*  unclosed `<think>` to the end of the text. Reasoning models served through
+*  OpenAI-compatible endpoints (MiniMax M3, DeepSeek R1, Qwen QVQ, …) inline
+*  these blocks in `message.content`; leaking them into the prompt box both
+*  pollutes the prompt and can push it past image models' length limits. */
+function stripReasoning(text) {
+	const withoutClosed = text.replace(/<think>[\s\S]*?<\/think>/gi, "");
+	const dangling = /<think>/i.exec(withoutClosed);
+	return (dangling === null ? withoutClosed : withoutClosed.slice(0, dangling.index)).trim();
+}
+/**
+* Run one chat completion and return the cleaned visible answer.
+*
+* Shared by prompt enhancement, the canvas light-tier skill runner and the
+* layer analyzer: it owns the endpoint, auth, error shaping (an upstream
+* `error.message` is surfaced verbatim) and the reasoning-strip step, so every
+* caller sees the same behaviour.
+* @param config - endpoint, secret and model.
+* @param options - prompt parts plus optional sampling controls.
+* @returns the model's visible answer, with reasoning artifacts removed.
+*/
+async function chatComplete(config, options) {
+	if (config.apiUrl.trim() === "" || config.model.trim() === "") throw new Error("chat model is not configured (left sidebar > Image settings > Prompt enhancement)");
+	const body = await responseJson(await fetch(endpoint(config.apiUrl, "/chat/completions"), {
+		method: "POST",
+		headers: headers(config.apiKey),
+		body: JSON.stringify({
+			model: config.model.trim(),
+			temperature: options.temperature ?? .4,
+			...options.maxTokens === void 0 ? {} : { max_tokens: options.maxTokens },
+			messages: [{
+				role: "system",
+				content: options.system
+			}, {
+				role: "user",
+				content: typeof options.content === "string" ? options.content : options.content
+			}]
+		}),
+		...options.signal === void 0 ? {} : { signal: options.signal }
+	}));
+	const choices = Array.isArray(body.choices) ? body.choices : [];
+	const content = choices[0] !== null && typeof choices[0] === "object" ? choices[0].message?.content : void 0;
+	if (typeof content !== "string" || content.trim() === "") throw new Error("chat model returned an empty answer");
+	const answer = stripReasoning(content);
+	if (answer === "") throw new Error("chat model returned only reasoning content (empty <think> payload)");
+	return answer;
+}
+/** Expand a concise image request into a production-ready image prompt. */
+async function enhancePrompt(config, prompt) {
+	return chatComplete(config, {
+		temperature: .7,
+		system: "You are an expert image-prompt editor. Expand the user request into one vivid, specific image-generation prompt. Preserve intent and language. Add only useful visual detail: subject, composition, lighting, materials, color, camera/style and quality. Return only the finished prompt, with no preface or markdown.",
+		content: prompt
+	});
+}
+//#endregion
+//#region src/image-models.ts
+/**
+* Image-model configuration shared by the host, panel, and Agent tools.
+* `/models` exposes candidates only: the configured list is the explicit
+* allow-list because OpenAI-compatible gateways rarely advertise modalities.
+*/
+const DEFAULT_IMAGE_MODELS = [
+	"gpt-image-2.5",
+	"gpt-image-2",
+	"grok-imagine-image",
+	"nanobanana2",
+	"nanobanana2-lite",
+	"nanobanana-pro",
+	"seedream-5.0-pro",
+	"glm-image"
+];
+/** Normalize user-entered model identifiers and retain a usable legacy default. */
+function normalizeImageModels(value) {
+	const candidates = Array.isArray(value) ? value : [];
+	const unique = /* @__PURE__ */ new Set();
+	for (const candidate of candidates) {
+		if (typeof candidate !== "string") continue;
+		const model = candidate.trim();
+		if (model !== "") unique.add(model);
+	}
+	return unique.size > 0 ? [...unique] : [...DEFAULT_IMAGE_MODELS];
+}
+//#endregion
+//#region src/image-format.ts
+function detectImageMime(data) {
+	const startsWith = (...bytes) => bytes.every((value, index) => data[index] === value);
+	if (startsWith(137, 80, 78, 71, 13, 10, 26, 10)) return "image/png";
+	if (startsWith(255, 216, 255)) return "image/jpeg";
+	if (startsWith(71, 73, 70, 56, 55, 97) || startsWith(71, 73, 70, 56, 57, 97)) return "image/gif";
+	if (startsWith(82, 73, 70, 70) && data[8] === 87 && data[9] === 69 && data[10] === 66 && data[11] === 80) return "image/webp";
+}
+//#endregion
+//#region src/engine.ts
+/**
+* Upstream proxy engine: forwards a generate request to the configured
+* OpenAI-compatible image endpoint (/images/generations for text-to-image,
+* /images/edits for image-to-image) and normalizes the response to base64
+* images so the browser never fetches the upstream itself.
+*
+* Framework-free (no cordis imports) so the route layer and tests can drive
+* it directly.
+*/
+/** A generation failure with a user-presentable message. */
+var ImageGenError = class extends Error {
+	/** Stable wire code. */
+	code;
+	constructor(message, code = "generate-failed") {
+		super(message);
+		this.name = "ImageGenError";
+		this.code = code;
+	}
+};
+/** Total budget for the upstream generation call (image models are slow). */
+const UPSTREAM_TIMEOUT_MS = 24e4;
+/** Budget for downloading one result image URL. */
+const IMAGE_FETCH_TIMEOUT_MS = 6e4;
+/** Cap on the reference image payload (edit mode), in bytes. */
+const MAX_EDIT_IMAGE_BYTES = 10 * 1024 * 1024;
+/** Sizes dall-e-3 accepts; anything else falls back to its square default. */
+const DALLE3_SIZES = /* @__PURE__ */ new Set([
+	"1024x1024",
+	"1792x1024",
+	"1024x1792"
+]);
+/** The wire model id for a request: `upstream` (host-filled alias mapping)
+*  wins, then the alias, then the family default. */
+function wireModel(request) {
+	const upstream = request.upstream?.trim();
+	if (upstream !== void 0 && upstream !== "") return upstream;
+	const alias = request.model.trim();
+	return alias === "" ? "gpt-image-2" : alias;
+}
+/** Whether the model is an xAI Grok Imagine model (grok-imagine-image,
+*  grok-imagine-image-2.0, …). Grok Imagine speaks JSON on both endpoints
+*  and exposes its own aspect-ratio / response-format knobs instead of the
+*  OpenAI size/quality/detail passthrough. */
+function isGrokImagine(model) {
+	return modelFamily(model) === "grok";
+}
+/** Whether the model belongs to the Google Nano Banana family (nanobanana2 /
+*  nanobanana2-lite / nanobanana-pro, plus the official Gemini image IDs the
+*  gateways expose). OpenAI-compatible gateways serve these with their own
+*  aspect_ratio / image_size vocabulary instead of the OpenAI size/quality
+*  passthrough. */
+function isNanoBanana(model) {
+	return modelFamily(model) === "nanobanana";
+}
+/** Whether the model belongs to the ByteDance Seedream family (seedream-5.0-pro,
+*  seedream-5.0, seedream-4.x, doubao-seedream-…). OpenAI-compatible gateways
+*  serve Seedream through a unified generate-and-edit architecture:
+*  generation AND editing both go to /images/generations and reference images
+*  are a JSON URL / data-URL array. */
+function isSeedream(model) {
+	return modelFamily(model) === "seedream";
+}
+/** Whether the model uses the official Zhipu image-generation contract. */
+function isZhipuImage(model) {
+	return modelFamily(model) === "zhipu";
+}
+/** Whether the model is Alibaba Qwen-Image, which speaks the DashScope native
+*  multimodal-generation contract (NOT OpenAI-compatible): a chat-style
+*  messages body, `宽*高` pixel sizes, and image URLs in the reply content. */
+function isQwenImage(model) {
+	return modelFamily(model) === "qwen";
+}
+/** Whether the model is MiniMax image-01, which speaks MiniMax's native
+*  `/image_generation` contract (NOT OpenAI-compatible): `aspect_ratio`,
+*  `subject_reference` for image-to-image, `data.image_base64[]` results, and
+*  errors reported as HTTP 200 + non-zero `base_resp.status_code`. */
+function isMiniMaxImage(model) {
+	return modelFamily(model) === "minimax";
+}
+/** Aspect ratios MiniMax image-01 documents (the panel vocabulary is a superset). */
+const MINIMAX_RATIOS = /* @__PURE__ */ new Set([
+	"1:1",
+	"16:9",
+	"4:3",
+	"3:2",
+	"2:3",
+	"3:4",
+	"9:16",
+	"21:9"
+]);
+/** MiniMax caps one request at 9 images. */
+const MINIMAX_MAX_N = 9;
+/** MiniMax image-01 rejects prompts of 1500+ characters; the exact number
+*  lives in model-catalog.ts so the panel counter and this guard agree. */
+function isGlmImage(model) {
+	return /^glm-image(?:-|$)/i.test(model.trim());
+}
+/** Whether this is the official Volcengine Ark model naming convention. */
+function isVolcSeedream(model) {
+	return /^doubao-seedream(?:-|$)/i.test(model.trim());
+}
+/** Volcengine uses `size` for the output tier, not the panel's aspect ratio. */
+function seedreamSize(quality) {
+	if (quality === "1k") return "1K";
+	return "2K";
+}
+/** The panel's aspect ratios mapped to Qwen-Image's `宽*高` pixel sizes.
+*  The classic series (qwen-image / -plus / -max) documents this fixed list;
+*  2.0 / 3.0-series models accept any size within their pixel budget and
+*  recommend the larger set. */
+const QWEN_SIZE_CLASSIC = {
+	"16:9": "1664*928",
+	"21:9": "1664*928",
+	"4:3": "1472*1104",
+	"3:2": "1472*1104",
+	"1:1": "1328*1328",
+	"3:4": "1104*1472",
+	"2:3": "1104*1472",
+	"9:16": "928*1664"
+};
+const QWEN_SIZE_HD = {
+	"16:9": "2688*1536",
+	"21:9": "2688*1536",
+	"4:3": "2368*1728",
+	"3:2": "2368*1728",
+	"1:1": "2048*2048",
+	"3:4": "1728*2368",
+	"2:3": "1728*2368",
+	"9:16": "1536*2688"
+};
+/** Versioned ids (qwen-image-2.0 / -3.0-pro / …) take the large size set. */
+function isVersionedQwenImage(model) {
+	return /^qwen-image-\d+\.\d/i.test(model.trim());
+}
+function qwenSize(model, ratio) {
+	if (ratio === "" || ratio === "auto") return void 0;
+	return (isVersionedQwenImage(model) ? QWEN_SIZE_HD : QWEN_SIZE_CLASSIC)[ratio];
+}
+/** The panel's aspect ratios mapped to the closest OpenAI pixel size
+*  (gpt-image-2 / generic OpenAI-compatible endpoints). */
+const OPENAI_SIZE_BY_RATIO = {
+	"1:1": "1024x1024",
+	"3:4": "1024x1536",
+	"4:3": "1536x1024",
+	"9:16": "1024x1792",
+	"2:3": "1024x1536",
+	"3:2": "1536x1024",
+	"16:9": "1792x1024",
+	"21:9": "1792x1024"
+};
+/** Panel ratios that need renaming for a model's vocabulary. Grok documents
+*  20:9 as its ultra-wide ratio, so the panel's 21:9 label is sent as 20:9. */
+const GROK_ASPECT_ALIASES = { "21:9": "20:9" };
+/**
+* One request-scoped timeout that is cleared as soon as its fetch settles.
+* AbortSignal.timeout() cannot be disposed early; using it inside a long-lived
+* task queue leaves an otherwise idle Node process holding every timeout.
+*/
+function requestSignal(source, timeoutMs) {
+	const controller = new AbortController();
+	const abortFromSource = () => {
+		controller.abort(source?.reason);
+	};
+	if (source?.aborted === true) abortFromSource();
+	else source?.addEventListener("abort", abortFromSource, { once: true });
+	const timeout = setTimeout(() => {
+		controller.abort(new DOMException("The operation timed out.", "TimeoutError"));
+	}, timeoutMs);
+	timeout.unref();
+	return {
+		signal: controller.signal,
+		dispose: () => {
+			clearTimeout(timeout);
+			source?.removeEventListener("abort", abortFromSource);
+		}
+	};
+}
+/** Whether an error was produced by a requestSignal budget timeout. These can
+* surface from the fetch call itself or from reading the response body, so the
+* budget must stay armed until the body has been consumed. */
+function isBudgetTimeout(error) {
+	return (error instanceof DOMException || error instanceof Error) && error.name === "TimeoutError";
+}
+/** Content-type extension hints for URL-fetched images. */ function mimeOfExtension(path) {
+	const match = /\.([a-z0-9]+)$/i.exec(path);
+	if (match === null) return void 0;
+	switch (match[1].toLowerCase()) {
+		case "png": return "image/png";
+		case "jpg":
+		case "jpeg": return "image/jpeg";
+		case "webp": return "image/webp";
+		case "gif": return "image/gif";
+		default: return;
+	}
+}
+/** Parse `data:<mime>;base64,<payload>` into its parts; undefined when malformed. */
+function parseDataUrl(dataUrl) {
+	const match = /^data:([^;,]+)?(;base64)?,(.*)$/s.exec(dataUrl.trim());
+	if (match === null || match[3] === void 0) return void 0;
+	if (match[2] === void 0) return;
+	return {
+		mime: match[1] ?? "application/octet-stream",
+		base64: match[3]
+	};
+}
+/** Strip a data: prefix from an upstream b64 payload if a gateway added one. */
+function bareBase64(value) {
+	const parsed = parseDataUrl(value);
+	return parsed !== void 0 && parsed.base64 !== void 0 ? parsed.base64 : value;
+}
+/** Whether a result URL carries cloud-storage signing credentials. */
+function isPresignedUrl(value) {
+	let url;
+	try {
+		url = new URL(value);
+	} catch {
+		return false;
+	}
+	const params = new Set(Array.from(url.searchParams.keys(), (key) => key.toLowerCase()));
+	if (params.has("x-goog-signature") || params.has("x-goog-credential")) return true;
+	if (params.has("x-amz-signature") || params.has("x-amz-credential")) return true;
+	return params.has("signature") && (params.has("expires") || params.has("googleaccessid") || params.has("awsaccesskeyid"));
+}
+/** Resolve the request URL for a channel: base URL + path, or the exact URL. */
+function endpointUrl(upstream, baseUrl, path) {
+	return upstream.apiUrlFull === true ? baseUrl : `${baseUrl}${path}`;
+}
+/**
+* Whether a result URL lives on the same origin as the configured API base.
+* The upstream Bearer key is only ever forwarded to this origin: a provider
+* (or a compromised relay) that hands back an image URL on a foreign host
+* must not be able to harvest the key through that download.
+*/
+function isSameOriginAsApi(value, apiUrl) {
+	try {
+		return new URL(value).origin === new URL(apiUrl).origin;
+	} catch {
+		return false;
+	}
+}
+/** Clamp the requested image count into the API-accepted range. */
+function clampCount(n) {
+	if (!Number.isFinite(n)) return 1;
+	return Math.min(4, Math.max(1, Math.round(n)));
+}
+/** Pick the effective per-model request parameters. Never includes `n`: the
+*  batch parameter is rejected by Responses-API-based gateways (tools[0].n),
+*  so the count is satisfied by parallel single-image requests instead. */
+function effectiveParams(request) {
+	const model = wireModel(request);
+	if (model === "dall-e-3") {
+		const pixel = OPENAI_SIZE_BY_RATIO[request.size];
+		return {
+			model,
+			size: pixel !== void 0 && DALLE3_SIZES.has(pixel) ? pixel : "1024x1024"
+		};
+	}
+	if (isGrokImagine(model)) return {
+		model,
+		...request.size !== "" && request.size !== "auto" ? { aspect_ratio: GROK_ASPECT_ALIASES[request.size] ?? request.size } : {},
+		...request.quality !== "" && request.quality !== "auto" ? { resolution: request.quality === "4k" ? "2k" : request.quality } : {},
+		response_format: "b64_json"
+	};
+	if (isNanoBanana(model)) return {
+		model,
+		...request.size !== "" && request.size !== "auto" ? { aspect_ratio: request.size } : {},
+		...request.quality !== "" && request.quality !== "auto" ? { image_size: request.quality.toUpperCase() } : {},
+		response_format: "b64_json"
+	};
+	if (isSeedream(model)) return {
+		model,
+		size: seedreamSize(request.quality),
+		response_format: isVolcSeedream(model) ? "url" : "b64_json"
+	};
+	if (isZhipuImage(model)) return {
+		model,
+		...request.size !== "" && request.size !== "auto" && OPENAI_SIZE_BY_RATIO[request.size] !== void 0 ? { size: OPENAI_SIZE_BY_RATIO[request.size] } : {},
+		quality: isGlmImage(model) ? "hd" : "standard"
+	};
+	return {
+		model,
+		...request.size !== "" && request.size !== "auto" && OPENAI_SIZE_BY_RATIO[request.size] !== void 0 ? { size: OPENAI_SIZE_BY_RATIO[request.size] } : {},
+		...request.quality === "1k" ? { quality: "low" } : {},
+		...request.quality === "2k" ? { quality: "medium" } : {},
+		...request.quality === "4k" ? { quality: "high" } : {},
+		...request.detail !== "" ? { detail: request.detail } : {}
+	};
+}
+/** How many single-image requests to issue for the requested image count. */
+function effectiveCount(request) {
+	if (wireModel(request) === "dall-e-3") return 1;
+	return clampCount(request.n);
+}
+/** Normalize one upstream data item into a base64 image. */
+async function normalizeItem(item, upstream, signal) {
+	const revisedPrompt = typeof item.revised_prompt === "string" ? item.revised_prompt : void 0;
+	if (typeof item.b64_json === "string" && item.b64_json.trim() !== "") {
+		const b64 = bareBase64(item.b64_json);
+		if (b64.trim() !== "") return {
+			b64,
+			mime: detectImageMime(Buffer.from(b64, "base64")) ?? "image/png",
+			revisedPrompt
+		};
+	}
+	if (typeof item.url !== "string" || item.url === "") throw new ImageGenError("upstream image item has neither b64_json nor url");
+	const url = item.url;
+	if (url.startsWith("data:")) {
+		const parsed = parseDataUrl(url);
+		if (parsed === void 0) throw new ImageGenError("upstream returned a malformed data: url");
+		return {
+			b64: parsed.base64,
+			mime: detectImageMime(Buffer.from(parsed.base64, "base64")) ?? parsed.mime,
+			revisedPrompt
+		};
+	}
+	const budget = requestSignal(signal, IMAGE_FETCH_TIMEOUT_MS);
+	try {
+		let response;
+		try {
+			const forwardKey = upstream.apiKey !== "" && !isPresignedUrl(url) && isSameOriginAsApi(url, upstream.apiUrl);
+			response = await fetch(url, {
+				...forwardKey ? { headers: { authorization: `Bearer ${upstream.apiKey}` } } : {},
+				signal: budget.signal
+			});
+		} catch (error) {
+			throw new ImageGenError(`failed to fetch the generated image url: ${error instanceof Error ? error.message : String(error)}`);
+		}
+		if (!response.ok) throw new ImageGenError(`failed to fetch the generated image url: HTTP ${response.status}`);
+		const buffer = Buffer.from(await response.arrayBuffer());
+		const contentType = response.headers.get("content-type");
+		const mime = detectImageMime(buffer) ?? (contentType !== null && contentType !== "" ? contentType.split(";")[0].trim() : mimeOfExtension(url) ?? "image/png");
+		return {
+			b64: buffer.toString("base64"),
+			mime,
+			revisedPrompt
+		};
+	} finally {
+		budget.dispose();
+	}
+}
+/** Expand a provider image item whose URL may be a string or an array. */
+function imageItemsOf(value) {
+	if (value === null || typeof value !== "object") return [];
+	const item = value;
+	if (Array.isArray(item.url)) return item.url.filter((url) => typeof url === "string" && url !== "").map((url) => ({
+		...item,
+		url
+	}));
+	return [item];
+}
+/** Return the data records from the response shapes shared by sync gateways. */
+function dataRecordsOf(payload) {
+	const data = Array.isArray(payload.data) ? payload.data : payload.data !== null && typeof payload.data === "object" ? [payload.data] : Array.isArray(payload.images) ? payload.images : Array.isArray(payload.output) ? payload.output : void 0;
+	if (data === void 0) return void 0;
+	return data.filter((entry) => entry !== null && typeof entry === "object");
+}
+/** Remove reasoning-model wrappers before treating chat content as a user-visible error. */
+function stripChatReasoning(value) {
+	const withoutClosed = value.replace(/<think>[\s\S]*?<\/think>/gi, "");
+	const dangling = /<think>/i.exec(withoutClosed);
+	return (dangling === null ? withoutClosed : withoutClosed.slice(0, dangling.index)).trim();
+}
+/** Whether a URL returned in chat content is plausibly an image resource. */
+function isLikelyImageUrl(value) {
+	if (/^data:image\/[a-z0-9.+-]+;base64,/i.test(value)) return true;
+	try {
+		const url = new URL(value);
+		if (mimeOfExtension(url.pathname) !== void 0) return true;
+		const signal = `${url.hostname}${url.pathname}${url.search}`.toLowerCase();
+		return /(?:image|img|photo|picture|cdn|blob|cloudinary|googleusercontent|oaidalle|replicate|fal\.media|files\.oai)/.test(signal);
+	} catch {
+		return false;
+	}
+}
+/** Parse a complete or fenced JSON value embedded in chat text. */
+function parseEmbeddedJson(value) {
+	const cleaned = stripChatReasoning(value).replace(/^```(?:json)?/i, "").replace(/```$/i, "").trim();
+	if (cleaned === "") return void 0;
+	const attempts = [cleaned];
+	const objectStart = cleaned.indexOf("{");
+	const objectEnd = cleaned.lastIndexOf("}");
+	const arrayStart = cleaned.indexOf("[");
+	const arrayEnd = cleaned.lastIndexOf("]");
+	if (objectStart >= 0 && objectEnd > objectStart) attempts.push(cleaned.slice(objectStart, objectEnd + 1));
+	if (arrayStart >= 0 && arrayEnd > arrayStart) attempts.push(cleaned.slice(arrayStart, arrayEnd + 1));
+	for (const attempt of attempts) try {
+		const parsed = JSON.parse(attempt);
+		if (parsed !== null && typeof parsed === "object") return parsed;
+	} catch {}
+}
+/** Collect image references from structured Chat Completions content. */
+function collectChatImageItems(value, out, seen, depth = 0) {
+	if (depth > 6 || value === null || value === void 0) return;
+	if (typeof value === "string") {
+		const parsed = parseEmbeddedJson(value);
+		if (parsed !== void 0 && parsed !== value) collectChatImageItems(parsed, out, seen, depth + 1);
+		for (const match of value.matchAll(/!\[[^\]]*\]\((?:<)?(https?:\/\/[^)\s>]+|data:image\/[^)\s>]+)(?:>)?\)/gi)) if (match[1] !== void 0) out.push({ url: match[1] });
+		for (const match of value.matchAll(/<img\b[^>]*\bsrc\s*=\s*["']([^"']+)["'][^>]*>/gi)) if (match[1] !== void 0) out.push({ url: match[1] });
+		const urls = value.match(/(?:https?:\/\/|data:image\/)[^\s"'<>)\]}]+/gi) ?? [];
+		for (const raw of urls) {
+			const url = raw.replace(/[.,;:!?]+$/, "");
+			if (isLikelyImageUrl(url)) out.push({ url });
+		}
+		return;
+	}
+	if (Array.isArray(value)) {
+		for (const item of value) collectChatImageItems(item, out, seen, depth + 1);
+		return;
+	}
+	if (typeof value !== "object") return;
+	const record = value;
+	if (seen.has(record)) return;
+	seen.add(record);
+	if (typeof record.b64_json === "string" && record.b64_json.trim() !== "") out.push({ b64_json: record.b64_json });
+	for (const key of [
+		"url",
+		"image_url",
+		"image",
+		"output_url"
+	]) {
+		const item = record[key];
+		if (typeof item === "string" && item !== "") {
+			if (key !== "url" || isLikelyImageUrl(item)) out.push({ url: item });
+		} else if (item !== null && typeof item === "object") {
+			const nested = item;
+			if (key !== "url" && typeof nested.url === "string" && nested.url !== "") out.push({ url: nested.url });
+			else collectChatImageItems(item, out, seen, depth + 1);
+		}
+	}
+	for (const key of [
+		"images",
+		"content",
+		"message",
+		"data",
+		"output",
+		"result"
+	]) if (key in record) collectChatImageItems(record[key], out, seen, depth + 1);
+}
+/** Extract every image candidate from one Chat Completions response. */
+function chatImageItemsOf(payload) {
+	const out = [];
+	const seenValues = /* @__PURE__ */ new Set();
+	const data = dataRecordsOf(payload);
+	if (data !== void 0) for (const record of data) collectChatImageItems(record, out, seenValues);
+	const choices = Array.isArray(payload.choices) ? payload.choices : [];
+	for (const choice of choices) {
+		if (choice === null || typeof choice !== "object") continue;
+		const message = choice.message;
+		collectChatImageItems(message, out, seenValues);
+		const delta = choice.delta;
+		collectChatImageItems(delta, out, seenValues);
+	}
+	if (out.length === 0) collectChatImageItems(payload.images, out, seenValues);
+	const unique = /* @__PURE__ */ new Map();
+	for (const item of out) {
+		const url = typeof item.url === "string" ? item.url.trim() : "";
+		const b64 = typeof item.b64_json === "string" ? item.b64_json.trim() : "";
+		const key = url !== "" ? `url:${url}` : b64 !== "" ? `b64:${b64.slice(0, 128)}` : "";
+		if (key !== "" && !unique.has(key)) unique.set(key, item);
+	}
+	return [...unique.values()];
+}
+/** User-visible text from a Chat response, used only when no image was found. */
+function chatErrorTextOf(payload) {
+	const first = (Array.isArray(payload.choices) ? payload.choices : [])[0];
+	const content = first !== null && typeof first === "object" ? first.message?.content : void 0;
+	const pieces = [];
+	if (typeof content === "string") pieces.push(stripChatReasoning(content));
+	else if (Array.isArray(content)) {
+		for (const part of content) if (typeof part === "string") pieces.push(stripChatReasoning(part));
+		else if (part !== null && typeof part === "object" && typeof part.text === "string") pieces.push(stripChatReasoning(part.text));
+	}
+	if (pieces.join("\n").trim() !== "") return pieces.join("\n").trim();
+	if (typeof payload.message === "string" && payload.message.trim() !== "") return payload.message.trim();
+	const error = payload.error;
+	if (error !== null && typeof error === "object" && typeof error.message === "string") return error.message.trim();
+}
+const ASYNC_PENDING_STATUSES = /* @__PURE__ */ new Set([
+	"submitted",
+	"pending",
+	"processing",
+	"running",
+	"in_progress",
+	"queued"
+]);
+const ASYNC_COMPLETED_STATUSES = /* @__PURE__ */ new Set([
+	"completed",
+	"succeeded",
+	"success",
+	"done"
+]);
+const ASYNC_FAILED_STATUSES = /* @__PURE__ */ new Set([
+	"failed",
+	"failure",
+	"cancelled",
+	"canceled",
+	"error"
+]);
+const ASYNC_POLL_MAX_MS = 24e4;
+const ASYNC_POLL_REQUEST_TIMEOUT_MS = 3e4;
+/** Read a provider error message from the common nested locations. */
+function asyncErrorMessage(payload, fallback) {
+	if (payload !== null && typeof payload === "object") {
+		const record = payload;
+		const candidates = [record.message, record.error];
+		const data = record.data;
+		const entries = Array.isArray(data) ? data : [data];
+		for (const entry of entries) {
+			if (entry === null || typeof entry !== "object") continue;
+			const item = entry;
+			candidates.push(item.message, item.error);
+			const nested = item.error;
+			if (nested !== null && typeof nested === "object") candidates.push(nested.message);
+		}
+		for (const candidate of candidates) {
+			if (typeof candidate === "string" && candidate.trim() !== "") return candidate;
+			if (candidate !== null && typeof candidate === "object") {
+				const message = candidate.message;
+				if (typeof message === "string" && message.trim() !== "") return message;
+			}
+		}
+	}
+	return fallback;
+}
+/** Wait between async-provider polls, but wake immediately when cancelled. */
+function waitForPoll(ms, signal) {
+	return new Promise((resolve, reject) => {
+		if (signal?.aborted === true) {
+			reject(signal.reason ?? new DOMException("The operation was aborted.", "AbortError"));
+			return;
+		}
+		const onAbort = () => {
+			clearTimeout(timer);
+			signal?.removeEventListener("abort", onAbort);
+			reject(signal?.reason ?? new DOMException("The operation was aborted.", "AbortError"));
+		};
+		const done = () => {
+			signal?.removeEventListener("abort", onAbort);
+			resolve();
+		};
+		const timer = setTimeout(done, ms);
+		timer.unref();
+		signal?.addEventListener("abort", onAbort, { once: true });
+	});
+}
+/**
+* Poll one apib/apimart-style provider task until it yields image records.
+* The total deadline is shared by every poll and the final image downloads;
+* local task cancellation propagates through every request and sleep.
+*/
+async function pollAsyncTask(baseUrl, upstream, taskId, signal) {
+	const deadline = Date.now() + ASYNC_POLL_MAX_MS;
+	let delay = 1e3;
+	while (Date.now() < deadline) {
+		const remaining = deadline - Date.now();
+		const budget = requestSignal(signal, Math.min(ASYNC_POLL_REQUEST_TIMEOUT_MS, remaining));
+		try {
+			let response;
+			try {
+				response = await fetch(`${baseUrl}/tasks/${encodeURIComponent(taskId)}`, {
+					method: "GET",
+					headers: { authorization: `Bearer ${upstream.apiKey.trim()}` },
+					signal: budget.signal
+				});
+			} catch (error) {
+				if (signal?.aborted === true) throw new ImageGenError("任务已取消", "cancelled");
+				if (isBudgetTimeout(error)) throw new ImageGenError("上游异步任务轮询超时", "upstream-timeout");
+				throw new ImageGenError(`无法轮询上游异步任务：${error instanceof Error ? error.message : String(error)}`, "upstream-unreachable");
+			}
+			let payload;
+			try {
+				payload = await response.json();
+			} catch (error) {
+				if (isBudgetTimeout(error)) throw new ImageGenError("上游异步任务轮询超时", "upstream-timeout");
+				throw new ImageGenError(`上游任务接口返回了非 JSON 响应（HTTP ${response.status}）`, "upstream-invalid");
+			}
+			if (!response.ok || payload === null || typeof payload !== "object") throw new ImageGenError(asyncErrorMessage(payload, `上游任务轮询失败（HTTP ${response.status}）`), "upstream-rejected");
+			const record = payload;
+			const data = record.data;
+			const statusRecord = Array.isArray(data) ? data[0] : data !== null && typeof data === "object" ? data : record;
+			const statusValue = statusRecord !== null && typeof statusRecord === "object" ? statusRecord.status : void 0;
+			const status = typeof statusValue === "string" ? statusValue.toLowerCase() : "";
+			if (ASYNC_FAILED_STATUSES.has(status)) throw new ImageGenError(asyncErrorMessage(payload, `上游异步任务失败（${status || "unknown"}）`), "upstream-rejected");
+			const nested = statusRecord !== null && typeof statusRecord === "object" ? statusRecord : record;
+			const result = nested.result ?? (nested.output !== null && typeof nested.output === "object" ? nested.output.result : void 0) ?? record.result;
+			const images = (result !== null && typeof result === "object" ? result : void 0)?.images ?? nested.images ?? record.images;
+			if (ASYNC_COMPLETED_STATUSES.has(status) || images !== void 0) {
+				const items = Array.isArray(images) ? images.flatMap(imageItemsOf) : imageItemsOf(images);
+				if (items.length > 0) return items;
+				if (ASYNC_COMPLETED_STATUSES.has(status)) throw new ImageGenError("上游异步任务完成但没有图片结果", "upstream-empty");
+			}
+			if (status !== "" && !ASYNC_PENDING_STATUSES.has(status) && !ASYNC_COMPLETED_STATUSES.has(status)) throw new ImageGenError(`上游返回了未知异步任务状态：${status}`, "upstream-invalid");
+		} finally {
+			budget.dispose();
+		}
+		await waitForPoll(Math.min(delay, Math.max(1, deadline - Date.now())), signal);
+		delay = Math.min(5e3, delay * 2);
+	}
+	throw new ImageGenError("上游异步任务轮询超时（240 秒）", "upstream-timeout");
+}
+/**
+* Issue one single-image request (never sends `n`). The response is kept as a
+* list so a gateway that happens to return several images per call still works.
+*/
+async function requestOneImage(baseUrl, upstream, request, params, signal) {
+	const headers = { authorization: `Bearer ${upstream.apiKey.trim()}` };
+	let body;
+	if (request.mode === "edit") {
+		if (typeof request.image !== "string" || request.image === "") throw new ImageGenError("图生图需要上传参考图片", "edit-image-missing");
+		const decodeReference = (dataUrl) => {
+			const parsed = parseDataUrl(dataUrl);
+			if (parsed === void 0) throw new ImageGenError("参考图片格式无效", "edit-image-invalid");
+			let bytes;
+			try {
+				bytes = Buffer.from(parsed.base64, "base64");
+			} catch {
+				throw new ImageGenError("参考图片数据无法解码", "edit-image-invalid");
+			}
+			if (bytes.byteLength > MAX_EDIT_IMAGE_BYTES) throw new ImageGenError("参考图片超过 10MB 上限", "edit-image-too-large");
+			return {
+				bytes,
+				mime: parsed.mime,
+				filename: `reference.${extensionOf(parsed.mime)}`
+			};
+		};
+		const primary = decodeReference(request.image);
+		const extras = (request.images ?? []).filter((img) => typeof img === "string" && img !== "").slice(0, 4).map(decodeReference);
+		if (isGrokImagine(params.model)) {
+			headers["content-type"] = "application/json";
+			body = JSON.stringify({
+				model: params.model,
+				prompt: request.prompt,
+				image: {
+					url: request.image,
+					type: "image_url"
+				},
+				...params.aspect_ratio !== void 0 ? { aspect_ratio: params.aspect_ratio } : {},
+				response_format: "b64_json"
+			});
+		} else if (isNanoBanana(params.model)) {
+			const form = new FormData();
+			form.append("image", new Blob([primary.bytes], { type: primary.mime }), primary.filename);
+			form.append("prompt", request.prompt);
+			form.append("model", params.model);
+			if (params.aspect_ratio !== void 0) form.append("aspect_ratio", params.aspect_ratio);
+			if (params.image_size !== void 0) form.append("image_size", params.image_size);
+			body = form;
+		} else if (isSeedream(params.model)) {
+			headers["content-type"] = "application/json";
+			body = JSON.stringify({
+				model: params.model,
+				prompt: request.prompt,
+				image: [request.image, ...(request.images ?? []).filter((img) => typeof img === "string" && img !== "").slice(0, 4)],
+				...params.size !== void 0 ? { size: params.size } : {},
+				...params.resolution !== void 0 ? { resolution: params.resolution } : {},
+				response_format: isVolcSeedream(params.model) ? "url" : "b64_json"
+			});
+		} else {
+			const form = new FormData();
+			if (extras.length > 0) for (const [index, reference] of [primary, ...extras].entries()) form.append("image[]", new Blob([reference.bytes], { type: reference.mime }), `reference-${index}.${extensionOf(reference.mime)}`);
+			else form.append("image", new Blob([primary.bytes], { type: primary.mime }), primary.filename);
+			form.append("prompt", request.prompt);
+			form.append("model", params.model);
+			if (params.size !== void 0) form.append("size", params.size);
+			if (params.quality !== void 0) form.append("quality", params.quality);
+			if (params.detail !== void 0) form.append("detail", params.detail);
+			body = form;
+		}
+	} else {
+		headers["content-type"] = "application/json";
+		body = JSON.stringify({
+			prompt: request.prompt,
+			...params
+		});
+	}
+	const budget = requestSignal(signal, UPSTREAM_TIMEOUT_MS);
+	try {
+		let response;
+		try {
+			const endpoint = request.mode === "edit" && !isSeedream(params.model) ? "/images/edits" : "/images/generations";
+			response = await fetch(endpointUrl(upstream, baseUrl, endpoint), {
+				method: "POST",
+				headers,
+				body,
+				signal: budget.signal
+			});
+		} catch (error) {
+			if (isBudgetTimeout(error)) throw new ImageGenError("上游接口响应超时（240 秒）", "upstream-timeout");
+			if (signal?.aborted === true) throw new ImageGenError("任务已取消", "cancelled");
+			throw new ImageGenError(`无法连接上游接口：${error instanceof Error ? error.message : String(error)}`, "upstream-unreachable");
+		}
+		let payload;
+		try {
+			payload = await response.json();
+		} catch (error) {
+			if (isBudgetTimeout(error)) throw new ImageGenError("上游接口响应超时（240 秒）", "upstream-timeout");
+			if (signal?.aborted === true) throw new ImageGenError("任务已取消", "cancelled");
+			throw new ImageGenError(`上游接口返回了非 JSON 响应（HTTP ${response.status}）`, "upstream-invalid");
+		}
+		if (!response.ok || payload === null || typeof payload !== "object") throw new ImageGenError(upstreamMessage(payload, response.status), "upstream-rejected");
+		const data = dataRecordsOf(payload);
+		if (data === void 0) throw new ImageGenError("上游响应缺少 data 数组", "upstream-invalid");
+		if (data.length === 0) throw new ImageGenError("上游返回了 0 张图片", "upstream-empty");
+		const asyncEntries = data.filter((entry) => typeof entry.task_id === "string" && entry.task_id.trim() !== "");
+		if (asyncEntries.length > 0) {
+			const asyncRecords = (await Promise.all(asyncEntries.map((entry) => pollAsyncTask(baseUrl, upstream, entry.task_id, signal)))).flat();
+			if (asyncRecords.length === 0) throw new ImageGenError("上游异步任务完成但没有图片结果", "upstream-empty");
+			return Promise.all(asyncRecords.flatMap(imageItemsOf).map((item) => normalizeItem(item, upstream, signal)));
+		}
+		return Promise.all(data.flatMap(imageItemsOf).map((item) => normalizeItem(item, upstream, signal)));
+	} finally {
+		budget.dispose();
+	}
+}
+/**
+* Qwen-Image (DashScope native multimodal-generation): one chat-style request
+* carries the prompt (plus the reference image for edit mode) and answers
+* synchronously with image URLs in the reply content. The versioned series
+* batches natively (n ≤ 6; the panel caps at 4), the classic series is
+* single-image per call.
+*/
+async function generateQwenImage(baseUrl, upstream, request, options) {
+	const model = wireModel(request);
+	const content = [];
+	if (request.mode === "edit") {
+		if (typeof request.image !== "string" || request.image === "") throw new ImageGenError("图生图需要上传参考图片", "edit-image-missing");
+		const parsed = parseDataUrl(request.image);
+		if (parsed === void 0) throw new ImageGenError("参考图片格式无效", "edit-image-invalid");
+		if (Buffer.from(parsed.base64, "base64").byteLength > MAX_EDIT_IMAGE_BYTES) throw new ImageGenError("参考图片超过 10MB 上限", "edit-image-too-large");
+		content.push({ image: request.image });
+	}
+	content.push({ text: request.prompt });
+	const count = isVersionedQwenImage(model) ? clampCount(request.n) : 1;
+	const size = qwenSize(model, request.size);
+	const body = {
+		model,
+		input: { messages: [{
+			role: "user",
+			content
+		}] },
+		parameters: {
+			...size !== void 0 ? { size } : {},
+			...count > 1 ? { n: count } : {}
+		}
+	};
+	const budget = requestSignal(options.signal, UPSTREAM_TIMEOUT_MS);
+	try {
+		let response;
+		try {
+			response = await fetch(`${baseUrl}/services/aigc/multimodal-generation/generation`, {
+				method: "POST",
+				headers: {
+					authorization: `Bearer ${upstream.apiKey.trim()}`,
+					"content-type": "application/json"
+				},
+				body: JSON.stringify(body),
+				signal: budget.signal
+			});
+		} catch (error) {
+			if (isBudgetTimeout(error)) throw new ImageGenError("上游接口响应超时（240 秒）", "upstream-timeout");
+			if (options.signal?.aborted === true) throw new ImageGenError("任务已取消", "cancelled");
+			throw new ImageGenError(`无法连接上游接口：${error instanceof Error ? error.message : String(error)}`, "upstream-unreachable");
+		}
+		let payload;
+		try {
+			payload = await response.json();
+		} catch (error) {
+			if (isBudgetTimeout(error)) throw new ImageGenError("上游接口响应超时（240 秒）", "upstream-timeout");
+			if (options.signal?.aborted === true) throw new ImageGenError("任务已取消", "cancelled");
+			throw new ImageGenError(`上游接口返回了非 JSON 响应（HTTP ${response.status}）`, "upstream-invalid");
+		}
+		if (!response.ok || payload === null || typeof payload !== "object") throw new ImageGenError(upstreamMessage(payload, response.status), "upstream-rejected");
+		const output = payload.output;
+		const choices = output !== void 0 && Array.isArray(output.choices) ? output.choices : [];
+		const urls = [];
+		for (const choice of choices) {
+			const message = choice !== null && typeof choice === "object" ? choice.message : void 0;
+			const items = message !== null && typeof message === "object" && Array.isArray(message.content) ? message.content : [];
+			for (const item of items) if (item !== null && typeof item === "object") {
+				const image = item.image;
+				if (typeof image === "string" && image !== "") urls.push(image);
+			}
+		}
+		if (urls.length === 0) throw new ImageGenError("上游响应缺少图片内容", "upstream-empty");
+		return { images: await Promise.all(urls.map(async (url) => {
+			const normalized = await normalizeItem({ url }, upstream);
+			return {
+				b64: normalized.b64,
+				mime: normalized.mime
+			};
+		})) };
+	} finally {
+		budget.dispose();
+	}
+}
+/**
+* MiniMax image-01 (native `/image_generation`): one JSON request that batches
+* up to 9 images and returns them inline as base64. Image-to-image rides the
+* `subject_reference` array (a character reference, data URL accepted). The
+* endpoint answers HTTP 200 even on failure, so `base_resp.status_code` is the
+* real verdict.
+*/
+async function generateMiniMaxImage(baseUrl, upstream, request, options) {
+	const model = wireModel(request);
+	const promptLimit = promptCharLimit(model);
+	if (promptLimit !== null && request.prompt.length >= promptLimit) throw new ImageGenError(`MiniMax image-01 要求提示词少于 ${promptLimit} 字符（当前 ${request.prompt.length}），请精简后重试`, "prompt-too-long");
+	const body = {
+		model,
+		prompt: request.prompt,
+		response_format: "base64"
+	};
+	const ratio = request.size.trim();
+	if (ratio !== "" && ratio !== "auto") {
+		if (!MINIMAX_RATIOS.has(ratio)) throw new ImageGenError(`MiniMax image-01 不支持 ${ratio} 宽高比，可选：${Array.from(MINIMAX_RATIOS).join(" / ")}`, "size-unsupported");
+		body.aspect_ratio = ratio;
+	}
+	const count = Math.min(MINIMAX_MAX_N, clampCount(request.n));
+	if (count > 1) body.n = count;
+	if (request.mode === "edit") {
+		if (typeof request.image !== "string" || request.image === "") throw new ImageGenError("图生图需要上传参考图片", "edit-image-missing");
+		const parsed = parseDataUrl(request.image);
+		if (parsed === void 0) throw new ImageGenError("参考图片格式无效", "edit-image-invalid");
+		if (Buffer.from(parsed.base64, "base64").byteLength > MAX_EDIT_IMAGE_BYTES) throw new ImageGenError("参考图片超过 10MB 上限", "edit-image-too-large");
+		body.subject_reference = [{
+			type: "character",
+			image_file: request.image
+		}];
+	}
+	const budget = requestSignal(options.signal, UPSTREAM_TIMEOUT_MS);
+	try {
+		let response;
+		try {
+			response = await fetch(`${baseUrl}/image_generation`, {
+				method: "POST",
+				headers: {
+					authorization: `Bearer ${upstream.apiKey.trim()}`,
+					"content-type": "application/json"
+				},
+				body: JSON.stringify(body),
+				signal: budget.signal
+			});
+		} catch (error) {
+			if (isBudgetTimeout(error)) throw new ImageGenError("上游接口响应超时（240 秒）", "upstream-timeout");
+			if (options.signal?.aborted === true) throw new ImageGenError("任务已取消", "cancelled");
+			throw new ImageGenError(`无法连接上游接口：${error instanceof Error ? error.message : String(error)}`, "upstream-unreachable");
+		}
+		let payload;
+		try {
+			payload = await response.json();
+		} catch (error) {
+			if (isBudgetTimeout(error)) throw new ImageGenError("上游接口响应超时（240 秒）", "upstream-timeout");
+			if (options.signal?.aborted === true) throw new ImageGenError("任务已取消", "cancelled");
+			throw new ImageGenError(`上游接口返回了非 JSON 响应（HTTP ${response.status}）`, "upstream-invalid");
+		}
+		if (payload === null || typeof payload !== "object") throw new ImageGenError(upstreamMessage(payload, response.status), "upstream-rejected");
+		const record = payload;
+		const baseResp = record.base_resp;
+		if (baseResp !== null && typeof baseResp === "object") {
+			const status = baseResp.status_code;
+			if (typeof status === "number" && status !== 0) {
+				const msg = baseResp.status_msg;
+				throw new ImageGenError(`MiniMax 拒绝请求（${status}）：${typeof msg === "string" && msg !== "" ? msg : "unknown error"}`, status === 1004 || status === 2049 ? "upstream-unauthorized" : "upstream-rejected");
+			}
+		}
+		if (!response.ok) throw new ImageGenError(upstreamMessage(payload, response.status), "upstream-rejected");
+		const data = record.data;
+		const b64s = data !== null && typeof data === "object" && Array.isArray(data.image_base64) ? data.image_base64.filter((item) => typeof item === "string" && item.trim() !== "") : [];
+		const urls = data !== null && typeof data === "object" && Array.isArray(data.image_urls) ? data.image_urls.filter((item) => typeof item === "string" && item !== "") : [];
+		if (b64s.length === 0 && urls.length === 0) throw new ImageGenError("上游响应缺少图片内容", "upstream-empty");
+		const images = b64s.map((raw) => {
+			const b64 = bareBase64(raw);
+			return {
+				b64,
+				mime: detectImageMime(Buffer.from(b64, "base64")) ?? "image/jpeg"
+			};
+		});
+		for (const url of urls) {
+			const normalized = await normalizeItem({ url }, upstream, options.signal);
+			images.push({
+				b64: normalized.b64,
+				mime: normalized.mime
+			});
+		}
+		return { images };
+	} finally {
+		budget.dispose();
+	}
+}
+/** Resolve the exact Chat Completions endpoint for a channel. */
+function chatEndpointUrl(upstream, baseUrl) {
+	if (isChatCompletionsUrl(baseUrl)) return baseUrl;
+	if (upstream.apiUrlFull === true) return baseUrl;
+	return `${baseUrl}/chat/completions`;
+}
+/** One chat-protocol image request; image count is satisfied by parallel calls. */
+async function requestOneChatImage(upstream, baseUrl, request, signal) {
+	const content = request.mode === "edit" ? [{
+		type: "text",
+		text: request.prompt
+	}, ...[request.image, ...request.images ?? []].filter((value) => typeof value === "string" && value !== "").slice(0, 5).map((url) => ({
+		type: "image_url",
+		image_url: { url }
+	}))] : request.prompt;
+	const budget = requestSignal(signal, UPSTREAM_TIMEOUT_MS);
+	try {
+		let response;
+		try {
+			response = await fetch(chatEndpointUrl(upstream, baseUrl), {
+				method: "POST",
+				headers: {
+					authorization: `Bearer ${upstream.apiKey.trim()}`,
+					"content-type": "application/json",
+					accept: "application/json"
+				},
+				body: JSON.stringify({
+					model: wireModel(request),
+					messages: [{
+						role: "user",
+						content
+					}],
+					stream: false
+				}),
+				signal: budget.signal
+			});
+		} catch (error) {
+			if (isBudgetTimeout(error)) throw new ImageGenError("上游接口响应超时（240 秒）", "upstream-timeout");
+			if (signal?.aborted === true) throw new ImageGenError("任务已取消", "cancelled");
+			throw new ImageGenError(`无法连接上游接口：${error instanceof Error ? error.message : String(error)}`, "upstream-unreachable");
+		}
+		let payload;
+		try {
+			payload = await response.json();
+		} catch (error) {
+			if (isBudgetTimeout(error)) throw new ImageGenError("上游接口响应超时（240 秒）", "upstream-timeout");
+			if (signal?.aborted === true) throw new ImageGenError("任务已取消", "cancelled");
+			throw new ImageGenError(`上游接口返回了非 JSON 响应（HTTP ${response.status}）`, "upstream-invalid");
+		}
+		if (!response.ok || payload === null || typeof payload !== "object") throw new ImageGenError(upstreamMessage(payload, response.status), "upstream-rejected");
+		const items = chatImageItemsOf(payload);
+		if (items.length === 0) throw new ImageGenError(chatErrorTextOf(payload)?.slice(0, 1200) || "Chat Completions 响应中没有可用的图片结果", "upstream-empty");
+		return await Promise.all(items.map((item) => normalizeItem(item, upstream, signal)));
+	} finally {
+		budget.dispose();
+	}
+}
+/** Run N parallel Chat Completions image calls and flatten the result. */
+async function generateChatCompletionImages(upstream, baseUrl, request, signal) {
+	const count = effectiveCount(request);
+	return (await Promise.all(Array.from({ length: count }, () => requestOneChatImage(upstream, baseUrl, request, signal)))).flat();
+}
+/**
+* Forward one generate request to the configured endpoint. The requested image
+* count is satisfied with N parallel single-image requests (the `n` batch
+* parameter is never sent, because Responses-API-based gateways reject it as
+* `tools[0].n`), then the results are flattened in order.
+*/
+async function generateImage(upstream, request, options = {}) {
+	const baseUrl = upstream.apiUrl.trim().replace(/\/+$/, "");
+	if (baseUrl === "") throw new ImageGenError("api_url 未配置：请先在「设置 → 生图配置」中填写", "config-missing");
+	if (upstream.apiKey.trim() === "") throw new ImageGenError("api_key 未配置：请先在「设置 → 生图配置」中填写", "config-missing");
+	if (resolveChannelProtocol(baseUrl, upstream.protocol) === "chat-completions") return { images: await generateChatCompletionImages(upstream, baseUrl, request, options.signal) };
+	if (upstream.apiUrlFull !== true) {
+		if (isQwenImage(wireModel(request))) return generateQwenImage(baseUrl, upstream, request, options);
+		if (isMiniMaxImage(wireModel(request))) return generateMiniMaxImage(baseUrl, upstream, request, options);
+		if (request.mode === "edit" && isZhipuImage(wireModel(request))) throw new ImageGenError("智谱 GLM-Image 当前仅支持文生图，请切换到文生图模式或选择支持图生图的模型", "edit-unsupported");
+	}
+	const params = effectiveParams(request);
+	const count = effectiveCount(request);
+	return { images: (await Promise.all(Array.from({ length: count }, () => requestOneImage(baseUrl, upstream, request, params, options.signal)))).flat() };
+}
+/** Human-readable failure message from an upstream error payload. */
+function upstreamMessage(payload, status) {
+	if (payload !== null && typeof payload === "object") {
+		const record = payload;
+		const error = record.error;
+		if (error !== null && typeof error === "object") {
+			const message = error.message;
+			if (typeof message === "string" && message !== "") return message;
+		}
+		if (typeof record.message === "string" && record.message !== "") return record.message;
+		if (typeof record.error === "string" && record.error !== "") return record.error;
+	}
+	return `上游接口拒绝请求（HTTP ${status}）`;
+}
+/** File extension for a MIME type (multipart reference image). */
+function extensionOf(mime) {
+	switch (mime.split(";")[0].trim()) {
+		case "image/jpeg": return "jpg";
+		case "image/webp": return "webp";
+		case "image/gif": return "gif";
+		default: return "png";
+	}
+}
+[
+	"https://www.googleapis.com/auth/cloud-platform",
+	"https://www.googleapis.com/auth/userinfo.email",
+	"https://www.googleapis.com/auth/userinfo.profile",
+	"https://www.googleapis.com/auth/cclog",
+	"https://www.googleapis.com/auth/experimentsandconfigs"
+].join(" ");
+//#endregion
+//#region src/subscription/manager.ts
+/** The vendor each dsh-image-gen subscription provider maps onto. */
+function vendorOf(provider) {
+	if (provider === "chatgpt-sub") return "codex";
+	if (provider === "google-sub") return "antigravity";
+	if (provider === "openrouter-sub") return "openrouter";
+	return "grok";
+}
+//#endregion
+//#region src/task-queue.ts
+/** In-memory, host-resident image generation queue. */
+var GenerationTaskQueue = class {
+	run;
+	concurrency;
+	tasks = [];
+	controllers = /* @__PURE__ */ new Map();
+	listeners = /* @__PURE__ */ new Set();
+	running = 0;
+	constructor(run, concurrency = 1) {
+		this.run = run;
+		this.concurrency = concurrency;
+	}
+	list() {
+		return this.tasks.map((task) => this.snapshot(task));
+	}
+	/**
+	* Bounded poll payload: active tasks plus the newest terminal summaries.
+	* Image data and completed results are intentionally omitted.
+	*/
+	summaries(terminalLimit = 100) {
+		const limit = Math.max(0, Math.floor(terminalLimit));
+		const active = this.tasks.filter((task) => task.status === "queued" || task.status === "running");
+		const terminal = this.tasks.filter((task) => task.status !== "queued" && task.status !== "running").slice(0, limit);
+		const selected = new Set([...active, ...terminal].map((task) => task.id));
+		return this.tasks.filter((task) => selected.has(task.id)).map((task) => this.summary(task));
+	}
+	get(id) {
+		const task = this.tasks.find((item) => item.id === id);
+		return task === void 0 ? void 0 : this.snapshot(task);
+	}
+	/** Observe queue state changes. Listener failures never disrupt generation. */
+	subscribe(listener) {
+		this.listeners.add(listener);
+		return () => {
+			this.listeners.delete(listener);
+		};
+	}
+	submit(request) {
+		const task = {
+			id: randomUUID(),
+			request: { ...request },
+			status: "queued",
+			createdAt: Date.now()
+		};
+		this.tasks.unshift(task);
+		this.publish(task);
+		this.drain();
+		return this.snapshot(task);
+	}
+	cancel(id) {
+		const task = this.tasks.find((item) => item.id === id);
+		if (task === void 0 || task.status === "completed" || task.status === "failed" || task.status === "cancelled") return task;
+		task.status = "cancelled";
+		task.finishedAt = Date.now();
+		this.controllers.get(id)?.abort();
+		this.publish(task);
+		this.drain();
+		return this.snapshot(task);
+	}
+	retry(id) {
+		const previous = this.tasks.find((item) => item.id === id);
+		return previous === void 0 ? void 0 : this.submit(previous.request);
+	}
+	/** Start queued tasks while capacity remains. Plain submissions and
+	* comparison batches alike run in parallel up to the host-wide limit, so one
+	* slow upstream can no longer hold back unrelated generations. */
+	drain() {
+		while (this.running < Math.max(1, this.concurrency)) {
+			const task = this.tasks.find((item) => item.status === "queued");
+			if (task === void 0) return;
+			this.running += 1;
+			this.runTask(task).finally(() => {
+				this.running -= 1;
+				this.drain();
+			});
+		}
+	}
+	async runTask(task) {
+		task.status = "running";
+		task.startedAt = Date.now();
+		this.publish(task);
+		const controller = new AbortController();
+		this.controllers.set(task.id, controller);
+		try {
+			const result = await this.run(task.request, controller.signal);
+			if (this.tasks.find((item) => item.id === task.id)?.status !== "cancelled") {
+				task.status = "completed";
+				task.result = result;
+				task.finishedAt = Date.now();
+				this.publish(task);
+			}
+		} catch (error) {
+			if (this.tasks.find((item) => item.id === task.id)?.status !== "cancelled") {
+				task.status = "failed";
+				task.error = error instanceof Error ? error.message : String(error);
+				task.finishedAt = Date.now();
+				this.publish(task);
+			}
+		} finally {
+			this.controllers.delete(task.id);
+		}
+	}
+	publish(task) {
+		const snapshot = this.snapshot(task);
+		for (const listener of this.listeners) try {
+			listener(snapshot);
+		} catch {}
+	}
+	summary(task) {
+		const request = { ...task.request };
+		delete request.image;
+		delete request.images;
+		return {
+			id: task.id,
+			request,
+			status: task.status,
+			createdAt: task.createdAt,
+			...task.startedAt === void 0 ? {} : { startedAt: task.startedAt },
+			...task.finishedAt === void 0 ? {} : { finishedAt: task.finishedAt },
+			...task.error === void 0 ? {} : { error: task.error },
+			resultAvailable: task.result !== void 0
+		};
+	}
+	snapshot(task) {
+		return {
+			...task,
+			request: { ...task.request },
+			...task.result === void 0 ? {} : { result: task.result }
+		};
+	}
+};
+//#endregion
+//#region src/generation-runtime.ts
+/**
+* Shared host-side generation runtime. Both the browser routes and Agent tools
+* submit to this one queue so cancellation semantics stay identical regardless
+* of where a request originated.
+*
+* Requests carry a channel id (host-filled by the route/tool resolution); the
+* runtime picks that channel's upstream credentials, otherwise the default
+* channel.
+*/
+var ImageGenerationRuntime = class {
+	resolve;
+	subscriptions;
+	queue;
+	constructor(resolve, subscriptions) {
+		this.resolve = resolve;
+		this.subscriptions = subscriptions;
+		this.queue = new GenerationTaskQueue((request, signal) => this.run(request, signal), 4);
+	}
+	async run(request, signal) {
+		const view = this.resolve();
+		const channel = view.channels.find((candidate) => candidate.id === request.channelId) ?? view.channels.find((candidate) => candidate.id === view.defaultChannelId) ?? view.channels[0];
+		if (channel === void 0) throw new ImageGenError("尚未配置任何渠道：请先打开「设置 → 生图配置」添加渠道并填写 API 地址与密钥", "no-channels");
+		return channel.auth === "subscription" && channel.subscription !== void 0 ? { images: await this.generateSubscription(channel.subscription, request, signal) } : await generateImage({
+			apiUrl: channel.apiUrl,
+			apiKey: channel.apiKey,
+			apiUrlFull: channel.apiUrlFull,
+			protocol: channel.protocol
+		}, request, { signal });
+	}
+	/** Generate images through one logged-in subscription account. */
+	async generateSubscription(provider, request, signal) {
+		if (this.subscriptions === void 0) throw new ImageGenError("当前部署未挂载 DSH Credentials，订阅账号不可用", "subscription-unavailable");
+		const references = subscriptionReferences(request);
+		const count = Math.max(1, Math.min(4, Math.trunc(request.n) || 1));
+		return (await Promise.all(Array.from({ length: count }, async () => await this.subscriptions.generate({
+			vendor: vendorOf(provider),
+			prompt: request.prompt,
+			size: request.size,
+			quality: request.quality,
+			...references.length > 0 ? { referenceImages: references } : {},
+			...signal === void 0 ? {} : { signal }
+		})))).flatMap((batch) => batch.flatMap((row) => {
+			const mime = detectImageMime(Buffer.from(row.b64_json, "base64"));
+			if (mime === void 0) throw new ImageGenError("订阅图像返回了无法识别的图片格式", "subscription-invalid-image");
+			return [{
+				b64: row.b64_json,
+				mime,
+				...row.revisedPrompt === void 0 ? {} : { revisedPrompt: row.revisedPrompt }
+			}];
+		}));
+	}
+};
+/** Decode the request's data-URL references into subscription wire images. */
+function subscriptionReferences(request) {
+	return [request.image, ...request.images ?? []].filter((value) => typeof value === "string" && value !== "").slice(0, 5).map((value) => {
+		const match = /^data:(image\/(?:png|jpeg|webp|gif));base64,(.*)$/su.exec(value);
+		if (match === null || match[1] === void 0 || match[2] === void 0) throw new ImageGenError("订阅图生图收到无法解码的参考图片", "subscription-invalid-reference");
+		return {
+			data: Buffer.from(match[2], "base64"),
+			mediaType: match[1]
+		};
+	});
+}
+//#endregion
+//#region src/presets.ts
+/**
+* Built-in provider catalog (presets). A preset is an official or well-known
+* OpenAI-compatible endpoint with its known model list, so the user only fills
+* in the API key. The list ships with the package and is served to the
+* settings card through a host route, so it can later be refreshed online like
+* the template library.
+*
+* Framework-free (pure data), safe for the host routes to serve directly.
+*/
+const IMAGE_PRESETS = [
+	{
+		id: "volc-ark-seedream",
+		name: "字节 · 火山方舟（Seedream）",
+		apiUrl: "https://ark.cn-beijing.volces.com/api/v3",
+		hint: "字节跳动官方 Seedream 文生图/图生图入口",
+		models: [
+			{
+				alias: "seedream-5.0-pro",
+				id: "seedream-5.0-pro"
+			},
+			{
+				alias: "seedream-5.0",
+				id: "seedream-5.0"
+			},
+			{
+				alias: "seedream-4.0",
+				id: "seedream-4.0"
+			}
+		]
+	},
+	{
+		id: "openai-official",
+		name: "OpenAI 官方",
+		apiUrl: "https://api.openai.com/v1",
+		hint: "OpenAI 官方图像生成接口（gpt-image-2.5 支持手绘草图生图）",
+		models: [{
+			alias: "gpt-image-2.5",
+			id: "gpt-image-2.5"
+		}, {
+			alias: "gpt-image-2",
+			id: "gpt-image-2"
+		}]
+	},
+	{
+		id: "zhipu-official",
+		name: "智谱 AI 官方",
+		apiUrl: "https://open.bigmodel.cn/api/paas/v4",
+		hint: "智谱官方 GLM-Image 图像生成接口",
+		models: [{
+			alias: "glm-image",
+			id: "glm-image"
+		}]
+	},
+	{
+		id: "aliyun-dashscope-qwen",
+		name: "阿里云百炼（Qwen-Image）",
+		apiUrl: "https://dashscope.aliyuncs.com/api/v1",
+		hint: "阿里云百炼 DashScope 原生接口：通义千问 Qwen-Image 系列（该渠道不可复用于提示词增强）",
+		models: [
+			{
+				alias: "qwen-image-3.0-pro",
+				id: "qwen-image-3.0-pro"
+			},
+			{
+				alias: "qwen-image-3.0",
+				id: "qwen-image-3.0"
+			},
+			{
+				alias: "qwen-image-2.0-pro",
+				id: "qwen-image-2.0-pro"
+			},
+			{
+				alias: "qwen-image-2.0",
+				id: "qwen-image-2.0"
+			},
+			{
+				alias: "qwen-image-max",
+				id: "qwen-image-max"
+			},
+			{
+				alias: "qwen-image-plus",
+				id: "qwen-image-plus"
+			},
+			{
+				alias: "qwen-image",
+				id: "qwen-image"
+			}
+		]
+	},
+	{
+		id: "minimax-official",
+		name: "MiniMax 官方（国际站）",
+		apiUrl: "https://api.minimax.io/v1",
+		hint: "MiniMax 原生 /image_generation 接口：image-01（国内站请把地址改为 https://api.minimaxi.com/v1；/models 不列出图片模型，请直接使用预填目录）",
+		models: [{
+			alias: "image-01",
+			id: "image-01"
+		}]
+	},
+	{
+		id: "xai-grok",
+		name: "xAI（Grok）",
+		apiUrl: "https://api.x.ai/v1",
+		hint: "xAI 官方接口：Grok Imagine 系列",
+		models: [{
+			alias: "grok-imagine-image",
+			id: "grok-imagine-image"
+		}]
+	},
+	{
+		id: "chatgpt-subscription",
+		name: "ChatGPT 订阅（实验）",
+		apiUrl: "",
+		hint: "浏览器授权登录后使用 gpt-image-2.5-flare；非官方 Codex 图像接口",
+		models: [{
+			alias: DEFAULT_SUBSCRIPTION_MODELS["chatgpt-sub"],
+			id: DEFAULT_SUBSCRIPTION_MODELS["chatgpt-sub"]
+		}],
+		subscription: "chatgpt-sub",
+		experimental: true
+	},
+	{
+		id: "grok-subscription",
+		name: "Grok 订阅",
+		apiUrl: "",
+		hint: "SuperGrok / X Premium 登录后使用 grok-imagine-image-2.0",
+		models: [{
+			alias: DEFAULT_SUBSCRIPTION_MODELS["grok-sub"],
+			id: DEFAULT_SUBSCRIPTION_MODELS["grok-sub"]
+		}],
+		subscription: "grok-sub"
+	},
+	{
+		id: "google-subscription",
+		name: "Google 订阅（实验）",
+		apiUrl: "",
+		hint: "Google 授权登录后使用 gemini-3-pro-image；非官方 Antigravity 接口",
+		models: [{
+			alias: DEFAULT_SUBSCRIPTION_MODELS["google-sub"],
+			id: DEFAULT_SUBSCRIPTION_MODELS["google-sub"]
+		}],
+		subscription: "google-sub",
+		experimental: true
+	},
+	{
+		id: "openrouter-subscription",
+		name: "OpenRouter 账号",
+		apiUrl: "",
+		hint: "OpenRouter 官方 OAuth 登录，使用 google/gemini-3-pro-image",
+		models: [{
+			alias: DEFAULT_SUBSCRIPTION_MODELS["openrouter-sub"],
+			id: DEFAULT_SUBSCRIPTION_MODELS["openrouter-sub"]
+		}],
+		subscription: "openrouter-sub"
+	}
+];
+/** Look up one built-in provider by id. */
+function presetById(id) {
+	return IMAGE_PRESETS.find((preset) => preset.id === id);
+}
+//#endregion
+//#region src/routes.ts
+/** Cap on JSON request bodies (settings ops and generate payloads are small). */
+const MAX_JSON_BODY_BYTES = 24 * 1024 * 1024;
+/** Loopback literal check plus browser same-origin markers (mirrors dsh-ssh). */
+function isLoopbackRequest(request) {
+	const address = request.socket.remoteAddress;
+	if (address !== "127.0.0.1" && address !== "::1" && address !== "::ffff:127.0.0.1") return false;
+	const host = request.headers.host;
+	if (typeof host !== "string") return false;
+	let hostUrl;
+	try {
+		hostUrl = new URL(`http://${host}`);
+	} catch {
+		return false;
+	}
+	if (hostUrl.hostname !== "127.0.0.1" && hostUrl.hostname !== "localhost" && hostUrl.hostname !== "[::1]") return false;
+	if (request.headers["sec-fetch-site"] === "cross-site") return false;
+	const origin = request.headers.origin;
+	if (origin === void 0) return true;
+	try {
+		return new URL(origin).host === hostUrl.host;
+	} catch {
+		return false;
+	}
+}
+/** One JSON response. */
+function writeJson(res, status, body) {
+	const payload = JSON.stringify(body);
+	res.writeHead(status, {
+		"content-type": "application/json; charset=utf-8",
+		"referrer-policy": "no-referrer"
+	});
+	res.end(payload);
+}
+/** Read a JSON request body (undefined when too large or unparseable). */
+async function readJsonBody(req, maxBytes = MAX_JSON_BODY_BYTES) {
+	const chunks = [];
+	let size = 0;
+	for await (const chunk of req) {
+		const buffer = chunk;
+		size += buffer.length;
+		if (size > maxBytes) return void 0;
+		chunks.push(buffer);
+	}
+	try {
+		const parsed = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+		return typeof parsed === "object" && parsed !== null ? parsed : void 0;
+	} catch {
+		return;
+	}
+}
+/** Human-readable text from an unknown thrown value. */
+function messageOf(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+/** Parse the durable image reference carried by an Agent tool-result view. */
+function agentImageRefFrom(rawUrl) {
+	if (rawUrl === void 0) return void 0;
+	let url;
+	try {
+		url = new URL(rawUrl, "http://localhost");
+	} catch {
+		return;
+	}
+	if (url.pathname !== "/api/dsh-imagegen/agent-image") return void 0;
+	const attachmentId = url.searchParams.get("attachment_id") ?? "";
+	const mediaType = url.searchParams.get("media_type") ?? "";
+	const bytes = Number(url.searchParams.get("bytes"));
+	const width = Number(url.searchParams.get("width"));
+	const height = Number(url.searchParams.get("height"));
+	if (attachmentId === "" || !isImageMediaType(mediaType) || !Number.isSafeInteger(bytes) || bytes < 1 || !Number.isSafeInteger(width) || width < 1 || !Number.isSafeInteger(height) || height < 1) return void 0;
+	return {
+		attachmentId,
+		mediaType,
+		bytes,
+		width,
+		height
+	};
+}
+function isImageMediaType(value) {
+	return value === "image/png" || value === "image/jpeg" || value === "image/webp" || value === "image/gif";
+}
+function imageDataUrl$1(value) {
+	const match = /^data:(image\/(?:png|jpeg|webp|gif));base64,(.*)$/su.exec(value.trim());
+	if (match === null || match[1] === void 0 || match[2] === void 0) return void 0;
+	const data = Buffer.from(match[2], "base64");
+	return data.byteLength === 0 ? void 0 : {
+		mediaType: match[1],
+		data
+	};
+}
+/** Project one settings descriptor onto the bridge wire view. */
+function toView(descriptor, namespace = String(descriptor.ns)) {
+	return {
+		ns: namespace,
+		schema: descriptor.schema,
+		value: descriptor.value,
+		...descriptor.base === void 0 ? {} : { base: descriptor.base },
+		...descriptor.user === void 0 ? {} : { user: descriptor.user },
+		...descriptor.secrets === void 0 ? {} : { secrets: descriptor.secrets.map((secret) => ({
+			path: [...secret.path],
+			set: secret.set
+		})) },
+		revision: descriptor.revision
+	};
+}
+/** Map a subscription provider to its manager vendor id. */
+function vendorOfSubscription(provider) {
+	if (provider === "chatgpt-sub") return "codex";
+	if (provider === "google-sub") return "antigravity";
+	if (provider === "openrouter-sub") return "openrouter";
+	return "grok";
+}
+/** Map a seam failure onto the bridge refusal envelope. */
+function failureOf(error) {
+	if (error instanceof SettingsConflictError) return {
+		ok: false,
+		code: "settings-conflict",
+		message: error.message
+	};
+	return {
+		ok: false,
+		code: "settings-rejected",
+		message: error instanceof Error ? error.message : String(error)
+	};
+}
+/** Validate a submitted generation request (the browser's generate payload). */
+function parseGenerateRequest(body) {
+	const prompt = typeof body.prompt === "string" ? body.prompt.trim() : "";
+	if (prompt === "") return void 0;
+	return {
+		mode: body.mode === "edit" ? "edit" : "text",
+		model: typeof body.model === "string" ? body.model : "",
+		prompt,
+		size: typeof body.size === "string" ? body.size : "auto",
+		quality: typeof body.quality === "string" ? body.quality : "auto",
+		n: typeof body.n === "number" ? body.n : 1,
+		detail: typeof body.detail === "string" ? body.detail : "",
+		...typeof body.image === "string" && body.image !== "" ? { image: body.image } : {},
+		...Array.isArray(body.images) ? { images: body.images.filter((item) => typeof item === "string" && item !== "").slice(0, 4) } : {},
+		...typeof body.refName === "string" && body.refName !== "" ? { refName: body.refName } : {},
+		...typeof body.channelId === "string" && body.channelId !== "" ? { channelId: body.channelId } : {}
+	};
+}
+/**
+* Build every /api/dsh-imagegen route.
+* @param deps - settings seam + config resolver.
+* @returns the route registrations.
+*/
+function makeRoutes(deps) {
+	const resolvePrompt = deps.resolvePrompt ?? (() => ({
+		apiUrl: "",
+		apiKey: "",
+		model: ""
+	}));
+	const resolveImageModels = deps.resolveImageModels ?? (() => normalizeImageModels(void 0));
+	const settingsNamespace = IMAGEGEN_SETTINGS_NAMESPACE;
+	/** The current channel view: the channel-aware resolver, or a synthesized
+	*  single default channel from the legacy flat upstream config (tests and
+	*  older hosts). */
+	const channelViewOf = () => {
+		if (deps.resolveChannels !== void 0) return deps.resolveChannels();
+		const upstream = deps.resolve();
+		const models = normalizeImageModels(resolveImageModels()).map((id) => ({
+			alias: id,
+			id
+		}));
+		if (upstream.apiUrl.trim() === "" && models.length === 0) return {
+			channels: [],
+			defaultChannelId: ""
+		};
+		return {
+			channels: [{
+				id: "default",
+				preset: "",
+				name: "默认渠道",
+				apiUrl: upstream.apiUrl,
+				apiUrlFull: false,
+				apiKey: upstream.apiKey,
+				models
+			}],
+			defaultChannelId: "default"
+		};
+	};
+	const runtime = deps.runtime ?? new ImageGenerationRuntime(channelViewOf);
+	/** Resolve an alias (or the channel fallback) into a concrete generation
+	*  request: picks the channel (explicit then default), maps alias → upstream
+	*  id, and fills the channel snapshot kept on history entries. */
+	const resolveChannelRequest = (request) => {
+		const view = channelViewOf();
+		if (view.channels.length === 0) return {
+			ok: false,
+			code: "no-channels",
+			message: "尚未配置任何渠道：请先打开「设置 → 生图配置」添加渠道并填写 API 地址与密钥"
+		};
+		const explicit = view.channels.find((candidate) => candidate.id === request.channelId);
+		const defaults = view.channels.find((candidate) => candidate.id === view.defaultChannelId) ?? view.channels[0];
+		const target = explicit ?? defaults;
+		const asked = request.model.trim();
+		if (asked === "") {
+			const alias = target?.models[0]?.alias ?? "";
+			if (alias === "") return {
+				ok: false,
+				code: "no-models",
+				message: `渠道「${target?.name ?? ""}」尚未配置模型，请先在设置中添加`
+			};
+			const mapping = target.models.find((model) => model.alias === alias);
+			return {
+				ok: true,
+				request: {
+					...request,
+					model: alias,
+					upstream: mapping.id,
+					channelId: target.id,
+					channel: target.name
+				}
+			};
+		}
+		const hosting = view.channels.filter((channel) => channel.models.some((model) => model.alias === asked));
+		if (hosting.length === 0) return {
+			ok: false,
+			code: "image-model-not-configured",
+			message: `模型「${asked}」未在任一渠道配置；可用模型：${[...new Set(view.channels.flatMap((channel) => channel.models.map((model) => model.alias)))].join("、") || "（无）"}`
+		};
+		const picked = target !== void 0 && target.models.some((model) => model.alias === asked) ? target : hosting[0];
+		const mapping = picked.models.find((model) => model.alias === asked);
+		return {
+			ok: true,
+			request: {
+				...request,
+				model: asked,
+				upstream: mapping.id,
+				channelId: picked.id,
+				channel: picked.name
+			}
+		};
+	};
+	const guard = (req, res, method) => {
+		if (!isLoopbackRequest(req)) {
+			writeJson(res, 403, { error: "forbidden: loopback-only" });
+			return false;
+		}
+		if (req.method !== method) {
+			writeJson(res, 405, { error: `method not allowed: ${req.method}` });
+			return false;
+		}
+		return true;
+	};
+	return [
+		...deps.attachments?.saveImage === void 0 || deps.pendingConversationImages === void 0 ? [] : [{
+			kind: "exact",
+			path: CONVERSATION_IMAGE_API,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const body = await readJsonBody(req, MAX_JSON_BODY_BYTES);
+				const sessionId = typeof body?.sessionId === "string" ? body.sessionId.trim() : "";
+				const dataUrl = typeof body?.dataUrl === "string" ? imageDataUrl$1(body.dataUrl) : void 0;
+				if (sessionId === "" || dataUrl === void 0) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "bad-request",
+						message: "sessionId and image data are required"
+					});
+					return;
+				}
+				try {
+					const ref = await deps.attachments.saveImage({
+						data: dataUrl.data,
+						mediaType: dataUrl.mediaType,
+						...typeof body?.name === "string" && body.name.trim() !== "" ? { name: body.name.trim() } : {}
+					});
+					deps.pendingConversationImages.set(sessionId, ref);
+					writeJson(res, 200, { ok: true });
+				} catch (error) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "image-save-failed",
+						message: messageOf(error)
+					});
+				}
+			}
+		}],
+		...deps.attachments === void 0 ? [] : [{
+			kind: "prefix",
+			path: AGENT_IMAGE_API,
+			handler: async (req, res) => {
+				if (!isLoopbackRequest(req)) {
+					writeJson(res, 403, { error: "forbidden: loopback-only" });
+					return;
+				}
+				if (req.method !== "GET") {
+					writeJson(res, 405, { error: `method not allowed: ${req.method}` });
+					return;
+				}
+				const ref = agentImageRefFrom(req.url);
+				if (ref === void 0) {
+					writeJson(res, 400, { error: "invalid image reference" });
+					return;
+				}
+				try {
+					const stored = await deps.attachments.readImage(ref);
+					res.writeHead(200, {
+						"content-type": stored.ref.mediaType,
+						"content-length": stored.data.byteLength,
+						"cache-control": "private, max-age=3600"
+					});
+					res.end(Buffer.from(stored.data));
+				} catch {
+					writeJson(res, 404, { error: "image attachment not found" });
+				}
+			}
+		}],
+		{
+			kind: "exact",
+			path: IMAGE_MODEL_API.models,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const body = await readJsonBody(req);
+				const view = channelViewOf();
+				const stored = view.channels.find((candidate) => candidate.id === (typeof body?.channelId === "string" ? body.channelId : void 0)) ?? view.channels.find((candidate) => candidate.id === view.defaultChannelId) ?? view.channels[0];
+				const protocol = isChannelProtocolPreference(body?.protocol) ? body.protocol : stored?.protocol;
+				const upstream = {
+					apiUrl: typeof body?.apiUrl === "string" && body.apiUrl.trim() !== "" ? body.apiUrl.trim() : stored?.apiUrl ?? "",
+					apiKey: typeof body?.apiKey === "string" && body.apiKey.trim() !== "" ? body.apiKey.trim() : stored?.apiKey ?? "",
+					apiUrlFull: typeof body?.apiUrlFull === "boolean" ? body.apiUrlFull : stored?.apiUrlFull === true,
+					...protocol === void 0 ? {} : { protocol }
+				};
+				try {
+					writeJson(res, 200, {
+						ok: true,
+						models: await listImageModels(upstream)
+					});
+				} catch (error) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "image-models-failed",
+						message: messageOf(error)
+					});
+				}
+			}
+		},
+		{
+			kind: "exact",
+			path: PRESETS_API,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				writeJson(res, 200, {
+					ok: true,
+					presets: IMAGE_PRESETS.map((preset) => ({
+						id: preset.id,
+						name: preset.name,
+						apiUrl: preset.apiUrl,
+						hint: preset.hint,
+						models: preset.models,
+						...preset.subscription === void 0 ? {} : { subscription: preset.subscription },
+						...preset.experimental === void 0 ? {} : { experimental: preset.experimental }
+					}))
+				});
+			}
+		},
+		{
+			kind: "exact",
+			path: PROMPT_ENHANCE_API.models,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				try {
+					writeJson(res, 200, {
+						ok: true,
+						models: await listPromptModels(resolvePrompt())
+					});
+				} catch (error) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "prompt-models-failed",
+						message: messageOf(error)
+					});
+				}
+			}
+		},
+		{
+			kind: "exact",
+			path: PROMPT_ENHANCE_API.enhance,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const body = await readJsonBody(req);
+				const prompt = typeof body?.prompt === "string" ? body.prompt.trim() : "";
+				if (prompt === "") {
+					writeJson(res, 200, {
+						ok: false,
+						code: "bad-request",
+						message: "prompt is required"
+					});
+					return;
+				}
+				try {
+					writeJson(res, 200, {
+						ok: true,
+						prompt: await enhancePrompt(resolvePrompt(), prompt)
+					});
+				} catch (error) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "prompt-enhance-failed",
+						message: messageOf(error)
+					});
+				}
+			}
+		},
+		{
+			kind: "exact",
+			path: SETTINGS_API.describe,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const descriptor = deps.settings.describe({ redactSecrets: true }).find((candidate) => String(candidate.ns) === settingsNamespace);
+				writeJson(res, 200, {
+					ok: true,
+					value: {
+						namespaces: descriptor === void 0 ? [] : [toView(descriptor, IMAGEGEN_SETTINGS_NAMESPACE)],
+						writable: deps.settings.writable !== false
+					}
+				});
+			}
+		},
+		{
+			kind: "exact",
+			path: SETTINGS_API.mutate,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const body = await readJsonBody(req);
+				if (body === void 0) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "settings-rejected",
+						message: "unreadable JSON body"
+					});
+					return;
+				}
+				if ((typeof body.ns === "string" ? body.ns : "") !== "imagegen" || !Array.isArray(body.ops)) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "settings-rejected",
+						message: "malformed bridge settings request"
+					});
+					return;
+				}
+				const expectedRevision = typeof body.expectedRevision === "number" ? body.expectedRevision : void 0;
+				try {
+					await deps.settings.mutate(settingsNamespace, body.ops, expectedRevision);
+				} catch (error) {
+					writeJson(res, 200, failureOf(error));
+					return;
+				}
+				const descriptor = deps.settings.describe({ redactSecrets: true }).find((candidate) => String(candidate.ns) === settingsNamespace);
+				if (descriptor === void 0) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "internal",
+						message: `settings namespace "${settingsNamespace}" was disposed after the mutate`
+					});
+					return;
+				}
+				writeJson(res, 200, {
+					ok: true,
+					value: toView(descriptor, IMAGEGEN_SETTINGS_NAMESPACE)
+				});
+			}
+		},
+		{
+			kind: "exact",
+			path: GENERATE_API,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const body = await readJsonBody(req);
+				const parsed = body === void 0 ? void 0 : parseGenerateRequest(body);
+				if (parsed === void 0) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "bad-request",
+						message: "prompt is required"
+					});
+					return;
+				}
+				const resolved = resolveChannelRequest(parsed);
+				if (!resolved.ok) {
+					writeJson(res, 200, {
+						ok: false,
+						code: resolved.code,
+						message: resolved.message
+					});
+					return;
+				}
+				try {
+					writeJson(res, 200, {
+						ok: true,
+						...await runtime.run(resolved.request)
+					});
+				} catch (error) {
+					const message = error instanceof Error ? error.message : String(error);
+					writeJson(res, 200, {
+						ok: false,
+						code: error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : "generate-failed",
+						message
+					});
+				}
+			}
+		},
+		{
+			kind: "exact",
+			path: TASK_API.submit,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const body = await readJsonBody(req);
+				const parsed = body === void 0 ? void 0 : parseGenerateRequest(body);
+				if (parsed === void 0) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "bad-request",
+						message: "prompt is required"
+					});
+					return;
+				}
+				const resolved = resolveChannelRequest(parsed);
+				if (!resolved.ok) {
+					writeJson(res, 200, {
+						ok: false,
+						code: resolved.code,
+						message: resolved.message
+					});
+					return;
+				}
+				writeJson(res, 200, {
+					ok: true,
+					task: runtime.queue.submit(resolved.request)
+				});
+			}
+		},
+		{
+			kind: "exact",
+			path: TASK_API.list,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				writeJson(res, 200, {
+					ok: true,
+					tasks: runtime.queue.summaries()
+				});
+			}
+		},
+		{
+			kind: "exact",
+			path: TASK_API.get,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const body = await readJsonBody(req);
+				const task = typeof body?.id === "string" ? runtime.queue.get(body.id) : void 0;
+				if (task === void 0) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "not-found",
+						message: "task not found"
+					});
+					return;
+				}
+				writeJson(res, 200, {
+					ok: true,
+					task
+				});
+			}
+		},
+		{
+			kind: "exact",
+			path: TASK_API.cancel,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const body = await readJsonBody(req);
+				const task = typeof body?.id === "string" ? runtime.queue.cancel(body.id) : void 0;
+				if (task === void 0) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "not-found",
+						message: "task not found"
+					});
+					return;
+				}
+				writeJson(res, 200, {
+					ok: true,
+					task
+				});
+			}
+		},
+		{
+			kind: "exact",
+			path: TASK_API.retry,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const body = await readJsonBody(req);
+				const task = typeof body?.id === "string" ? runtime.queue.retry(body.id) : void 0;
+				if (task === void 0) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "not-found",
+						message: "task not found"
+					});
+					return;
+				}
+				writeJson(res, 200, {
+					ok: true,
+					task
+				});
+			}
+		},
+		...deps.subscriptions === void 0 ? [] : [{
+			kind: "exact",
+			path: SUBSCRIPTION_API.status,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const statuses = {};
+				for (const provider of SUBSCRIPTION_PROVIDERS) {
+					const vendor = vendorOfSubscription(provider);
+					const status = await deps.subscriptions.loginStatus(vendor);
+					const error = deps.subscriptions.lastLoginError(vendor);
+					statuses[provider] = status.state === "logged-in" ? {
+						state: status.state,
+						email: status.email
+					} : {
+						state: status.state,
+						...error === void 0 ? {} : { error }
+					};
+				}
+				writeJson(res, 200, {
+					ok: true,
+					statuses
+				});
+			}
+		}, {
+			kind: "exact",
+			path: SUBSCRIPTION_API.login,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const body = await readJsonBody(req);
+				const provider = typeof body?.provider === "string" ? body.provider : "";
+				if (!SUBSCRIPTION_PROVIDERS.includes(provider)) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "invalid-provider",
+						message: "unknown subscription provider"
+					});
+					return;
+				}
+				const vendor = vendorOfSubscription(provider);
+				try {
+					if (body?.action === "logout") {
+						await deps.subscriptions.logout(vendor);
+						writeJson(res, 200, { ok: true });
+						return;
+					}
+					if (body?.action === "complete") {
+						const input = typeof body.input === "string" ? body.input : "";
+						await deps.subscriptions.completeLogin(vendor, input);
+						writeJson(res, 200, { ok: true });
+						return;
+					}
+					writeJson(res, 200, {
+						ok: true,
+						...await deps.subscriptions.beginLogin(vendor)
+					});
+				} catch (error) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "subscription-login-failed",
+						message: messageOf(error)
+					});
+				}
+			}
+		}]
+	];
+}
+//#endregion
+//#region src/agent-image-tools.ts
+const imageRefSchema = {
+	type: "object",
+	additionalProperties: false,
+	properties: {
+		attachment_id: {
+			type: "string",
+			required: true
+		},
+		media_type: {
+			type: "string",
+			required: true
+		},
+		bytes: {
+			type: "integer",
+			required: true
+		},
+		width: {
+			type: "integer",
+			required: true
+		},
+		height: {
+			type: "integer",
+			required: true
+		},
+		name: { type: "string" }
+	}
+};
+const taskResultSchema = {
+	type: "object",
+	additionalProperties: false,
+	properties: {
+		task_id: {
+			type: "string",
+			required: true
+		},
+		status: {
+			type: "string",
+			required: true
+		},
+		message: {
+			type: "string",
+			required: true
+		},
+		error: { type: "string" },
+		images: {
+			type: "array",
+			required: true,
+			items: imageRefSchema
+		}
+	}
+};
+/** Agent calls stay pending until the provider and history write settle. */
+const AGENT_GENERATION_TIMEOUT_MS = 3e5;
+function ensureAgentImageConfigured(config) {
+	if (!config.enabled) throw new ImageGenError("AI image generation is disabled. Open Settings → Image settings and enable it.", "plugin-disabled");
+	if (!config.allowAgentImageGeneration) throw new ImageGenError("Agent image generation is disabled in Settings → Image settings.", "agent-generation-disabled");
+	if (!config.channels.some((channel) => channel.apiUrl.trim() !== "" && channel.apiKey.trim() !== "")) throw new ImageGenError("Image API credentials are not configured. Open Settings → Image settings, add a channel and fill in its API URL and API key.", "image-api-not-configured");
+}
+/** Resolve a configured image alias and its owning channel. */
+function resolveAgentImageModel(config, requested) {
+	const entries = config.channels.flatMap((channel) => channel.models.map((model) => ({
+		channel,
+		alias: model.alias,
+		upstream: model.id
+	})));
+	if (entries.length === 0) throw new ImageGenError("No image models are configured. Open Settings → Image settings and add a channel with at least one model.", "no-models-configured");
+	const wanted = typeof requested === "string" && requested.trim() !== "" ? requested.trim() : typeof config.defaultModel === "string" ? config.defaultModel.trim() : "";
+	if (wanted === "") {
+		if (entries.length === 1) return entries[0];
+		throw new ImageGenError(`Multiple image models are available — ask the user which channel and model to use, then call this tool again with that exact model name. Options: ${config.channels.flatMap((channel) => channel.models.map((model) => `"${channel.name} · ${model.alias}"`)).join(", ")}.`, "model-choice-required");
+	}
+	const hosting = entries.filter((entry) => entry.alias === wanted);
+	if (hosting.length === 0) throw new ImageGenError(`Image model "${wanted}" is not configured in any channel. Choose one of: ${[...new Set(entries.map((entry) => entry.alias))].join(", ")}.`, "image-model-not-configured");
+	return hosting.find((entry) => entry.channel.id === config.defaultChannelId) ?? hosting[0];
+}
+function findAgentImageTask(runtime, id) {
+	const task = runtime.queue.list().find((candidate) => candidate.id === id);
+	if (task === void 0) throw new ImageGenError(`Image generation task ${id} was not found.`, "task-not-found");
+	return task;
+}
+/** Wait for a queue task without sending anything through the chat model. */
+function waitForAgentImageTask(runtime, id, signal) {
+	return new Promise((resolveTask, rejectTask) => {
+		let settled = false;
+		let dispose = () => {};
+		let timer;
+		let abort = () => {};
+		const cleanup = () => {
+			dispose();
+			if (timer !== void 0) clearTimeout(timer);
+			signal?.removeEventListener("abort", abort);
+		};
+		const resolve = (task) => {
+			if (settled) return;
+			settled = true;
+			cleanup();
+			resolveTask(task);
+		};
+		const reject = (error) => {
+			if (settled) return;
+			settled = true;
+			cleanup();
+			rejectTask(error);
+		};
+		abort = () => {
+			if (settled) return;
+			const reason = signal?.reason instanceof Error ? signal.reason : /* @__PURE__ */ new Error("Image generation was cancelled.");
+			settled = true;
+			cleanup();
+			runtime.queue.cancel(id);
+			rejectTask(reason);
+		};
+		const onChange = (updated) => {
+			if (updated.id === id && isFinalTask(updated)) resolve(updated);
+		};
+		if (signal?.aborted === true) {
+			abort();
+			return;
+		}
+		dispose = runtime.queue.subscribe(onChange);
+		signal?.addEventListener("abort", abort, { once: true });
+		timer = setTimeout(() => {
+			if (settled) return;
+			const timeout = new ImageGenError(`Image generation task ${id} timed out after ${AGENT_GENERATION_TIMEOUT_MS / 1e3} seconds.`, "generation-timeout");
+			settled = true;
+			cleanup();
+			runtime.queue.cancel(id);
+			rejectTask(timeout);
+		}, AGENT_GENERATION_TIMEOUT_MS);
+		let current;
+		try {
+			current = findAgentImageTask(runtime, id);
+		} catch (error) {
+			reject(error);
+			return;
+		}
+		if (isFinalTask(current)) resolve(current);
+	});
+}
+/** Submit the same image-edit request used by the Agent tool. */
+async function submitAgentImageEdit(attachments, runtime, resolve, input) {
+	const config = resolve();
+	ensureAgentImageConfigured(config);
+	const reference = await attachments.readImage(input.sourceImage, input.signal);
+	const fallbackModel = (config.channels.find((channel) => channel.id === config.defaultChannelId) ?? config.channels[0])?.models[0]?.alias ?? config.channels.flatMap((channel) => channel.models)[0]?.alias ?? "";
+	const picked = resolveAgentImageModel(config, config.defaultModel?.trim() || fallbackModel);
+	return waitForAgentImageTask(runtime, runtime.queue.submit({
+		mode: "edit",
+		model: picked.alias,
+		upstream: picked.upstream,
+		channelId: picked.channel.id,
+		channel: picked.channel.name,
+		prompt: input.prompt.trim(),
+		size: "auto",
+		quality: "auto",
+		n: 1,
+		detail: "",
+		image: imageDataUrl(reference),
+		...reference.ref.name === void 0 ? {} : { refName: reference.ref.name }
+	}).id, input.signal);
+}
+function acceptedMediaType(value) {
+	return value === "image/png" || value === "image/jpeg" || value === "image/webp" || value === "image/gif";
+}
+function projectRef(ref) {
+	return {
+		attachment_id: String(ref.attachmentId),
+		media_type: ref.mediaType,
+		bytes: ref.bytes,
+		width: ref.width,
+		height: ref.height,
+		...ref.name === void 0 ? {} : { name: ref.name }
+	};
+}
+function restoreRef(value) {
+	if (!acceptedMediaType(value.media_type)) throw new ImageGenError("source_image.media_type is not a supported image type", "bad-reference-image");
+	if (!Number.isInteger(value.bytes) || value.bytes < 1 || !Number.isInteger(value.width) || value.width < 1 || !Number.isInteger(value.height) || value.height < 1) throw new ImageGenError("source_image metadata is invalid", "bad-reference-image");
+	return {
+		attachmentId: value.attachment_id,
+		mediaType: value.media_type,
+		bytes: value.bytes,
+		width: value.width,
+		height: value.height,
+		...value.name === void 0 ? {} : { name: value.name }
+	};
+}
+function imageDataUrl(image) {
+	return `data:${image.ref.mediaType};base64,${Buffer.from(image.data).toString("base64")}`;
+}
+function renderTaskResult(value) {
+	return [{
+		type: "text",
+		text: JSON.stringify(value)
+	}];
+}
+/** The UI-only projection that keeps generated images beside the tool call. */
+function imagePresentationMeta(value) {
+	return { images: value.images.map((image) => {
+		const ref = {
+			attachment_id: image.attachment_id,
+			media_type: image.media_type,
+			bytes: image.bytes,
+			width: image.width,
+			height: image.height
+		};
+		if (image.name !== void 0) ref.name = image.name;
+		return ref;
+	}) };
+}
+function imageBlocksFromMeta(meta) {
+	if (typeof meta !== "object" || meta === null || Array.isArray(meta)) return [];
+	const images = meta.images;
+	if (!Array.isArray(images)) return [];
+	return images.flatMap((value) => {
+		if (typeof value !== "object" || value === null || Array.isArray(value)) return [];
+		const raw = value;
+		if (typeof raw.attachment_id !== "string" || typeof raw.media_type !== "string" || typeof raw.bytes !== "number" || typeof raw.width !== "number" || typeof raw.height !== "number") return [];
+		try {
+			return [{
+				type: "image",
+				attachment: restoreRef({
+					attachment_id: raw.attachment_id,
+					media_type: raw.media_type,
+					bytes: raw.bytes,
+					width: raw.width,
+					height: raw.height,
+					...typeof raw.name === "string" ? { name: raw.name } : {}
+				})
+			}];
+		} catch {
+			return [];
+		}
+	});
+}
+/** Rehydrate image attachments for the host-computed tool result view only. */
+function presentImageResult(_args, result) {
+	const content = result.isError ? [] : imageBlocksFromMeta(result.meta);
+	return content.length === 0 ? void 0 : {
+		card: "generic",
+		content
+	};
+}
+/** Register the global Agent tools and unregister them with the plugin lifecycle. */
+function registerAgentImageTools(ctx, runtime, resolve) {
+	const attachmentRefs = /* @__PURE__ */ new Map();
+	const ensureConfigured = () => {
+		ensureAgentImageConfigured(resolve());
+	};
+	const resolveModel = (requested) => resolveAgentImageModel(resolve(), requested);
+	const materializeTaskImages = (task) => {
+		if (task.status !== "completed") return Promise.resolve([]);
+		const existing = attachmentRefs.get(task.id);
+		if (existing !== void 0) return existing;
+		const pending = ctx.attachments.saveImages((task.result?.images ?? []).map((image, index) => toSaveImage(image, task.id, index))).then((refs) => refs.map(projectRef));
+		attachmentRefs.set(task.id, pending);
+		pending.catch(() => {
+			if (attachmentRefs.get(task.id) === pending) attachmentRefs.delete(task.id);
+		});
+		return pending;
+	};
+	const taskResult = async (task) => {
+		const images = await materializeTaskImages(task);
+		return {
+			task_id: task.id,
+			status: task.status,
+			message: task.status === "completed" ? "Generation completed. The images are shown beside this tool call and can be reused as source_image in edit_image." : task.status === "failed" ? "Generation failed." : task.status === "cancelled" ? "Generation was cancelled." : "Generation is still running. Query the task again when you need its current status.",
+			...task.error === void 0 ? {} : { error: task.error },
+			images
+		};
+	};
+	const findTask = (id) => findAgentImageTask(runtime, id);
+	const waitForTask = (id, signal) => waitForAgentImageTask(runtime, id, signal);
+	const disposers = [
+		ctx.tools.register(defineTool({
+			name: "generate_image",
+			description: "Generate an image. By default this tool call stays pending until the task reaches a final state; completed images are shown beside this tool call, while the model receives their attachment references, without creating a user message. Set wait_for_completion to false for background mode, then use get_image_generation_task explicitly. Only use models configured for this plugin; omit model to use the configured default image model (or the first model when none is configured).",
+			parameters: {
+				prompt: {
+					type: "string",
+					required: true,
+					description: "Detailed image-generation prompt."
+				},
+				model: {
+					type: "string",
+					description: "One of the configured image models. Defaults to the configured default image model, or the first model when none is configured."
+				},
+				size: {
+					type: "string",
+					description: "Aspect ratio such as 1:1, 16:9, 9:16, or auto."
+				},
+				quality: {
+					type: "string",
+					description: "auto, 1k, 2k, or 4k."
+				},
+				count: {
+					type: "integer",
+					description: "Number of images, 1 to 4. Defaults to 1."
+				},
+				detail: {
+					type: "string",
+					description: "Optional provider detail value, for example standard or high."
+				},
+				wait_for_completion: {
+					type: "boolean",
+					description: "Wait for images and return them in this tool result. Defaults to true; set false for background mode."
+				}
+			},
+			output: {
+				schema: taskResultSchema,
+				render: (_args, value) => renderTaskResult(value),
+				presentationMeta: (_args, value) => imagePresentationMeta(value)
+			},
+			presentResult: presentImageResult,
+			async execute(args, exec) {
+				ensureConfigured();
+				const picked = resolveModel(args.model);
+				const task = runtime.queue.submit({
+					mode: "text",
+					model: picked.alias,
+					upstream: picked.upstream,
+					channelId: picked.channel.id,
+					channel: picked.channel.name,
+					prompt: args.prompt.trim(),
+					size: args.size ?? "auto",
+					quality: args.quality ?? "auto",
+					n: Math.min(4, Math.max(1, args.count ?? 1)),
+					detail: args.detail ?? ""
+				});
+				return taskResult(args.wait_for_completion === false ? task : await waitForTask(task.id, exec.signal));
+			}
+		})),
+		ctx.tools.register(defineTool({
+			name: "edit_image",
+			description: "Edit an image. By default this tool call stays pending until the task reaches a final state; completed images are shown beside this tool call, while the model receives their attachment references, without creating a user message. Set wait_for_completion to false for background mode, then use get_image_generation_task explicitly. source_image must be an image reference returned by a completed generation or get_image_generation_task; pass that entire object unchanged. Only configured image models are allowed; omit model to use the configured default image model (or the first model when none is configured).",
+			parameters: {
+				prompt: {
+					type: "string",
+					required: true,
+					description: "How to transform the source image."
+				},
+				source_image: {
+					...imageRefSchema,
+					required: true,
+					description: "Image reference returned by get_image_generation_task."
+				},
+				model: {
+					type: "string",
+					description: "One of the configured image models. Defaults to the configured default image model, or the first model when none is configured."
+				},
+				size: {
+					type: "string",
+					description: "Aspect ratio such as 1:1, 16:9, 9:16, or auto."
+				},
+				quality: {
+					type: "string",
+					description: "auto, 1k, 2k, or 4k."
+				},
+				count: {
+					type: "integer",
+					description: "Number of images, 1 to 4. Defaults to 1."
+				},
+				detail: {
+					type: "string",
+					description: "Optional provider detail value."
+				},
+				wait_for_completion: {
+					type: "boolean",
+					description: "Wait for images and return them in this tool result. Defaults to true; set false for background mode."
+				}
+			},
+			output: {
+				schema: taskResultSchema,
+				render: (_args, value) => renderTaskResult(value),
+				presentationMeta: (_args, value) => imagePresentationMeta(value)
+			},
+			presentResult: presentImageResult,
+			async execute(args, exec) {
+				ensureConfigured();
+				const reference = await ctx.attachments.readImage(restoreRef(args.source_image), exec.signal);
+				const picked = resolveModel(args.model);
+				const task = runtime.queue.submit({
+					mode: "edit",
+					model: picked.alias,
+					upstream: picked.upstream,
+					channelId: picked.channel.id,
+					channel: picked.channel.name,
+					prompt: args.prompt.trim(),
+					size: args.size ?? "auto",
+					quality: args.quality ?? "auto",
+					n: Math.min(4, Math.max(1, args.count ?? 1)),
+					detail: args.detail ?? "",
+					image: imageDataUrl(reference),
+					...reference.ref.name === void 0 ? {} : { refName: reference.ref.name }
+				});
+				return taskResult(args.wait_for_completion === false ? task : await waitForTask(task.id, exec.signal));
+			}
+		})),
+		ctx.tools.register(defineTool({
+			name: "get_image_generation_task",
+			description: "Check an image-generation task status. Completed tasks return image references; their images are shown beside this tool call and the references can be passed to edit_image. Generation tools normally wait for completion, so use this for explicit recovery or status checks.",
+			parameters: { task_id: {
+				type: "string",
+				required: true,
+				description: "Task id returned by generate_image or edit_image."
+			} },
+			output: {
+				schema: taskResultSchema,
+				render: (_args, value) => renderTaskResult(value),
+				presentationMeta: (_args, value) => imagePresentationMeta(value)
+			},
+			presentResult: presentImageResult,
+			async execute(args) {
+				ensureConfigured();
+				return taskResult(findTask(args.task_id));
+			}
+		})),
+		ctx.tools.register(defineTool({
+			name: "cancel_image_generation_task",
+			description: "Cancel a queued or running image generation task.",
+			parameters: { task_id: {
+				type: "string",
+				required: true,
+				description: "Task id returned by generate_image or edit_image."
+			} },
+			output: {
+				schema: taskResultSchema,
+				render: (_args, value) => renderTaskResult(value),
+				presentationMeta: (_args, value) => imagePresentationMeta(value)
+			},
+			presentResult: presentImageResult,
+			async execute(args) {
+				ensureConfigured();
+				const task = runtime.queue.cancel(args.task_id);
+				if (task === void 0) throw new ImageGenError(`Image generation task ${args.task_id} was not found.`, "task-not-found");
+				return taskResult(task);
+			}
+		}))
+	];
+	return () => {
+		for (const dispose of disposers) dispose();
+	};
+}
+function isFinalTask(task) {
+	return task.status === "completed" || task.status === "failed" || task.status === "cancelled";
+}
+function toSaveImage(image, taskId, index) {
+	const data = Buffer.from(image.b64, "base64");
+	const declaredMediaType = acceptedMediaType(image.mime) ? image.mime : "image/png";
+	const mediaType = detectImageMime(data) ?? declaredMediaType;
+	return {
+		data,
+		mediaType,
+		name: `imagegen-${taskId}-${index + 1}.${mediaType === "image/jpeg" ? "jpg" : mediaType.slice(6)}`
+	};
+}
+//#endregion
+//#region src/edit-image-command.ts
+function isImageReference(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	const ref = value;
+	return typeof ref.attachmentId === "string" && (ref.mediaType === "image/png" || ref.mediaType === "image/jpeg" || ref.mediaType === "image/webp" || ref.mediaType === "image/gif") && Number.isInteger(ref.bytes) && ref.bytes > 0 && Number.isInteger(ref.width) && ref.width > 0 && Number.isInteger(ref.height) && ref.height > 0;
+}
+function imageInContent(value) {
+	if (!Array.isArray(value)) return void 0;
+	for (let index = value.length - 1; index >= 0; index -= 1) {
+		const block = value[index];
+		if (typeof block !== "object" || block === null || Array.isArray(block)) continue;
+		const raw = block;
+		if (raw.type === "image" && isImageReference(raw.attachment)) return raw.attachment;
+		if (raw.type === "tool-result") {
+			const nested = imageInContent(raw.content);
+			if (nested !== void 0) return nested;
+		}
+	}
+}
+/** Pick the newest image explicitly attached to this command invocation. */
+function imageInInvocation(value) {
+	if (!Array.isArray(value)) return void 0;
+	for (let index = value.length - 1; index >= 0; index -= 1) {
+		const block = value[index];
+		if (typeof block !== "object" || block === null || Array.isArray(block)) continue;
+		const raw = block;
+		if (raw.type === "image" && isImageReference(raw.attachment)) return raw.attachment;
+	}
+}
+/** Find the newest durable image reference, including nested tool results. */
+function latestSessionImage(messages) {
+	for (let index = messages.length - 1; index >= 0; index -= 1) {
+		const message = messages[index];
+		if (typeof message !== "object" || message === null || Array.isArray(message)) continue;
+		const image = imageInContent(message.content);
+		if (image !== void 0) return image;
+	}
+}
+function commandError(error) {
+	const text = error instanceof Error ? error.message : String(error);
+	return {
+		kind: "error",
+		text: text.trim() === "" ? "图片编辑失败。" : text
+	};
+}
+/** Register the host-side command; it never sends the command line to a chat model. */
+function registerEditImageCommand(ctx, runtime, resolve, pendingImages) {
+	return ctx.commands.register({
+		name: "edit_image",
+		description: "Edit the latest image in this conversation with the plugin image model",
+		input: {
+			hint: "Describe how to modify the latest image",
+			images: true
+		},
+		async handler(invocation) {
+			const prompt = invocation.rawInput.trim();
+			if (prompt === "") return {
+				kind: "error",
+				text: "请提供图片修改描述，例如：/edit_image 把背景改成夜景"
+			};
+			const invocationImage = imageInInvocation(invocation.attachments);
+			const pendingImage = pendingImages?.get(String(invocation.agent.id));
+			const durableImage = latestSessionImage(invocation.agent.session.deriveMessages());
+			const sourceImage = invocationImage ?? pendingImage ?? durableImage;
+			if (sourceImage === void 0) return {
+				kind: "error",
+				text: "当前对话没有可用图片，请先上传图片或把画廊图片加入对话。"
+			};
+			try {
+				const task = await submitAgentImageEdit(ctx.attachments, runtime, resolve, {
+					prompt,
+					sourceImage,
+					signal: invocation.signal
+				});
+				if (task.status === "completed") {
+					if (pendingImage !== void 0) pendingImages?.consume(String(invocation.agent.id), pendingImage);
+					return {
+						kind: "success",
+						text: "图片编辑已完成，可在 AI 生图面板查看结果。"
+					};
+				}
+				return {
+					kind: "error",
+					text: task.error ?? `图片编辑${task.status === "cancelled" ? "已取消" : "失败"}。`
+				};
+			} catch (error) {
+				return commandError(error);
+			}
+		}
+	});
+}
+//#endregion
+//#region src/index.ts
+/** Stable cordis plugin name. */
+const name = "imagegen";
+/** Services required before the surfaces can mount. */
+const inject = [
+	"webServer",
+	"systemPrompt",
+	"commands"
+];
+/** The branded settings namespace of this plugin (the card edits it). */
+const ImageGenSettingsNamespace = settingsNamespaceCompat(IMAGEGEN_SETTINGS_NAMESPACE);
+/**
+* The config schema. Every field is live: the root is marked volatile so the
+* host derives an editable form for this entry and commits settings edits into
+* the running fiber instead of remounting the plugin.
+*/
+const Config = z.object({
+	enabled: z.boolean().default(true),
+	announceToAgent: z.boolean().default(true),
+	allowAgentImageGeneration: z.boolean().default(true),
+	channels: z.array(z.object({
+		id: z.string(),
+		preset: z.string().default(""),
+		name: z.string().default(""),
+		apiUrl: z.string().default(""),
+		apiUrlFull: z.boolean().default(false),
+		models: z.array(z.object({
+			alias: z.string(),
+			id: z.string()
+		})).default([])
+	})).default([]),
+	channelSecrets: z.dict(z.string().role("secret")).default({}),
+	defaultChannelId: z.string().default(""),
+	promptApiUrl: z.string().default(""),
+	promptApiKey: z.string().role("secret").default(""),
+	promptModel: z.string().default(""),
+	apiUrl: z.string().default(""),
+	apiKey: z.string().role("secret").default(""),
+	imageModels: z.array(z.string()).default([])
+}).volatile();
+/** Schema defaults, re-read for hand-built contexts (the loader applies them normally). */
+const DEFAULT_ENABLED = true;
+const DEFAULT_ANNOUNCE = true;
+const DEFAULT_ALLOW_AGENT_IMAGE_GENERATION = true;
+/** Order of the announcement section within the tool-guidance band. */
+const SECTION_ORDER = 150;
+/** Model-facing announcement: plugin presence, capabilities, and limits. */
+const IMAGEGEN_GUIDANCE = "本机已安装 dsh-imagegen 插件（DSH AI 生图）：通过「渠道」对接 OpenAI 兼容图像生成 API（每个渠道 = 一个 API 端点 + 各自的模型目录），支持文生图（/images/generations）与图生图（/images/edits，上传参考图，grok-imagine 模型按官方 JSON image_url 协议发送，nanobanana 系列按 aspect_ratio / image_size 参数协议发送；seedream 系列统一走 /images/generations，参考图以 JSON image 数组发送；智谱 `glm-image` 使用官方 `/api/paas/v4/images/generations`，当前仅支持文生图；qwen-image 系列使用阿里云 DashScope 原生接口（api_url 填 https://dashscope.aliyuncs.com/api/v1，不支持 OpenAI 兼容模式，该渠道不可复用于提示词增强，尺寸自动映射为宽*高）。MiniMax `image-01` 使用 MiniMax 原生 `/image_generation` 接口（api_url 填 https://api.minimax.io/v1 或国内站 https://api.minimaxi.com/v1，支持 1:1/16:9/4:3/3:2/2:3/3:4/9:16/21:9 宽高比，一次最多 9 张；图生图为单张 subject_reference 主体参考（保持人物/主体一致，非像素级局部编辑）；其 /models 只列聊天模型，图片模型需用预设目录）。API 地址与密钥在 GUI 设置中按渠道配置，密钥仅存于本机设置文档；生成请求由本地宿主代理转发，结果以 base64 返回。模型只能使用用户在各渠道配置目录中的模型；检测模型时会过滤聊天、Embedding 等非图片模型，但模型出现在 /models 中仍不等于其网关原生支持生图协议，遇到 Qwen、MiniMax、Gemini 等非 OpenAI 生图协议时应如实说明上游兼容性。Agent 可直接调用 `generate_image` 提交文生图，也可用 `edit_image` 图生图；默认保持工具调用等待直到任务完成，完成图片显示在工具调用对应的左侧结果区域，模型收到状态和附件引用，不会额外伪造用户消息。用户也可以使用 `/edit_image <修改描述>`，命令会直接读取当前对话最近图片并调用插件图片模型，不经过对话模型的图片能力检查。若明确需要后台执行，可传 `wait_for_completion: false`，之后再用 `get_image_generation_task` 查询；不要反复轮询。限制：生成消耗上游 API 额度；图片内容由上游模型生成，可能不符合预期或包含不适宜内容；api_key 以明文存储在设置文档中；参考图会发送至所配置的 API 服务。用户提到「生图 / 绘画 / 生成图片 / 文生图 / 图生图」时即指本插件，请据此协作。";
+/** Append the live channel × model table so an Agent can honor user choices. */
+function guidanceFor(channels, defaultChannelId) {
+	if (channels.length === 0) return `${IMAGEGEN_GUIDANCE} 尚未配置任何渠道：请先在「设置 → 插件 → AI 生图」添加渠道并填写 API 地址与密钥。`;
+	const table = channels.map((channel) => {
+		const aliases = channel.models.map((model) => model.alias).join("、");
+		const mark = channel.id === defaultChannelId ? "（默认渠道）" : "";
+		const key = channel.apiKey === "" ? "（未填密钥）" : "";
+		const models = channel.models.length === 0 ? "未配置模型" : `可用模型：${aliases}`;
+		return `渠道「${channel.name}」${mark}[${channel.apiUrl}] ${models}${key}`;
+	}).join("；");
+	return `${IMAGEGEN_GUIDANCE} 当前渠道与模型：${table}。用户指定模型名时取该模型所属渠道（多渠道同名用默认渠道）；未指定模型时若仅一个可用模型可直接生成，若有多个应先询问用户选择「渠道 + 模型」。`;
+}
+/** Normalize raw channel entries into the wire shape (schema-adjacent guard). */
+function normalizeChannels(value) {
+	if (!Array.isArray(value)) return [];
+	const out = [];
+	for (const item of value) {
+		if (item === null || typeof item !== "object") continue;
+		const raw = item;
+		const id = typeof raw.id === "string" ? raw.id.trim() : "";
+		if (id === "") continue;
+		const models = [];
+		if (Array.isArray(raw.models)) for (const entry of raw.models) {
+			if (entry === null || typeof entry !== "object") continue;
+			const record = entry;
+			const alias = typeof record.alias === "string" ? record.alias.trim() : "";
+			const upstream = typeof record.id === "string" ? record.id.trim() : "";
+			if (alias === "") continue;
+			models.push({
+				alias,
+				id: upstream === "" ? alias : upstream
+			});
+		}
+		out.push({
+			id,
+			preset: typeof raw.preset === "string" ? raw.preset : "",
+			name: typeof raw.name === "string" ? raw.name.trim() : "",
+			apiUrl: typeof raw.apiUrl === "string" ? raw.apiUrl.trim() : "",
+			apiUrlFull: false,
+			models
+		});
+	}
+	return out;
+}
+/**
+* Mount the settings section, routes, Agent tools, and announcement.
+* @param ctx - host plugin context carrying webServer/systemPrompt.
+* @param config - live config reference (schema defaults applied by the loader).
+*/
+function apply(ctx, config) {
+	let current = () => config?.get() ?? {};
+	const resolve = () => {
+		const value = current() ?? {};
+		let channels = normalizeChannels(value.channels);
+		const secrets = { ...value.channelSecrets ?? {} };
+		if (channels.length === 0) {
+			const legacyUrl = typeof value.apiUrl === "string" ? value.apiUrl.trim() : "";
+			const legacyModels = Array.isArray(value.imageModels) ? value.imageModels.filter((model) => typeof model === "string" && model.trim() !== "").map((model) => ({
+				alias: model.trim(),
+				id: model.trim()
+			})) : [];
+			if (legacyUrl !== "" || legacyModels.length > 0) {
+				channels = [{
+					id: "default",
+					preset: "",
+					name: "默认渠道",
+					apiUrl: legacyUrl,
+					apiUrlFull: false,
+					models: legacyModels
+				}];
+				const legacyKey = typeof value.apiKey === "string" ? value.apiKey.trim() : "";
+				if (legacyKey !== "") secrets["default"] = legacyKey;
+			}
+		}
+		const named = channels.map((channel) => ({
+			...channel,
+			name: channel.name === "" ? presetById(channel.preset)?.name ?? "未命名渠道" : channel.name
+		}));
+		const defaultChannelId = typeof value.defaultChannelId === "string" && named.some((channel) => channel.id === value.defaultChannelId) ? value.defaultChannelId : named[0]?.id ?? "";
+		return {
+			enabled: value.enabled ?? DEFAULT_ENABLED,
+			announceToAgent: value.announceToAgent ?? DEFAULT_ANNOUNCE,
+			allowAgentImageGeneration: value.allowAgentImageGeneration ?? DEFAULT_ALLOW_AGENT_IMAGE_GENERATION,
+			channels: named.map((channel) => ({
+				...channel,
+				apiKey: typeof secrets[channel.id] === "string" ? secrets[channel.id] : ""
+			})),
+			defaultChannelId,
+			promptApiUrl: typeof value.promptApiUrl === "string" ? value.promptApiUrl.trim() : "",
+			promptApiKey: typeof value.promptApiKey === "string" ? value.promptApiKey.trim() : "",
+			promptModel: typeof value.promptModel === "string" ? value.promptModel.trim() : ""
+		};
+	};
+	const channelsView = () => {
+		const value = resolve();
+		return {
+			channels: value.channels,
+			defaultChannelId: value.defaultChannelId
+		};
+	};
+	const runtime = new ImageGenerationRuntime(channelsView);
+	const pendingConversationImages = /* @__PURE__ */ new Map();
+	ctx.inject(["settings", "attachments"], (sctx) => {
+		const seam = sctx.get("settings");
+		sctx.effect(() => {
+			const disposers = makeRoutes({
+				settings: seam,
+				resolve: () => {
+					const value = resolve();
+					const channel = value.channels.find((candidate) => candidate.id === value.defaultChannelId) ?? value.channels[0];
+					return {
+						apiUrl: channel?.apiUrl ?? "",
+						apiKey: channel?.apiKey ?? ""
+					};
+				},
+				resolveChannels: channelsView,
+				resolvePrompt: () => {
+					const value = resolve();
+					const channel = value.channels.find((candidate) => candidate.id === value.defaultChannelId) ?? value.channels[0];
+					return {
+						apiUrl: value.promptApiUrl !== "" ? value.promptApiUrl : channel?.apiUrl ?? "",
+						apiKey: value.promptApiKey !== "" ? value.promptApiKey : channel?.apiKey ?? "",
+						model: value.promptModel
+					};
+				},
+				resolveImageModels: () => {
+					const value = resolve();
+					return [...new Set(value.channels.flatMap((channel) => channel.models.map((model) => model.alias)))];
+				},
+				attachments: sctx.attachments,
+				pendingConversationImages,
+				runtime
+			}).map((route) => ctx.webServer.register(route));
+			return () => {
+				for (const dispose of disposers) dispose();
+			};
+		}, "dsh-imagegen: routes");
+	});
+	ctx.inject([
+		"tools",
+		"attachments",
+		"commands"
+	], (tctx) => {
+		tctx.effect(() => {
+			const resolveAgentConfig = () => {
+				const value = resolve();
+				return {
+					enabled: value.enabled,
+					allowAgentImageGeneration: value.allowAgentImageGeneration,
+					channels: value.channels,
+					defaultChannelId: value.defaultChannelId
+				};
+			};
+			const disposeTools = registerAgentImageTools(tctx, runtime, resolveAgentConfig);
+			const disposeCommand = registerEditImageCommand(tctx, runtime, resolveAgentConfig, {
+				get: (sessionId) => pendingConversationImages.get(sessionId),
+				consume: (sessionId, ref) => {
+					if (pendingConversationImages.get(sessionId)?.attachmentId === ref.attachmentId) pendingConversationImages.delete(sessionId);
+				}
+			});
+			return () => {
+				disposeCommand();
+				disposeTools();
+			};
+		}, "dsh-imagegen: agent image tools and commands");
+	});
+	let disposeSection;
+	const sync = () => {
+		if (disposeSection !== void 0) {
+			disposeSection();
+			disposeSection = void 0;
+		}
+		const value = resolve();
+		if (!value.enabled || !value.announceToAgent) return;
+		disposeSection = ctx.systemPrompt.section({
+			name: "plugin:dsh-imagegen",
+			order: SECTION_ORDER,
+			text: guidanceFor(value.channels, value.defaultChannelId)
+		});
+	};
+	installSettingsSectionCompat(ctx, ImageGenSettingsNamespace, Config, config?.get() ?? {}, {
+		setSource: (source) => {
+			current = source;
+			sync();
+		},
+		onChange: sync
+	});
+	sync();
+}
+//#endregion
+export { Config, IMAGEGEN_GUIDANCE, ImageGenError, ImageGenSettingsNamespace, ImageGenerationRuntime, apply, generateImage, inject, latestSessionImage, makeRoutes, name, promptCharLimit, registerAgentImageTools, registerEditImageCommand };