@pixelzx/genesis 2026.6.29 → 2026.7.8

package/dist/runner-Vhfg_kYp.js

@@ -1,966 +0,0 @@
-import { a as normalizeLowercaseStringOrEmpty, c as normalizeOptionalString } from "./string-coerce-DPP_aYVc.js";
-import { n as isAbortError } from "./unhandled-rejections-6YZQMno-.js";
-import { a as shouldLogVerbose, r as logVerbose } from "./globals-wYf9_gv5.js";
-import { a as logWarn } from "./logger-BbnBrdB_.js";
-import { i as runExec } from "./exec-BbrLAvgI.js";
-import { n as findNormalizedProviderValue } from "./provider-id--dmcBtHB.js";
-import { n as resolveAgentModelPrimaryValue, t as resolveAgentModelFallbackValues } from "./model-input-gXkzehoL.js";
-import { r as mergeInboundPathRoots, t as isInboundPathAllowed } from "./inbound-path-policy-D6PFsYGw.js";
-import { a as modelSupportsVision, n as findModelInCatalog, r as loadModelCatalog } from "./model-catalog-bbYPQYGY.js";
-import { a as isAudioFileName, r as getFileExtension, s as kindFromMime, t as detectMime } from "./mime-uYFJ8ocK.js";
-import { a as hasAvailableAuthForProvider } from "./model-auth-JYw3Q_E3.js";
-import { r as fetchWithTimeout } from "./fetch-timeout-DjhWl8zC.js";
-import { a as safeFileURLToPath, t as assertNoWindowsNetworkPath } from "./local-file-access-DEO41UGf.js";
-import { a as getDefaultMediaLocalRoots } from "./local-roots-BfA76lH8.js";
-import { n as fetchRemoteMedia, t as MediaFetchError } from "./fetch-C_QfeqLM.js";
-import { i as normalizeMediaProviderId } from "./entry-capabilities-BN9rCzJC.js";
-import { C as buildMediaUnderstandingRegistry, S as providerSupportsCapability, b as resolveAutoMediaKeyProviders, i as resolveModelEntries, o as resolveScopeDecision, w as getMediaUnderstandingProvider, x as resolveDefaultMediaModel } from "./resolve-DxTN302S.js";
-import { t as resolveChannelInboundAttachmentRoots } from "./channel-inbound-roots-CIbWmXVp.js";
-import { t as buildRandomTempFilePath } from "./temp-download-T22w6HcQ.js";
-import { _ as fileExists, a as runCliEntry, g as extractGeminiResponse, o as runProviderEntry, r as formatDecisionSummary, t as buildModelDecision, v as MediaUnderstandingSkipError, y as isMediaUnderstandingSkipError } from "./runner.entries-DWptWo_Q.js";
-import "./shared-CfvUPtvc.js";
-import { constants } from "node:fs";
-import path from "node:path";
-import os from "node:os";
-import fs$1 from "node:fs/promises";
-//#region src/media-understanding/attachments.normalize.ts
-function normalizeAttachmentPath(raw) {
-	const value = normalizeOptionalString(raw);
-	if (!value) return;
-	if (value.startsWith("file://")) try {
-		return safeFileURLToPath(value);
-	} catch {
-		return;
-	}
-	try {
-		assertNoWindowsNetworkPath(value, "Attachment path");
-	} catch {
-		return;
-	}
-	return value;
-}
-function normalizeAttachments(ctx) {
-	const pathsFromArray = Array.isArray(ctx.MediaPaths) ? ctx.MediaPaths : void 0;
-	const urlsFromArray = Array.isArray(ctx.MediaUrls) ? ctx.MediaUrls : void 0;
-	const typesFromArray = Array.isArray(ctx.MediaTypes) ? ctx.MediaTypes : void 0;
-	const resolveMime = (count, index) => {
-		const typeHint = normalizeOptionalString(typesFromArray?.[index]);
-		if (typeHint) return typeHint;
-		return count === 1 ? ctx.MediaType : void 0;
-	};
-	if (pathsFromArray && pathsFromArray.length > 0) {
-		const count = pathsFromArray.length;
-		const urls = urlsFromArray && urlsFromArray.length > 0 ? urlsFromArray : void 0;
-		return pathsFromArray.map((value, index) => ({
-			path: normalizeOptionalString(value),
-			url: urls?.[index] ?? ctx.MediaUrl,
-			mime: resolveMime(count, index),
-			index
-		})).filter((entry) => Boolean(entry.path ?? normalizeOptionalString(entry.url)));
-	}
-	if (urlsFromArray && urlsFromArray.length > 0) {
-		const count = urlsFromArray.length;
-		return urlsFromArray.map((value, index) => ({
-			path: void 0,
-			url: normalizeOptionalString(value),
-			mime: resolveMime(count, index),
-			index
-		})).filter((entry) => Boolean(entry.url));
-	}
-	const pathValue = normalizeOptionalString(ctx.MediaPath);
-	const url = normalizeOptionalString(ctx.MediaUrl);
-	if (!pathValue && !url) return [];
-	return [{
-		path: pathValue || void 0,
-		url: url || void 0,
-		mime: ctx.MediaType,
-		index: 0
-	}];
-}
-function resolveAttachmentKind(attachment) {
-	const kind = kindFromMime(attachment.mime);
-	if (kind === "image" || kind === "audio" || kind === "video") return kind;
-	const ext = getFileExtension(attachment.path ?? attachment.url);
-	if (!ext) return "unknown";
-	if ([
-		".mp4",
-		".mov",
-		".mkv",
-		".webm",
-		".avi",
-		".m4v"
-	].includes(ext)) return "video";
-	if (isAudioFileName(attachment.path ?? attachment.url)) return "audio";
-	if ([
-		".png",
-		".jpg",
-		".jpeg",
-		".webp",
-		".gif",
-		".bmp",
-		".tiff",
-		".tif"
-	].includes(ext)) return "image";
-	return "unknown";
-}
-function isVideoAttachment(attachment) {
-	return resolveAttachmentKind(attachment) === "video";
-}
-function isAudioAttachment(attachment) {
-	return resolveAttachmentKind(attachment) === "audio";
-}
-function isImageAttachment(attachment) {
-	return resolveAttachmentKind(attachment) === "image";
-}
-//#endregion
-//#region src/media-understanding/attachments.select.ts
-const DEFAULT_MAX_ATTACHMENTS = 1;
-function orderAttachments(attachments, prefer) {
-	const list = Array.isArray(attachments) ? attachments.filter(isAttachmentRecord) : [];
-	if (!prefer || prefer === "first") return list;
-	if (prefer === "last") return [...list].toReversed();
-	if (prefer === "path") {
-		const withPath = list.filter((item) => item.path);
-		const withoutPath = list.filter((item) => !item.path);
-		return [...withPath, ...withoutPath];
-	}
-	if (prefer === "url") {
-		const withUrl = list.filter((item) => item.url);
-		const withoutUrl = list.filter((item) => !item.url);
-		return [...withUrl, ...withoutUrl];
-	}
-	return list;
-}
-function isAttachmentRecord(value) {
-	if (!value || typeof value !== "object") return false;
-	const entry = value;
-	if (typeof entry.index !== "number") return false;
-	if (entry.path !== void 0 && typeof entry.path !== "string") return false;
-	if (entry.url !== void 0 && typeof entry.url !== "string") return false;
-	if (entry.mime !== void 0 && typeof entry.mime !== "string") return false;
-	if (entry.alreadyTranscribed !== void 0 && typeof entry.alreadyTranscribed !== "boolean") return false;
-	return true;
-}
-function selectAttachments(params) {
-	const { capability, attachments, policy } = params;
-	const matches = (Array.isArray(attachments) ? attachments.filter(isAttachmentRecord) : []).filter((item) => {
-		if (capability === "audio" && item.alreadyTranscribed) return false;
-		if (capability === "image") return isImageAttachment(item);
-		if (capability === "audio") return isAudioAttachment(item);
-		return isVideoAttachment(item);
-	});
-	if (matches.length === 0) return [];
-	const ordered = orderAttachments(matches, policy?.prefer);
-	const mode = policy?.mode ?? "first";
-	const maxAttachments = policy?.maxAttachments ?? DEFAULT_MAX_ATTACHMENTS;
-	if (mode === "all") return ordered.slice(0, Math.max(1, maxAttachments));
-	return ordered.slice(0, 1);
-}
-//#endregion
-//#region src/media-understanding/attachments.cache.ts
-let defaultLocalPathRoots;
-function getDefaultLocalPathRoots() {
-	defaultLocalPathRoots ??= mergeInboundPathRoots(getDefaultMediaLocalRoots());
-	return defaultLocalPathRoots;
-}
-function resolveRequestUrl(input) {
-	if (typeof input === "string") return input;
-	if (input instanceof URL) return input.toString();
-	return input.url;
-}
-var MediaAttachmentCache = class {
-	constructor(attachments, options) {
-		this.entries = /* @__PURE__ */ new Map();
-		this.attachments = attachments;
-		this.ssrfPolicy = options?.ssrfPolicy;
-		this.localPathRoots = options?.includeDefaultLocalPathRoots === false ? mergeInboundPathRoots(options.localPathRoots) : mergeInboundPathRoots(options?.localPathRoots, getDefaultLocalPathRoots());
-		for (const attachment of attachments) this.entries.set(attachment.index, { attachment });
-	}
-	async getBuffer(params) {
-		const entry = await this.ensureEntry(params.attachmentIndex);
-		const url = entry.attachment.url?.trim();
-		if (entry.buffer) {
-			if (entry.buffer.length > params.maxBytes) throw new MediaUnderstandingSkipError("maxBytes", `Attachment ${params.attachmentIndex + 1} exceeds maxBytes ${params.maxBytes}`);
-			return {
-				buffer: entry.buffer,
-				mime: entry.bufferMime,
-				fileName: entry.bufferFileName ?? `media-${params.attachmentIndex + 1}`,
-				size: entry.buffer.length
-			};
-		}
-		if (entry.resolvedPath) try {
-			const size = await this.ensureLocalStat(entry);
-			if (entry.resolvedPath) {
-				if (size !== void 0 && size > params.maxBytes) throw new MediaUnderstandingSkipError("maxBytes", `Attachment ${params.attachmentIndex + 1} exceeds maxBytes ${params.maxBytes}`);
-				const { buffer, filePath } = await this.readLocalBuffer({
-					attachmentIndex: params.attachmentIndex,
-					filePath: entry.resolvedPath,
-					maxBytes: params.maxBytes
-				});
-				entry.resolvedPath = filePath;
-				entry.buffer = buffer;
-				entry.bufferMime = entry.bufferMime ?? entry.attachment.mime ?? await detectMime({
-					buffer,
-					filePath
-				});
-				entry.bufferFileName = path.basename(filePath) || `media-${params.attachmentIndex + 1}`;
-				return {
-					buffer,
-					mime: entry.bufferMime,
-					fileName: entry.bufferFileName,
-					size: buffer.length
-				};
-			}
-		} catch (err) {
-			if (!(err instanceof MediaUnderstandingSkipError) || !url || err.reason !== "blocked" && err.reason !== "empty") throw err;
-		}
-		if (!url) throw new MediaUnderstandingSkipError("empty", `Attachment ${params.attachmentIndex + 1} has no path or URL.`);
-		try {
-			const fetchImpl = (input, init) => fetchWithTimeout(resolveRequestUrl(input), init ?? {}, params.timeoutMs, globalThis.fetch);
-			const fetched = await fetchRemoteMedia({
-				url,
-				fetchImpl,
-				maxBytes: params.maxBytes,
-				ssrfPolicy: this.ssrfPolicy
-			});
-			entry.buffer = fetched.buffer;
-			entry.bufferMime = entry.attachment.mime ?? fetched.contentType ?? await detectMime({
-				buffer: fetched.buffer,
-				filePath: fetched.fileName ?? url
-			});
-			entry.bufferFileName = fetched.fileName ?? `media-${params.attachmentIndex + 1}`;
-			return {
-				buffer: fetched.buffer,
-				mime: entry.bufferMime,
-				fileName: entry.bufferFileName,
-				size: fetched.buffer.length
-			};
-		} catch (err) {
-			if (err instanceof MediaFetchError && err.code === "max_bytes") throw new MediaUnderstandingSkipError("maxBytes", `Attachment ${params.attachmentIndex + 1} exceeds maxBytes ${params.maxBytes}`);
-			if (isAbortError(err)) throw new MediaUnderstandingSkipError("timeout", `Attachment ${params.attachmentIndex + 1} timed out while fetching.`);
-			throw err;
-		}
-	}
-	async getPath(params) {
-		const entry = await this.ensureEntry(params.attachmentIndex);
-		if (entry.resolvedPath) {
-			if (params.maxBytes) try {
-				const size = await this.ensureLocalStat(entry);
-				if (entry.resolvedPath) {
-					if (size !== void 0 && size > params.maxBytes) throw new MediaUnderstandingSkipError("maxBytes", `Attachment ${params.attachmentIndex + 1} exceeds maxBytes ${params.maxBytes}`);
-				}
-			} catch (err) {
-				if (!(err instanceof MediaUnderstandingSkipError) || err.reason !== "blocked" && err.reason !== "empty") throw err;
-			}
-			if (entry.resolvedPath) return { path: entry.resolvedPath };
-		}
-		if (entry.tempPath) {
-			if (params.maxBytes && entry.buffer && entry.buffer.length > params.maxBytes) throw new MediaUnderstandingSkipError("maxBytes", `Attachment ${params.attachmentIndex + 1} exceeds maxBytes ${params.maxBytes}`);
-			return {
-				path: entry.tempPath,
-				cleanup: entry.tempCleanup
-			};
-		}
-		const maxBytes = params.maxBytes ?? Number.POSITIVE_INFINITY;
-		const bufferResult = await this.getBuffer({
-			attachmentIndex: params.attachmentIndex,
-			maxBytes,
-			timeoutMs: params.timeoutMs
-		});
-		const tmpPath = buildRandomTempFilePath({
-			prefix: "genesis-media",
-			extension: path.extname(bufferResult.fileName || "") || ""
-		});
-		await fs$1.writeFile(tmpPath, bufferResult.buffer);
-		entry.tempPath = tmpPath;
-		entry.tempCleanup = async () => {
-			await fs$1.unlink(tmpPath).catch(() => {});
-		};
-		return {
-			path: tmpPath,
-			cleanup: entry.tempCleanup
-		};
-	}
-	async cleanup() {
-		const cleanups = [];
-		for (const entry of this.entries.values()) if (entry.tempCleanup) {
-			cleanups.push(entry.tempCleanup());
-			entry.tempCleanup = void 0;
-		}
-		await Promise.all(cleanups);
-	}
-	async ensureEntry(attachmentIndex) {
-		const existing = this.entries.get(attachmentIndex);
-		if (existing) {
-			if (!existing.resolvedPath) existing.resolvedPath = this.resolveLocalPath(existing.attachment);
-			return existing;
-		}
-		const attachment = this.attachments.find((item) => item.index === attachmentIndex) ?? { index: attachmentIndex };
-		const entry = {
-			attachment,
-			resolvedPath: this.resolveLocalPath(attachment)
-		};
-		this.entries.set(attachmentIndex, entry);
-		return entry;
-	}
-	resolveLocalPath(attachment) {
-		const rawPath = normalizeAttachmentPath(attachment.path);
-		if (!rawPath) return;
-		return path.isAbsolute(rawPath) ? rawPath : path.resolve(rawPath);
-	}
-	async ensureLocalStat(entry) {
-		if (!entry.resolvedPath) return;
-		if (!isInboundPathAllowed({
-			filePath: entry.resolvedPath,
-			roots: this.localPathRoots
-		})) {
-			entry.resolvedPath = void 0;
-			if (shouldLogVerbose()) logVerbose(`Blocked attachment path outside allowed roots: ${entry.attachment.path ?? entry.attachment.url ?? "(unknown)"}`);
-			throw new MediaUnderstandingSkipError("blocked", `Attachment ${entry.attachment.index + 1} path is outside allowed roots.`);
-		}
-		if (entry.statSize !== void 0) return entry.statSize;
-		try {
-			const currentPath = entry.resolvedPath;
-			const stat = await fs$1.stat(currentPath);
-			if (!stat.isFile()) {
-				entry.resolvedPath = void 0;
-				throw new MediaUnderstandingSkipError("empty", `Attachment ${entry.attachment.index + 1} path is not a regular file.`);
-			}
-			const canonicalPath = await this.resolveCanonicalLocalPath(currentPath);
-			if (!canonicalPath) {
-				entry.resolvedPath = void 0;
-				throw new MediaUnderstandingSkipError("blocked", `Attachment ${entry.attachment.index + 1} could not be canonicalized.`);
-			}
-			if (!isInboundPathAllowed({
-				filePath: canonicalPath,
-				roots: await this.getCanonicalLocalPathRoots()
-			})) {
-				entry.resolvedPath = void 0;
-				if (shouldLogVerbose()) logVerbose(`Blocked canonicalized attachment path outside allowed roots: ${canonicalPath}`);
-				throw new MediaUnderstandingSkipError("blocked", `Attachment ${entry.attachment.index + 1} path is outside allowed roots.`);
-			}
-			entry.resolvedPath = canonicalPath;
-			entry.statSize = stat.size;
-			return stat.size;
-		} catch (err) {
-			if (err instanceof MediaUnderstandingSkipError) throw err;
-			entry.resolvedPath = void 0;
-			if (shouldLogVerbose()) logVerbose(`Failed to read attachment ${entry.attachment.index + 1}: ${String(err)}`);
-			return;
-		}
-	}
-	async getCanonicalLocalPathRoots() {
-		if (this.canonicalLocalPathRoots) return await this.canonicalLocalPathRoots;
-		this.canonicalLocalPathRoots = (async () => mergeInboundPathRoots(this.localPathRoots, await Promise.all(this.localPathRoots.map(async (root) => {
-			if (root.includes("*")) return root;
-			return await fs$1.realpath(root).catch(() => root);
-		}))))();
-		return await this.canonicalLocalPathRoots;
-	}
-	async readLocalBuffer(params) {
-		const flags = constants.O_RDONLY | (process.platform === "win32" ? 0 : constants.O_NOFOLLOW);
-		const handle = await fs$1.open(params.filePath, flags);
-		try {
-			if (!(await handle.stat()).isFile()) throw new MediaUnderstandingSkipError("empty", `Attachment ${params.attachmentIndex + 1} path is not a regular file.`);
-			const canonicalPath = await this.resolveCanonicalLocalPath(params.filePath);
-			if (!canonicalPath) throw new MediaUnderstandingSkipError("blocked", `Attachment ${params.attachmentIndex + 1} could not be canonicalized.`);
-			if (!isInboundPathAllowed({
-				filePath: canonicalPath,
-				roots: await this.getCanonicalLocalPathRoots()
-			})) throw new MediaUnderstandingSkipError("blocked", `Attachment ${params.attachmentIndex + 1} path is outside allowed roots.`);
-			const buffer = await handle.readFile();
-			if (buffer.length > params.maxBytes) throw new MediaUnderstandingSkipError("maxBytes", `Attachment ${params.attachmentIndex + 1} exceeds maxBytes ${params.maxBytes}`);
-			return {
-				buffer,
-				filePath: canonicalPath
-			};
-		} finally {
-			await handle.close().catch(() => {});
-		}
-	}
-	async resolveCanonicalLocalPath(filePath) {
-		try {
-			return await fs$1.realpath(filePath);
-		} catch (err) {
-			if (shouldLogVerbose()) logVerbose(`Blocked attachment path when canonicalization failed: ${filePath} (${String(err)})`);
-			return;
-		}
-	}
-};
-//#endregion
-//#region src/media-understanding/runner.attachments.ts
-function normalizeMediaAttachments(ctx) {
-	return normalizeAttachments(ctx);
-}
-function createMediaAttachmentCache(attachments, options) {
-	return new MediaAttachmentCache(attachments, options);
-}
-//#endregion
-//#region src/media-understanding/runner.ts
-function resolveConfiguredKeyProviderOrder(params) {
-	const configuredProviders = Object.keys(params.cfg.models?.providers ?? {}).map((providerId) => normalizeMediaProviderId(providerId)).filter(Boolean).filter((providerId, index, values) => values.indexOf(providerId) === index).filter((providerId) => providerSupportsCapability(params.providerRegistry.get(providerId), params.capability));
-	return [...new Set([...configuredProviders, ...params.fallbackProviders])];
-}
-function resolveConfiguredImageModelId(params) {
-	return resolveConfiguredImageModel(params)?.id?.trim() || void 0;
-}
-function resolveConfiguredImageModel(params) {
-	return findNormalizedProviderValue(params.cfg.models?.providers, params.providerId)?.models?.find((entry) => {
-		const id = entry?.id?.trim();
-		return Boolean(id) && entry?.input?.includes("image");
-	});
-}
-function resolveCatalogImageModelId(params) {
-	const matches = params.catalog.filter((entry) => normalizeMediaProviderId(entry.provider) === params.providerId && modelSupportsVision(entry));
-	if (matches.length === 0) return;
-	return normalizeOptionalString((matches.find((entry) => normalizeLowercaseStringOrEmpty(entry.id) === "auto") ?? matches[0])?.id);
-}
-async function explicitImageModelVisionStatus(params) {
-	const configured = resolveConfiguredImageModel(params);
-	if (configured?.id?.trim() === params.model && configured.input?.includes("image")) return "supported";
-	const entry = findModelInCatalog(await loadModelCatalog({ config: params.cfg }), params.providerId, params.model);
-	if (!entry) return "unknown";
-	return modelSupportsVision(entry) ? "supported" : "unsupported";
-}
-async function resolveAutoImageModelId(params) {
-	const explicit = normalizeOptionalString(params.explicitModel);
-	if (explicit) {
-		if (await explicitImageModelVisionStatus({
-			cfg: params.cfg,
-			providerId: params.providerId,
-			model: explicit
-		}) !== "unsupported") return explicit;
-	}
-	const configuredModel = resolveConfiguredImageModelId(params);
-	if (configuredModel) return configuredModel;
-	const defaultModel = resolveDefaultMediaModel({
-		cfg: params.cfg,
-		providerId: params.providerId,
-		capability: "image"
-	});
-	if (defaultModel) return defaultModel;
-	const catalog = await loadModelCatalog({ config: params.cfg });
-	return resolveCatalogImageModelId({
-		providerId: params.providerId,
-		catalog
-	});
-}
-function buildProviderRegistry(overrides, cfg) {
-	return buildMediaUnderstandingRegistry(overrides, cfg);
-}
-function resolveMediaAttachmentLocalRoots(params) {
-	return mergeInboundPathRoots(getDefaultMediaLocalRoots(), resolveChannelInboundAttachmentRoots(params));
-}
-const binaryCache = /* @__PURE__ */ new Map();
-const geminiProbeCache = /* @__PURE__ */ new Map();
-function clearMediaUnderstandingBinaryCacheForTests() {
-	binaryCache.clear();
-	geminiProbeCache.clear();
-}
-function expandHomeDir(value) {
-	if (!value.startsWith("~")) return value;
-	const home = os.homedir();
-	if (value === "~") return home;
-	if (value.startsWith("~/")) return path.join(home, value.slice(2));
-	return value;
-}
-function hasPathSeparator(value) {
-	return value.includes("/") || value.includes("\\");
-}
-function candidateBinaryNames(name) {
-	if (process.platform !== "win32") return [name];
-	if (path.extname(name)) return [name];
-	const pathext = (process.env.PATHEXT ?? ".EXE;.CMD;.BAT;.COM").split(";").map((item) => item.trim()).filter(Boolean).map((item) => item.startsWith(".") ? item : `.${item}`);
-	return [name, ...Array.from(new Set(pathext)).map((item) => `${name}${item}`)];
-}
-async function isExecutable(filePath) {
-	try {
-		if (!(await fs$1.stat(filePath)).isFile()) return false;
-		if (process.platform === "win32") return true;
-		await fs$1.access(filePath, constants.X_OK);
-		return true;
-	} catch {
-		return false;
-	}
-}
-async function findBinary(name) {
-	const cached = binaryCache.get(name);
-	if (cached) return cached;
-	const resolved = (async () => {
-		const direct = expandHomeDir(name.trim());
-		if (direct && hasPathSeparator(direct)) {
-			for (const candidate of candidateBinaryNames(direct)) if (await isExecutable(candidate)) return candidate;
-		}
-		const searchName = name.trim();
-		if (!searchName) return null;
-		const pathEntries = (process.env.PATH ?? "").split(path.delimiter);
-		const candidates = candidateBinaryNames(searchName);
-		for (const entryRaw of pathEntries) {
-			const entry = expandHomeDir(entryRaw.trim().replace(/^"(.*)"$/, "$1"));
-			if (!entry) continue;
-			for (const candidate of candidates) {
-				const fullPath = path.join(entry, candidate);
-				if (await isExecutable(fullPath)) return fullPath;
-			}
-		}
-		return null;
-	})();
-	binaryCache.set(name, resolved);
-	return resolved;
-}
-async function hasBinary(name) {
-	return Boolean(await findBinary(name));
-}
-async function probeGeminiCli() {
-	const cached = geminiProbeCache.get("gemini");
-	if (cached) return cached;
-	const resolved = (async () => {
-		if (!await hasBinary("gemini")) return false;
-		try {
-			const { stdout } = await runExec("gemini", [
-				"--output-format",
-				"json",
-				"ok"
-			], { timeoutMs: 8e3 });
-			return Boolean(extractGeminiResponse(stdout) ?? normalizeLowercaseStringOrEmpty(stdout).includes("ok"));
-		} catch {
-			return false;
-		}
-	})();
-	geminiProbeCache.set("gemini", resolved);
-	return resolved;
-}
-async function resolveLocalWhisperCppEntry() {
-	if (!await hasBinary("whisper-cli")) return null;
-	const envModel = process.env.WHISPER_CPP_MODEL?.trim();
-	const modelPath = envModel && await fileExists(envModel) ? envModel : "/opt/homebrew/share/whisper-cpp/for-tests-ggml-tiny.bin";
-	if (!await fileExists(modelPath)) return null;
-	return {
-		type: "cli",
-		command: "whisper-cli",
-		args: [
-			"-m",
-			modelPath,
-			"-otxt",
-			"-of",
-			"{{OutputBase}}",
-			"-np",
-			"-nt",
-			"{{MediaPath}}"
-		]
-	};
-}
-async function resolveLocalWhisperEntry() {
-	if (!await hasBinary("whisper")) return null;
-	return {
-		type: "cli",
-		command: "whisper",
-		args: [
-			"--model",
-			"turbo",
-			"--output_format",
-			"txt",
-			"--output_dir",
-			"{{OutputDir}}",
-			"--verbose",
-			"False",
-			"{{MediaPath}}"
-		]
-	};
-}
-async function resolveSherpaOnnxEntry() {
-	if (!await hasBinary("sherpa-onnx-offline")) return null;
-	const modelDir = process.env.SHERPA_ONNX_MODEL_DIR?.trim();
-	if (!modelDir) return null;
-	const tokens = path.join(modelDir, "tokens.txt");
-	const encoder = path.join(modelDir, "encoder.onnx");
-	const decoder = path.join(modelDir, "decoder.onnx");
-	const joiner = path.join(modelDir, "joiner.onnx");
-	if (!await fileExists(tokens)) return null;
-	if (!await fileExists(encoder)) return null;
-	if (!await fileExists(decoder)) return null;
-	if (!await fileExists(joiner)) return null;
-	return {
-		type: "cli",
-		command: "sherpa-onnx-offline",
-		args: [
-			`--tokens=${tokens}`,
-			`--encoder=${encoder}`,
-			`--decoder=${decoder}`,
-			`--joiner=${joiner}`,
-			"{{MediaPath}}"
-		]
-	};
-}
-async function resolveLocalAudioEntry() {
-	const sherpa = await resolveSherpaOnnxEntry();
-	if (sherpa) return sherpa;
-	const whisperCpp = await resolveLocalWhisperCppEntry();
-	if (whisperCpp) return whisperCpp;
-	return await resolveLocalWhisperEntry();
-}
-async function resolveGeminiCliEntry(_capability) {
-	if (!await probeGeminiCli()) return null;
-	return {
-		type: "cli",
-		command: "gemini",
-		args: [
-			"--output-format",
-			"json",
-			"--allowed-tools",
-			"read_many_files",
-			"--include-directories",
-			"{{MediaDir}}",
-			"{{Prompt}}",
-			"Use read_many_files to read {{MediaPath}} and respond with only the text output."
-		]
-	};
-}
-async function resolveKeyEntry(params) {
-	const { cfg, agentDir, providerRegistry, capability } = params;
-	const checkProvider = async (providerId, model) => {
-		const provider = getMediaUnderstandingProvider(providerId, providerRegistry);
-		if (!provider) return null;
-		if (capability === "audio" && !provider.transcribeAudio) return null;
-		if (capability === "image" && !provider.describeImage) return null;
-		if (capability === "video" && !provider.describeVideo) return null;
-		if (!await hasAvailableAuthForProvider({
-			provider: providerId,
-			cfg,
-			agentDir
-		})) return null;
-		const resolvedModel = capability === "image" ? await resolveAutoImageModelId({
-			cfg,
-			providerId,
-			explicitModel: model
-		}) : model;
-		if (capability === "image" && !resolvedModel) return null;
-		return {
-			type: "provider",
-			provider: providerId,
-			model: resolvedModel
-		};
-	};
-	const activeProvider = params.activeModel?.provider?.trim();
-	if (activeProvider) {
-		const activeEntry = await checkProvider(activeProvider, params.activeModel?.model);
-		if (activeEntry) return activeEntry;
-	}
-	for (const providerId of resolveConfiguredKeyProviderOrder({
-		cfg,
-		providerRegistry,
-		capability,
-		fallbackProviders: resolveAutoMediaKeyProviders({
-			cfg,
-			capability,
-			providerRegistry
-		})
-	})) {
-		const entry = await checkProvider(providerId, void 0);
-		if (entry) return entry;
-	}
-	return null;
-}
-function resolveImageModelFromAgentDefaults(cfg) {
-	const refs = [];
-	const primary = resolveAgentModelPrimaryValue(cfg.agents?.defaults?.imageModel);
-	if (primary?.trim()) refs.push(primary.trim());
-	for (const fb of resolveAgentModelFallbackValues(cfg.agents?.defaults?.imageModel)) if (fb?.trim()) refs.push(fb.trim());
-	if (refs.length === 0) return [];
-	const entries = [];
-	for (const ref of refs) {
-		const slashIdx = ref.indexOf("/");
-		if (slashIdx <= 0 || slashIdx >= ref.length - 1) continue;
-		entries.push({
-			type: "provider",
-			provider: ref.slice(0, slashIdx),
-			model: ref.slice(slashIdx + 1)
-		});
-	}
-	return entries;
-}
-function hasExplicitImageUnderstandingConfig(params) {
-	return (params.config?.models?.length ?? 0) > 0 || resolveImageModelFromAgentDefaults(params.cfg).length > 0;
-}
-async function resolveAutoEntries(params) {
-	if (params.capability === "image") {
-		const imageModelEntries = resolveImageModelFromAgentDefaults(params.cfg);
-		if (imageModelEntries.length > 0) return imageModelEntries;
-	}
-	const activeEntry = await resolveActiveModelEntry(params);
-	if (activeEntry) return [activeEntry];
-	if (params.capability === "audio") {
-		const keyEntry = await resolveKeyEntry(params);
-		if (keyEntry) return [keyEntry];
-		const localAudio = await resolveLocalAudioEntry();
-		if (localAudio) return [localAudio];
-	}
-	const gemini = await resolveGeminiCliEntry(params.capability);
-	if (gemini) return [gemini];
-	const keys = await resolveKeyEntry(params);
-	if (keys) return [keys];
-	return [];
-}
-async function resolveAutoImageModel(params) {
-	const providerRegistry = buildProviderRegistry(void 0, params.cfg);
-	const toActive = (entry) => {
-		if (!entry || entry.type === "cli") return null;
-		const provider = entry.provider;
-		const model = entry.model?.trim();
-		if (!provider || !model) return null;
-		return {
-			provider,
-			model
-		};
-	};
-	const configuredImageModel = resolveImageModelFromAgentDefaults(params.cfg).map((entry) => toActive(entry)).find((entry) => entry !== null);
-	if (configuredImageModel) return configuredImageModel;
-	const resolvedActive = toActive(await resolveActiveModelEntry({
-		cfg: params.cfg,
-		agentDir: params.agentDir,
-		providerRegistry,
-		capability: "image",
-		activeModel: params.activeModel
-	}));
-	if (resolvedActive) return resolvedActive;
-	return toActive(await resolveKeyEntry({
-		cfg: params.cfg,
-		agentDir: params.agentDir,
-		providerRegistry,
-		capability: "image",
-		activeModel: params.activeModel
-	}));
-}
-async function resolveActiveModelEntry(params) {
-	const activeProviderRaw = params.activeModel?.provider?.trim();
-	if (!activeProviderRaw) return null;
-	const providerId = normalizeMediaProviderId(activeProviderRaw);
-	if (!providerId) return null;
-	const provider = getMediaUnderstandingProvider(providerId, params.providerRegistry);
-	if (!provider) return null;
-	if (params.capability === "audio" && !provider.transcribeAudio) return null;
-	if (params.capability === "image" && !provider.describeImage) return null;
-	if (params.capability === "video" && !provider.describeVideo) return null;
-	if (!await hasAvailableAuthForProvider({
-		provider: providerId,
-		cfg: params.cfg,
-		agentDir: params.agentDir
-	})) return null;
-	const model = params.capability === "image" ? await resolveAutoImageModelId({
-		cfg: params.cfg,
-		providerId,
-		explicitModel: params.activeModel?.model
-	}) : params.activeModel?.model;
-	if (params.capability === "image" && !model) return null;
-	return {
-		type: "provider",
-		provider: providerId,
-		model
-	};
-}
-async function runAttachmentEntries(params) {
-	const { entries, capability } = params;
-	const attempts = [];
-	for (const entry of entries) {
-		const entryType = entry.type ?? (entry.command ? "cli" : "provider");
-		try {
-			const result = entryType === "cli" ? await runCliEntry({
-				capability,
-				entry,
-				cfg: params.cfg,
-				ctx: params.ctx,
-				attachmentIndex: params.attachmentIndex,
-				cache: params.cache,
-				config: params.config
-			}) : await runProviderEntry({
-				capability,
-				entry,
-				cfg: params.cfg,
-				ctx: params.ctx,
-				attachmentIndex: params.attachmentIndex,
-				cache: params.cache,
-				agentDir: params.agentDir,
-				providerRegistry: params.providerRegistry,
-				config: params.config
-			});
-			if (result) {
-				const decision = buildModelDecision({
-					entry,
-					entryType,
-					outcome: "success"
-				});
-				if (result.provider) decision.provider = result.provider;
-				if (result.model) decision.model = result.model;
-				attempts.push(decision);
-				return {
-					output: result,
-					attempts
-				};
-			}
-			attempts.push(buildModelDecision({
-				entry,
-				entryType,
-				outcome: "skipped",
-				reason: "empty output"
-			}));
-		} catch (err) {
-			if (isMediaUnderstandingSkipError(err)) {
-				attempts.push(buildModelDecision({
-					entry,
-					entryType,
-					outcome: "skipped",
-					reason: `${err.reason}: ${err.message}`
-				}));
-				if (shouldLogVerbose()) logVerbose(`Skipping ${capability} model due to ${err.reason}: ${err.message}`);
-				continue;
-			}
-			attempts.push(buildModelDecision({
-				entry,
-				entryType,
-				outcome: "failed",
-				reason: String(err)
-			}));
-			if (shouldLogVerbose()) logVerbose(`${capability} understanding failed: ${String(err)}`);
-		}
-	}
-	return {
-		output: null,
-		attempts
-	};
-}
-function hasFailedMediaAttempt(attachments) {
-	return attachments.some((attachment) => attachment.attempts.some((attempt) => attempt.outcome === "failed"));
-}
-async function runCapability(params) {
-	const { capability, cfg, ctx } = params;
-	const config = params.config ?? cfg.tools?.media?.[capability];
-	if (config?.enabled === false) return {
-		outputs: [],
-		decision: {
-			capability,
-			outcome: "disabled",
-			attachments: []
-		}
-	};
-	const attachmentPolicy = config?.attachments;
-	const selected = selectAttachments({
-		capability,
-		attachments: params.media,
-		policy: attachmentPolicy
-	});
-	if (selected.length === 0) return {
-		outputs: [],
-		decision: {
-			capability,
-			outcome: "no-attachment",
-			attachments: []
-		}
-	};
-	if (resolveScopeDecision({
-		scope: config?.scope,
-		ctx
-	}) === "deny") {
-		if (shouldLogVerbose()) logVerbose(`${capability} understanding disabled by scope policy.`);
-		return {
-			outputs: [],
-			decision: {
-				capability,
-				outcome: "scope-deny",
-				attachments: selected.map((item) => ({
-					attachmentIndex: item.index,
-					attempts: []
-				}))
-			}
-		};
-	}
-	const activeProvider = params.activeModel?.provider?.trim();
-	if (capability === "image" && activeProvider && !hasExplicitImageUnderstandingConfig({
-		cfg,
-		config
-	})) {
-		if (modelSupportsVision(findModelInCatalog(await loadModelCatalog({ config: cfg }), activeProvider, params.activeModel?.model ?? ""))) {
-			if (shouldLogVerbose()) logVerbose("Skipping image understanding: primary model supports vision natively");
-			const model = params.activeModel?.model?.trim();
-			const reason = "primary model supports vision natively";
-			return {
-				outputs: [],
-				decision: {
-					capability,
-					outcome: "skipped",
-					attachments: selected.map((item) => {
-						const attempt = {
-							type: "provider",
-							provider: activeProvider,
-							model: model || void 0,
-							outcome: "skipped",
-							reason
-						};
-						return {
-							attachmentIndex: item.index,
-							attempts: [attempt],
-							chosen: attempt
-						};
-					})
-				}
-			};
-		}
-	}
-	let resolvedEntries = resolveModelEntries({
-		cfg,
-		capability,
-		config,
-		providerRegistry: params.providerRegistry
-	});
-	if (resolvedEntries.length === 0) resolvedEntries = await resolveAutoEntries({
-		cfg,
-		agentDir: params.agentDir,
-		providerRegistry: params.providerRegistry,
-		capability,
-		activeModel: params.activeModel
-	});
-	if (resolvedEntries.length === 0) return {
-		outputs: [],
-		decision: {
-			capability,
-			outcome: "skipped",
-			attachments: selected.map((item) => ({
-				attachmentIndex: item.index,
-				attempts: []
-			}))
-		}
-	};
-	const outputs = [];
-	const attachmentDecisions = [];
-	for (const attachment of selected) {
-		const { output, attempts } = await runAttachmentEntries({
-			capability,
-			cfg,
-			ctx,
-			attachmentIndex: attachment.index,
-			agentDir: params.agentDir,
-			providerRegistry: params.providerRegistry,
-			cache: params.attachments,
-			entries: resolvedEntries,
-			config
-		});
-		if (output) outputs.push(output);
-		attachmentDecisions.push({
-			attachmentIndex: attachment.index,
-			attempts,
-			chosen: attempts.find((attempt) => attempt.outcome === "success")
-		});
-	}
-	const decision = {
-		capability,
-		outcome: outputs.length > 0 ? "success" : hasFailedMediaAttempt(attachmentDecisions) ? "failed" : "skipped",
-		attachments: attachmentDecisions
-	};
-	if (decision.outcome === "failed") logWarn(`media-understanding: ${formatDecisionSummary(decision)}`);
-	else if (shouldLogVerbose()) logVerbose(`Media understanding ${formatDecisionSummary(decision)}`);
-	return {
-		outputs,
-		decision
-	};
-}
-//#endregion
-export { runCapability as a, MediaAttachmentCache as c, resolveAttachmentKind as d, resolveMediaAttachmentLocalRoots as i, isAudioAttachment as l, clearMediaUnderstandingBinaryCacheForTests as n, createMediaAttachmentCache as o, resolveAutoImageModel as r, normalizeMediaAttachments as s, buildProviderRegistry as t, normalizeAttachments as u };