dsh-packycode-api 1.4.7 → 1.4.9

package/lib/index.js

@@ -1078,8 +1078,8 @@ const DEFAULT_REASONING_LEVEL = "high";
 *   ends early. So every model pins the protocol its vendor serves here.
 *
 * Effort levels come from each vendor's documentation, because an effort the
-* model does not support is refused before the request is sent: Claude Opus
-* 5.5 (platform.claude.com effort docs), GPT-6.1 Sol, GPT-6.1 Terra, GPT-6
+* model does not support is refused before the request is sent: Claude Fable
+* 5.2 and Opus 5.5 (platform.claude.com effort docs), GPT-6.1 Sol, GPT-6.1 Terra, GPT-6
 * Astra and GPT-5.6 Sol `reasoning.effort` (developers.openai.com model
 * pages), DeepSeek thinking mode (`low|high|max` effort, or off, for Flash
 * and V4 Pro alike), Grok 4.7
@@ -1125,7 +1125,7 @@ const DEEPSEEK_LEVELS = Object.freeze({
 	max: "max"
 });
 /**
-* Claude 5.5 models, GPT-6.1 Sol, and GPT-6 Astra cannot disable reasoning, so `off` is
+* Claude Fable 5.2, the Claude 5.5 models, GPT-6.1 Sol, and GPT-6 Astra cannot disable reasoning, so `off` is
 * pinned unsupported; GPT-5.6 Sol is kept on the same levels. Claude effort is
 * sent through the native Messages API.
 */
@@ -1315,6 +1315,23 @@ const PACKYCODE_MODELS = Object.freeze([
 		maxTokens: 65536,
 		thinkingLevelMap: GEMINI_LEVELS
 	}),
+	Object.freeze({
+		id: "claude-fable-5-2",
+		name: "Claude Fable 5.2",
+		api: "anthropic-messages",
+		provider: PROVIDER,
+		baseUrl: MESSAGES_BASE,
+		reasoning: true,
+		input: Object.freeze(["text", "image"]),
+		cost: NO_COST,
+		contextWindow: 1e6,
+		maxTokens: 128e3,
+		thinkingLevelMap: ALWAYS_THINKING_LEVELS,
+		compat: Object.freeze({
+			forceAdaptiveThinking: true,
+			supportsTemperature: false
+		})
+	}),
 	Object.freeze({
 		id: "claude-opus-5-5",
 		name: "Claude Opus 5.5",
@@ -1375,11 +1392,13 @@ const PACKYCODE_MODEL_IDS = Object.freeze(PACKYCODE_MODELS.map((model) => model.
 * JSON state over the System One protocol, which PackyCode lists as the
 * `systemone` endpoint (`POST /v1/systemone`) in the `typesafe-officially`
 * group. Auto review asks it whether a tool call may run. The descriptor
-* follows pi-ai's own TypeSafe catalog entry (64K context, text only).
+* follows pi-ai's own TypeSafe catalog entry (64K context, text only), and
+* the id is the version PackyCode publishes, since it no longer lists a
+* `jev-latest` alias.
 */
 const PACKYCODE_CLASSIFIER_MODELS = Object.freeze([Object.freeze({
 	type: "classifier",
-	id: "jev-latest",
+	id: "jev-1.14.0",
 	name: "Jev",
 	api: "typesafe-system-one",
 	provider: PROVIDER,
@@ -1510,13 +1529,15 @@ function parseSelectedGroups(message) {
 * Normalize `/api/pricing`: the groups each covered model is enabled in, and
 * each group's public description.
 * @param payload - the parsed pricing body.
+* @param modelIds - the models to keep: the conversation catalog's, or the
+*   image engines' for the image key ring.
 * @returns `{ modelGroups, descriptions }`, or undefined when unrecognized.
 */
-function parsePricing(payload) {
+function parsePricing(payload, modelIds = PACKYCODE_COVERED_MODEL_IDS) {
 	if (!record$5(payload) || !Array.isArray(payload.data)) return void 0;
 	const modelGroups = {};
 	for (const item of payload.data) {
-		if (!record$5(item) || !PACKYCODE_COVERED_MODEL_IDS.includes(item.model_name) || !Array.isArray(item.enable_groups)) continue;
+		if (!record$5(item) || !modelIds.includes(item.model_name) || !Array.isArray(item.enable_groups)) continue;
 		modelGroups[item.model_name] = [...new Set(item.enable_groups.filter((name) => typeof name === "string" && GROUP_NAME.test(name)))].sort();
 	}
 	const descriptions = {};
@@ -1534,12 +1555,13 @@ function parsePricing(payload) {
 * Which covered models a key can reach. Either source decides: a model the
 * key's groups are enabled for, or one its model list shows. A model is only
 * marked unreachable on evidence; with neither source it is left unknown.
-* @param options - the key's groups, its model ids, and pricing's model groups.
+* @param options - the key's groups, its model ids, pricing's model groups,
+*   and the models to decide (the conversation catalog's by default).
 * @returns covered model id → reachable, for the models with evidence.
 */
-function catalogCoverage({ groups, models, modelGroups }) {
+function catalogCoverage({ groups, models, modelGroups, modelIds = PACKYCODE_COVERED_MODEL_IDS }) {
 	const coverage = {};
-	for (const id of PACKYCODE_COVERED_MODEL_IDS) {
+	for (const id of modelIds) {
 		const enabled = modelGroups?.[id];
 		const byGroups = groups === void 0 || enabled === void 0 ? void 0 : enabled.some((name) => groups.includes(name));
 		const byModels = models === void 0 ? void 0 : models.has(id);
@@ -1565,10 +1587,12 @@ function errorMessage(text) {
 }
 /**
 * Cached, single-flight group reader.
-* @param options - key listing, host resolution, and transport knobs.
+* @param options - key listing, host resolution, the models whose coverage
+*   is read (`modelIds`: the conversation catalog's by default, the image
+*   engines' for the image key ring), and transport knobs.
 * @returns `{ read, snapshot, covers, requiredGroups, invalidate }`.
 */
-function createGroupReader({ listKeys, getHosts, fetchImpl = ambientFetch, now = Date.now, ttlMs = DEFAULT_GROUP_TTL_MS, retryMs = FAILED_GROUP_RETRY_MS, timeoutMs = DEFAULT_REQUEST_TIMEOUT_MS } = {}) {
+function createGroupReader({ listKeys, getHosts, modelIds = PACKYCODE_COVERED_MODEL_IDS, fetchImpl = ambientFetch, now = Date.now, ttlMs = DEFAULT_GROUP_TTL_MS, retryMs = FAILED_GROUP_RETRY_MS, timeoutMs = DEFAULT_REQUEST_TIMEOUT_MS } = {}) {
 	if (typeof listKeys !== "function") throw new Error("PackyCode group reader requires listKeys");
 	if (typeof getHosts !== "function") throw new Error("PackyCode group reader requires getHosts");
 	/** Last good reading per key id, kept when a later read of that key fails. */
@@ -1584,7 +1608,7 @@ function createGroupReader({ listKeys, getHosts, fetchImpl = ambientFetch, now =
 		for (const host of statusHostOrder(hosts)) try {
 			const response = await request(`${host}/api/pricing`, { headers: { Accept: "application/json" } }, signal);
 			if (!response.ok) throw new Error(`HTTP ${response.status}`);
-			const pricing = parsePricing(await response.json());
+			const pricing = parsePricing(await response.json(), modelIds);
 			if (pricing === void 0) throw new Error("unrecognized pricing payload");
 			return pricing;
 		} catch (error) {
@@ -1669,7 +1693,7 @@ function createGroupReader({ listKeys, getHosts, fetchImpl = ambientFetch, now =
 					return {
 						id: entry.id,
 						rejected: true,
-						coverage: Object.fromEntries(PACKYCODE_COVERED_MODEL_IDS.map((id) => [id, false])),
+						coverage: Object.fromEntries(modelIds.map((id) => [id, false])),
 						error: new RejectedKeyError().message
 					};
 				}
@@ -1680,7 +1704,8 @@ function createGroupReader({ listKeys, getHosts, fetchImpl = ambientFetch, now =
 						coverage: catalogCoverage({
 							groups: value.groups,
 							models: value.models,
-							modelGroups: pricing?.modelGroups
+							modelGroups: pricing?.modelGroups,
+							modelIds
 						})
 					};
 					lastGood.set(entry.id, {
@@ -1961,15 +1986,19 @@ function createKeyChooser({ ring, groups, onRotated, logger, waitMs = DEFAULT_GR
 * with an optional `reason` on a denial.
 *
 * - `deepseek-flash` gets the same request, addressed to the PackyCode route.
-* - `jev-latest`, TypeSafe's classifier, cannot write that object. The
+* - `jev-1.14.0`, TypeSafe's classifier, cannot write that object. The
 *   sections become a System One state with the official policy in it, Jev
 *   answers two typed questions, and the decision is written back as the
 *   official JSON object.
 *
 * @module dsh-packycode-api/auto-review
 */
-/** TypeSafe's decision model, reached through the `typesafe-officially` group. */
-const AUTO_REVIEW_JEV = "jev-latest";
+/**
+* TypeSafe's decision model, reached through the `typesafe-officially` group.
+* PackyCode publishes it under its exact version (the `jev-latest` alias was
+* retired), so this id moves with TypeSafe's releases.
+*/
+const AUTO_REVIEW_JEV = "jev-1.14.0";
 /** DeepSeek Flash on the PackyCode route. */
 const AUTO_REVIEW_FLASH = "deepseek-flash";
 /** Leave the official reviewer on the session's own model. */
@@ -1981,9 +2010,16 @@ const AUTO_REVIEW_MODELS = Object.freeze([
 	AUTO_REVIEW_SESSION
 ]);
 const DEFAULT_AUTO_REVIEW_MODEL = AUTO_REVIEW_JEV;
+/**
+* Reviewer values the settings once offered, mapped to what replaced them. A
+* saved preference still names them, so the Config keeps them as hidden
+* values (dropping them would fail the plugin's Config at load) and reading
+* the preference moves them to the successor.
+*/
+const RETIRED_AUTO_REVIEW_MODELS = Object.freeze({ "jev-latest": AUTO_REVIEW_JEV });
 /** Names for logs and the settings card; the card localizes the session choice. */
 const AUTO_REVIEW_MODEL_NAMES = Object.freeze({
-	[AUTO_REVIEW_JEV]: "jev-latest",
+	[AUTO_REVIEW_JEV]: AUTO_REVIEW_JEV,
 	[AUTO_REVIEW_FLASH]: "DeepSeek Flash",
 	[AUTO_REVIEW_SESSION]: "session model"
 });
@@ -2217,8 +2253,8 @@ function decideFromJev(body) {
 	const low = probability(shares?.low);
 	const medium = probability(shares?.medium);
 	const high = probability(shares?.high);
-	if (risk?.type !== "choice" || low === void 0 || medium === void 0 || high === void 0) throw new Error("PackyCode auto review: jev-latest returned no risk answer");
-	if (authorized === void 0) throw new Error("PackyCode auto review: jev-latest returned no authorization answer");
+	if (risk?.type !== "choice" || low === void 0 || medium === void 0 || high === void 0) throw new Error(`PackyCode auto review: ${AUTO_REVIEW_JEV} returned no risk answer`);
+	if (authorized === void 0) throw new Error(`PackyCode auto review: ${AUTO_REVIEW_JEV} returned no authorization answer`);
 	const allowProbability = low + medium * authorized;
 	const allowed = allowProbability >= .6 && high < .2;
 	const usage = record$4(body?.usage) && Number.isFinite(body.usage.input_tokens) ? {
@@ -2239,7 +2275,7 @@ function decideFromJev(body) {
 	return {
 		decision: "deny",
 		risk: blocking,
-		reason: blocking === "high" ? "jev-latest 判定为高风险操作（如外发凭据或敏感数据），需要你亲自决定" : "jev-latest 判定为中风险操作，且没有找到你对此操作的明确指示",
+		reason: blocking === "high" ? `${AUTO_REVIEW_JEV} 判定为高风险操作（如外发凭据或敏感数据），需要你亲自决定` : `${AUTO_REVIEW_JEV} 判定为中风险操作，且没有找到你对此操作的明确指示`,
 		...common
 	};
 }
@@ -2369,7 +2405,7 @@ function createJevReviewer({ ring, hosts, covers, onKeyFailure, fetchImpl = ambi
 			parsed = await response.json();
 		} catch (error) {
 			if (signal?.aborted === true) throw error;
-			throw new Error("PackyCode auto review got an unreadable answer from jev-latest", { cause: error });
+			throw new Error(`PackyCode auto review got an unreadable answer from ${AUTO_REVIEW_JEV}`, { cause: error });
 		}
 		if (record$4(parsed?.error)) return {
 			failure: mask$1(text$2(parsed.error.message) || JSON.stringify(parsed.error).slice(0, MAX_ERROR_DETAIL_CHARS$1), key),
@@ -2412,7 +2448,7 @@ function createJevReviewer({ ring, hosts, covers, onKeyFailure, fetchImpl = ambi
 			}
 			break;
 		}
-		if (uncovered) throw new Error(`PackyCode auto review: no stored API key's group covers jev-latest. Gateway said: ${lastFailure}`);
+		if (uncovered) throw new Error(`PackyCode auto review: no stored API key's group covers ${AUTO_REVIEW_JEV}. Gateway said: ${lastFailure}`);
 		throw new Error(`PackyCode auto review failed: ${lastFailure ?? "no detail"}`);
 	} });
 }
@@ -2522,7 +2558,7 @@ function connectSettings(settingsCtx, { ctx, Config, namespace, source, setSourc
 * request per tool call passes through DSH's `llm/stream` waterfall like
 * every model call; the listener recognizes it and answers it with the
 * reviewer chosen under Settings → PackyCode:
-* - `jev-latest`: over System One, written back as the official answer;
+* - `jev-1.14.0`: over System One, written back as the official answer;
 * - `deepseek-flash`: the same request, addressed to the PackyCode route;
 * - `session`: untouched, as without this plugin.
 * Every other request, conversation turns included, goes on unchanged. A
@@ -2535,9 +2571,10 @@ function connectSettings(settingsCtx, { ctx, Config, namespace, source, setSourc
 const DSH_AUTO_REVIEW_ROW = "auto-review";
 /** DSH's id of the 自动审查 permission preset. */
 const AUTO_PRESET = "auto";
-/** Normalize a stored preference; anything unknown reads as the default. */
+/** Normalize a stored preference; a retired reviewer reads as its successor, anything else unknown as the default. */
 function readAutoReviewChoice(value) {
-	const model = fieldValue(value?.autoReviewModel);
+	const saved = fieldValue(value?.autoReviewModel);
+	const model = Object.hasOwn(RETIRED_AUTO_REVIEW_MODELS, saved) ? RETIRED_AUTO_REVIEW_MODELS[saved] : saved;
 	return { model: AUTO_REVIEW_MODELS.includes(model) ? model : DEFAULT_AUTO_REVIEW_MODEL };
 }
 const errorText$1 = (error) => (error instanceof Error ? error.message : String(error)).slice(0, 300);
@@ -2595,7 +2632,7 @@ function createAutoReviewController({ jev, stream, readPreference, writePreferen
 			tool = sections.pendingAction.name;
 			const decision = await jev.review(options.system, sections, signal);
 			settle(decision.decision === "allow" ? "allowed" : "denied", {
-				model: "jev-latest",
+				model: AUTO_REVIEW_JEV,
 				tool,
 				ms: now() - started,
 				risk: decision.risk,
@@ -2609,7 +2646,7 @@ function createAutoReviewController({ jev, stream, readPreference, writePreferen
 			}
 			const message = errorText$1(error);
 			settle("failed", {
-				model: "jev-latest",
+				model: AUTO_REVIEW_JEV,
 				tool,
 				ms: now() - started,
 				error: message
@@ -3320,7 +3357,8 @@ const UPDATES_BETA = "thinking-display-updates-2026-08-18";
 const THINKING_DISPLAY = Object.freeze({
 	"claude-haiku-5-5": "omitted",
 	"claude-sonnet-5-5": "updates",
-	"claude-opus-5-5": "updates"
+	"claude-opus-5-5": "updates",
+	"claude-fable-5-2": "updates"
 });
 const IDENTITY = "You are Claude Code, Anthropic's official CLI for Claude, running within the Claude Agent SDK.";
 const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu;
@@ -6550,10 +6588,19 @@ const IMAGE_MODELS = Object.freeze({
 		"high",
 		"xhigh",
 		"max"
-	])
+	]),
+	"MiniMax-H3-Image": Object.freeze(["auto"]),
+	"MiniMax-H3-Image-Highspeed": Object.freeze(["auto"])
 });
 const IMAGE_MODEL_IDS = Object.freeze(Object.keys(IMAGE_MODELS));
 /**
+* MiniMax's H3 Image models take the Images API paths with their own fields
+* (platform.minimax.io/docs/api-reference/image-generation-h3-generations and
+* -h3-edits): no `quality`, `background` or `mask`, a JPEG link unless PNG and
+* `b64_json` are asked for, and 4K output unless a size is given.
+*/
+const isMiniMaxImageModel = (model) => typeof model === "string" && model.startsWith("MiniMax-H3-Image");
+/**
 * Engines the settings once offered, mapped to the ones that replaced them.
 * A saved setting still names them, so the Config schema keeps them as hidden
 * values (dropping them would fail the plugin's Config at load) and reading
@@ -6579,6 +6626,7 @@ function validateImageOptions({ model = DEFAULT_IMAGE_MODEL, quality = "auto", s
 		"transparent",
 		"opaque"
 	].includes(background)) throw new Error("PackyCode image background is not supported");
+	if (background === "transparent" && isMiniMaxImageModel(model)) throw new Error("PackyCode image transparent background is not supported by the selected model");
 	if (size !== "auto") {
 		const match = typeof size === "string" ? /^(\d{1,4})x(\d{1,4})$/u.exec(size) : null;
 		const width = Number(match?.[1]);
@@ -6607,7 +6655,7 @@ function readImagePreference(value = {}) {
 	};
 }
 /** No request is sent by a settings or credential mutation. */
-function createImageController({ ring, balance, readPreference, writePreference, isWritable }) {
+function createImageController({ ring, balance, groups, readPreference, writePreference, isWritable }) {
 	let mounted;
 	let disposeTool;
 	let generation = 0;
@@ -6639,6 +6687,7 @@ function createImageController({ ring, balance, readPreference, writePreference,
 		preference,
 		status,
 		invalidateBalance: () => balance?.invalidate(),
+		invalidateGroups: () => groups?.invalidate(),
 		async readBalance({ force = false, signal } = {}) {
 			if (balance === void 0) throw new Error("PackyCode image balance is unavailable in this runtime");
 			try {
@@ -6654,6 +6703,25 @@ function createImageController({ ring, balance, readPreference, writePreference,
 				throw new Error("PackyCode image balance could not be read");
 			}
 		},
+		/**
+		* Each image key's groups and the image engines they serve. Group names,
+		* their public descriptions and per-engine booleans only; no key material.
+		*/
+		async readGroups({ force = false, signal } = {}) {
+			if (groups === void 0) throw new Error("PackyCode image key groups are unavailable in this runtime");
+			try {
+				const [value, state] = await Promise.all([groups.read({
+					force,
+					signal
+				}), ring.list()]);
+				return {
+					...value,
+					activeId: state.activeId
+				};
+			} catch {
+				throw new Error("PackyCode image key groups could not be read");
+			}
+		},
 		reconcile,
 		mount(register) {
 			mounted = register;
@@ -6704,6 +6772,7 @@ function createImageController({ ring, balance, readPreference, writePreference,
 			if (!Object.hasOwn(operations, operation)) throw new Error("Unknown PackyCode image key operation");
 			await operations[operation]();
 			balance?.invalidate();
+			if (operation === "add" || operation === "remove") groups?.invalidate();
 			await reconcile();
 			return status();
 		}
@@ -6862,8 +6931,33 @@ function decodeImagePng(encoded, maximum = MAX_IMAGE_BYTES) {
 	pngDimensions(data);
 	return data;
 }
+/**
+* The fields each engine's Images API takes. GPT Image gets the validated
+* options as they are. MiniMax H3 Image has no `quality` or `background`,
+* answers with a JPEG link unless PNG and `b64_json` are asked for, and
+* renders 4K unless told otherwise, so `auto` carries the 2K `area` tier.
+*/
+function requestFields(options, prompt) {
+	if (!isMiniMaxImageModel(options.model)) return {
+		...options,
+		prompt,
+		n: 1,
+		output_format: "png"
+	};
+	return {
+		model: options.model,
+		prompt,
+		n: 1,
+		size: options.size,
+		...options.size === "auto" ? { area: "2K" } : {},
+		output_format: "png",
+		response_format: "b64_json"
+	};
+}
 function imageFailure(status, value) {
-	if (value?.error?.code === "moderation_blocked") return "PackyCode image request was blocked by the image safety check; revise the prompt or references";
+	const code = value?.error?.code;
+	if (code === "model_not_found") return "PackyCode image key is in a group that does not serve the selected image model. Do not retry with another model: tell the user to pick a model their key serves under Settings → PackyCode → Images, or to add an image key in a group that lists this one";
+	if (code === "moderation_blocked") return "PackyCode image request was blocked by the image safety check; revise the prompt or references";
 	if (status === 401 || status === 403) return "PackyCode image key was rejected; check the separate image key and its model permissions";
 	if (status === 429) return "PackyCode image quota or rate limit is unavailable; check the separate image key";
 	return `PackyCode image request failed (HTTP ${status}); check model, quality, and image key permissions`;
@@ -6876,6 +6970,7 @@ function createPackyCodeImageClient({ resolveKey, getHost, fetchImpl = ambientFe
 		if (prompt === void 0 || prompt.length > 32e3) throw new ImageRequestError("PackyCode image prompt must contain 1-32000 characters");
 		if (images !== void 0 && (!Array.isArray(images) || images.length === 0 || images.length > MAX_REFERENCE_IMAGES)) throw new ImageRequestError("PackyCode image edits require 1-16 reference images");
 		if (mask !== void 0 && images === void 0) throw new ImageRequestError("PackyCode image mask requires a reference image");
+		if (mask !== void 0 && isMiniMaxImageModel(options.model)) throw new ImageRequestError("PackyCode image masks are not supported by the selected model; omit maskImage or choose a GPT Image model");
 		const timeout = AbortSignal.timeout(timeoutMs);
 		const requestSignal = signal === void 0 ? timeout : AbortSignal.any([signal, timeout]);
 		let selected;
@@ -6887,12 +6982,7 @@ function createPackyCodeImageClient({ resolveKey, getHost, fetchImpl = ambientFe
 			throw new ImageRequestError("PackyCode image credentials could not be read");
 		}
 		if (typeof selected?.key !== "string" || selected.key === "") throw new ImageRequestError("PackyCode images need a separate image key; add one under Settings → PackyCode → Images");
-		const fields = {
-			...options,
-			prompt,
-			n: 1,
-			output_format: "png"
-		};
+		const fields = requestFields(options, prompt);
 		let body;
 		const headers = {
 			authorization: `Bearer ${selected.key}`,
@@ -7106,11 +7196,11 @@ function createPackyCodeImageTool({ client, attachments, getPreference, getSessi
 			quality: {
 				type: "string",
 				enum: ["settings", ...IMAGE_QUALITIES],
-				description: "Use settings (or omit) to follow the user image setting. auto is an explicit API quality, not a request to follow settings. xhigh and max require a 2.6 model; never downgrade automatically."
+				description: "Use settings (or omit) to follow the user image setting. auto is an explicit API quality, not a request to follow settings. xhigh and max require a GPT Image 2.6 model. MiniMax H3 Image takes no quality: leave it to settings or auto. Never downgrade automatically."
 			},
 			size: {
 				type: "string",
-				description: "auto or widthxheight, e.g. 1024x1024; both edges multiples of 16, each <=3840, ratio <=3:1, pixels 655360..8294400."
+				description: "auto or widthxheight, e.g. 1024x1024; both edges multiples of 16, each <=3840, ratio <=3:1, pixels 655360..8294400. On MiniMax H3 Image auto lets the model pick the shape at about 4 million pixels (2K); give a size to fix it, e.g. 2048x2048, 2720x1536 or 1536x2720."
 			},
 			background: {
 				type: "string",
@@ -7118,7 +7208,8 @@ function createPackyCodeImageTool({ client, attachments, getPreference, getSessi
 					"auto",
 					"opaque",
 					"transparent"
-				]
+				],
+				description: "transparent needs a GPT Image model; MiniMax H3 Image does not support it."
 			},
 			referenceImages: {
 				type: "array",
@@ -7127,7 +7218,7 @@ function createPackyCodeImageTool({ client, attachments, getPreference, getSessi
 			},
 			maskImage: {
 				oneOf: [{ type: "null" }, referenceSchema],
-				description: "Omit or use null for new images and ordinary reference-image edits, including refining a sketch. Only supply an actual PNG mask provided for masking, matching the first reference and under 4 MB; alpha=0 marks the area to edit. Do not copy an ordinary reference into this field or invent a mask."
+				description: "Omit or use null for new images and ordinary reference-image edits, including refining a sketch. Only supply an actual PNG mask provided for masking, matching the first reference and under 4 MB; alpha=0 marks the area to edit. Do not copy an ordinary reference into this field or invent a mask. MiniMax H3 Image does not support masks."
 			}
 		},
 		output: {
@@ -7164,10 +7255,12 @@ function createPackyCodeImageTool({ client, attachments, getPreference, getSessi
 			const repeatedNonPng = repeatedIndex >= 0 && images[repeatedIndex].mediaType !== "image/png";
 			const masks = maskImage === void 0 || repeatedNonPng ? void 0 : await readReferences([maskImage], attachments, messages, signal);
 			if (!getPreference().imageEnabled) throw new ImageRequestError("PackyCode images are disabled in settings");
+			const model = args.model === "settings" ? preference.imageModel : args.model ?? preference.imageModel;
+			const savedQuality = IMAGE_MODELS[model]?.length === 1 ? IMAGE_MODELS[model][0] : preference.imageQuality;
 			const result = await client.request({
 				...args,
-				model: args.model === "settings" ? preference.imageModel : args.model ?? preference.imageModel,
-				quality: args.quality === "settings" ? preference.imageQuality : args.quality ?? preference.imageQuality
+				model,
+				quality: args.quality === "settings" ? savedQuality : args.quality ?? savedQuality
 			}, {
 				signal,
 				images,
@@ -8418,6 +8511,7 @@ const TITLE_MODELS = Object.freeze({
 	"deepseek-v4-pro": "deepseek-flash",
 	"gpt-6-astra": "gpt-6.1-sol",
 	"gpt-5.6-sol": "gpt-6.1-sol",
+	"claude-fable-5-2": "claude-haiku-5-5",
 	"claude-opus-5-5": "claude-haiku-5-5",
 	"claude-sonnet-5-5": "claude-haiku-5-5"
 });
@@ -8745,6 +8839,7 @@ function createPackyCodeRpc({ ring, balance, groups, hosts, preference, claude,
 			balance.invalidate();
 			groups?.invalidate();
 			images?.invalidateBalance?.();
+			images?.invalidateGroups?.();
 			return status();
 		},
 		"claude-cli/status": (payload) => cli().status({ force: payload?.force === true }),
@@ -8775,6 +8870,10 @@ function createPackyCodeRpc({ ring, balance, groups, hosts, preference, claude,
 			force: payload?.force === true,
 			signal
 		}),
+		"images/groups": (payload, signal) => imageSupport().readGroups({
+			force: payload?.force === true,
+			signal
+		}),
 		"images/original": (payload, signal) => originals().info(payload, signal),
 		"images/original/chunk": (payload, signal) => originals().chunk(payload, signal),
 		"images/update": (payload) => imageSupport().update(payload),
@@ -9851,10 +9950,12 @@ const Config = z.object({
 	/** Path to the Claude Code CLI; empty means "the usual install places, then PATH". */
 	claudeCliPath: live(z.string().default("")),
 	/**
-	* Which model DSH's official 自动审查 reviews with: `jev-latest` or
-	* `deepseek-flash` through PackyCode, or `session` for its own default.
+	* Which model DSH's official 自动审查 reviews with: `jev-1.14.0` or
+	* `deepseek-flash` through PackyCode, or `session` for its own default. A
+	* retired reviewer value still parses as a hidden choice and reads as its
+	* successor, like a retired image engine.
 	*/
-	autoReviewModel: live(z.union([...AUTO_REVIEW_MODELS]).default(DEFAULT_AUTO_REVIEW_MODEL))
+	autoReviewModel: live(z.union([...AUTO_REVIEW_MODELS, ...Object.keys(RETIRED_AUTO_REVIEW_MODELS).map((id) => z.const(id).hidden())]).default(DEFAULT_AUTO_REVIEW_MODEL))
 });
 function apply(ctx, config) {
 	const ring = new PackyCodeKeyRing(ctx.credentials);
@@ -10121,9 +10222,16 @@ function apply(ctx, config) {
 		set: void 0
 	};
 	const dshHome = typeof process.env.DSH_HOME === "string" && process.env.DSH_HOME !== "" ? process.env.DSH_HOME : join(homedir(), ".dsh");
+	/** The image keys' groups, read when the settings card asks: an engine may be listed in `image` and not in `image-sale`. */
+	const imageGroups = createGroupReader({
+		listKeys: () => imageRing.secrets(),
+		getHosts: hosts,
+		modelIds: IMAGE_MODEL_IDS
+	});
 	const images = createImageController({
 		ring: imageRing,
 		balance: imageBalance,
+		groups: imageGroups,
 		readPreference: () => source() ?? {},
 		writePreference: (patch) => imagePreference.set(patch),
 		isWritable: () => imagePreference.writable === true && typeof imagePreference.set === "function"
@@ -10193,6 +10301,7 @@ function apply(ctx, config) {
 			balance.invalidate();
 			imageBalance.invalidate();
 			groups.invalidate();
+			imageGroups.invalidate();
 			modelSelection.reconcile();
 			images.reconcile().catch(() => void 0);
 			search.reconcile();
@@ -10298,4 +10407,4 @@ function apply(ctx, config) {
 	});
 }
 //#endregion
-export { AUTO_PRESET, AUTO_REVIEW_FLASH, AUTO_REVIEW_JEV, AUTO_REVIEW_MODELS, AUTO_REVIEW_MODEL_NAMES, AUTO_REVIEW_SESSION, AUTO_REVIEW_TIMEOUT_MS, CHANNEL, CLAUDE_INSTALL_COMMAND, CLAUDE_MIN_VERSION, CLAUDE_MISSING_MESSAGE, CLAUDE_NPM_LATEST_URL, CLAUDE_NPM_PACKAGE, CLAUDE_NPM_UPDATE_COMMAND, CLAUDE_PERMISSION_MODES, CLAUDE_SELF_UPDATE_COMMAND, CLI_ONLY_GROUPS, CLI_PROJECT_DIR_NAME, CLI_SESSION_IDLE_MS, Config, DEFAULT_API_HOST, DEFAULT_AUTO_REVIEW_MODEL, DEFAULT_CLAUDE_CONFIG_DIR, DEFAULT_IMAGE_MODEL, DEFAULT_SEARCH_BACKEND, DEFAULT_STATUS_HOST, DIAGNOSTICS_FORMAT, DIAGNOSTICS_LIMITS, DISPLAY_NAME, DSH_AUTO_REVIEW_ROW, HTTP_CLAUDE_GROUPS, IMAGE_MODELS, IMAGE_MODEL_IDS, IMAGE_QUALITIES, IMAGE_TIMEOUT_MS, IMAGE_TOOL_NAME, JEV_ALLOW_THRESHOLD, JEV_HIGH_RISK_LIMIT, JEV_LIMITS, JEV_QUESTIONS, LEGACY_STATUS_HOSTS, MAX_IMAGE_BYTES, MAX_LIVE_CLI_SESSIONS, MIRROR_TOOL, PACKYCODE_AUTO_SEARCH_PROVIDER_ID, PACKYCODE_CLASSIFIER_MODELS, PACKYCODE_COVERED_MODEL_IDS, PACKYCODE_MODELS, PACKYCODE_MODEL_IDS, PACKYCODE_SEARCH_PROVIDER_ID, PLAN_TOOL, PLUGIN_ID, PROVIDER, PackyCodeKeyRing, RETIRED_IMAGE_MODELS, SEARCH_BACKENDS, SEARCH_BACKEND_MODELS, SEARCH_MODES, SETTINGS_NAMESPACE, TEST_MESSAGE_POLICY_CODE, answerChunks, answersFor, apply, approvalReason, assertApiKey, baseUrlOf, buildCliArgs, buildCliEnvironment, buildSearchRequest, buildTranscript, catalogCoverage, classifyCliOutdated, classifyCliUnavailable, classifyClientPolicy, classifyGatewayFailure, classifyTestMessagePolicy, classifyUpstreamServerError, claudeBinaryCandidates, claudePermissionMode, claudeTransportFor, cliErrorMessage, compactionSummary, createAutoReviewController, createBalanceReader, createClaudeAgentBridge, createClaudeCliManager, createClaudeCliTransport, createClaudeLatestReader, createClaudeToolNames, createDiagnostics, createGroupReader, createImageController, createJevReviewer, createKeyChooser, createModelSelectionController, createPackyCodeAutoSearchProvider, createPackyCodeImageClient, createPackyCodeImageTool, createPackyCodeProfile, createPackyCodeProvider, createPackyCodeRpc, createPackyCodeSearchProvider, createProfileSearchComposition, createRouteAdapter, createSearchComposition, createSearchController, decideFromJev, decodeImagePng, describeRequest, dshSystemText, explainCliClientPolicyFailure, explainCliOutdated, explainCliUnavailable, explainClientPolicyFailure, explainNpmFailure, explainTestMessagePolicyFailure, failureChunk, guardKeyRotation, inject, isClaudeCliOutdated, isNpmClaudeInstall, isOfficialReviewRequest, jevState, locateClaudeBinary, locateNpm, messageFingerprint, name, normalizeFailureMessage, normalizeHost, officialAnswer, orderKeysFor, parseClaudeVersion, parseMessagesSearchResponse, parsePricing, parseResponsesSearchResponse, parseSelectedGroups, parseTokenUsage, pickKeyForModel, planAnswer, planContinuation, pngDimensions, presentClaudeCall, presentClaudeResult, questionPrompt, questionsFor, readAutoReviewChoice, readHiddenModels, readImagePreference, readReviewSections, readSearchChoice, refusalMessage, resolveSpawnCommand, responseFingerprint, sessionUuid, splitAtLastAnswer, startClaudeCliSession, statusHostOrder, summarizeSessionEvents, textResponse, titlePrompt, toCliHistory, toolResultText, validateImageOptions };
+export { AUTO_PRESET, AUTO_REVIEW_FLASH, AUTO_REVIEW_JEV, AUTO_REVIEW_MODELS, AUTO_REVIEW_MODEL_NAMES, AUTO_REVIEW_SESSION, AUTO_REVIEW_TIMEOUT_MS, CHANNEL, CLAUDE_INSTALL_COMMAND, CLAUDE_MIN_VERSION, CLAUDE_MISSING_MESSAGE, CLAUDE_NPM_LATEST_URL, CLAUDE_NPM_PACKAGE, CLAUDE_NPM_UPDATE_COMMAND, CLAUDE_PERMISSION_MODES, CLAUDE_SELF_UPDATE_COMMAND, CLI_ONLY_GROUPS, CLI_PROJECT_DIR_NAME, CLI_SESSION_IDLE_MS, Config, DEFAULT_API_HOST, DEFAULT_AUTO_REVIEW_MODEL, DEFAULT_CLAUDE_CONFIG_DIR, DEFAULT_IMAGE_MODEL, DEFAULT_SEARCH_BACKEND, DEFAULT_STATUS_HOST, DIAGNOSTICS_FORMAT, DIAGNOSTICS_LIMITS, DISPLAY_NAME, DSH_AUTO_REVIEW_ROW, HTTP_CLAUDE_GROUPS, IMAGE_MODELS, IMAGE_MODEL_IDS, IMAGE_QUALITIES, IMAGE_TIMEOUT_MS, IMAGE_TOOL_NAME, JEV_ALLOW_THRESHOLD, JEV_HIGH_RISK_LIMIT, JEV_LIMITS, JEV_QUESTIONS, LEGACY_STATUS_HOSTS, MAX_IMAGE_BYTES, MAX_LIVE_CLI_SESSIONS, MIRROR_TOOL, PACKYCODE_AUTO_SEARCH_PROVIDER_ID, PACKYCODE_CLASSIFIER_MODELS, PACKYCODE_COVERED_MODEL_IDS, PACKYCODE_MODELS, PACKYCODE_MODEL_IDS, PACKYCODE_SEARCH_PROVIDER_ID, PLAN_TOOL, PLUGIN_ID, PROVIDER, PackyCodeKeyRing, RETIRED_AUTO_REVIEW_MODELS, RETIRED_IMAGE_MODELS, SEARCH_BACKENDS, SEARCH_BACKEND_MODELS, SEARCH_MODES, SETTINGS_NAMESPACE, TEST_MESSAGE_POLICY_CODE, answerChunks, answersFor, apply, approvalReason, assertApiKey, baseUrlOf, buildCliArgs, buildCliEnvironment, buildSearchRequest, buildTranscript, catalogCoverage, classifyCliOutdated, classifyCliUnavailable, classifyClientPolicy, classifyGatewayFailure, classifyTestMessagePolicy, classifyUpstreamServerError, claudeBinaryCandidates, claudePermissionMode, claudeTransportFor, cliErrorMessage, compactionSummary, createAutoReviewController, createBalanceReader, createClaudeAgentBridge, createClaudeCliManager, createClaudeCliTransport, createClaudeLatestReader, createClaudeToolNames, createDiagnostics, createGroupReader, createImageController, createJevReviewer, createKeyChooser, createModelSelectionController, createPackyCodeAutoSearchProvider, createPackyCodeImageClient, createPackyCodeImageTool, createPackyCodeProfile, createPackyCodeProvider, createPackyCodeRpc, createPackyCodeSearchProvider, createProfileSearchComposition, createRouteAdapter, createSearchComposition, createSearchController, decideFromJev, decodeImagePng, describeRequest, dshSystemText, explainCliClientPolicyFailure, explainCliOutdated, explainCliUnavailable, explainClientPolicyFailure, explainNpmFailure, explainTestMessagePolicyFailure, failureChunk, guardKeyRotation, inject, isClaudeCliOutdated, isNpmClaudeInstall, isOfficialReviewRequest, jevState, locateClaudeBinary, locateNpm, messageFingerprint, name, normalizeFailureMessage, normalizeHost, officialAnswer, orderKeysFor, parseClaudeVersion, parseMessagesSearchResponse, parsePricing, parseResponsesSearchResponse, parseSelectedGroups, parseTokenUsage, pickKeyForModel, planAnswer, planContinuation, pngDimensions, presentClaudeCall, presentClaudeResult, questionPrompt, questionsFor, readAutoReviewChoice, readHiddenModels, readImagePreference, readReviewSections, readSearchChoice, refusalMessage, resolveSpawnCommand, responseFingerprint, sessionUuid, splitAtLastAnswer, startClaudeCliSession, statusHostOrder, summarizeSessionEvents, textResponse, titlePrompt, toCliHistory, toolResultText, validateImageOptions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-packycode-api",
-  "version": "1.4.7",
+  "version": "1.4.9",
   "description": "Use PackyCode API keys in DeepSeek Harness with multi-protocol models, image generation and editing, separate key rings, and balance display",
   "type": "module",
   "main": "./lib/index.js",