@xopcai/xopc 0.0.366 → 0.0.367

package/dist/src/agent/image/generation/normalization.js

@@ -1,181 +0,0 @@
-import { resolveClosestAspectRatio, resolveClosestResolution, resolveClosestSize } from "../../media-generation/runtime-shared.js";
-import "../../media-generation/index.js";
-//#region src/agent/image/generation/normalization.ts
-/**
-* Image-generation parameter normalization.
-*
-* Reconciles user-supplied geometry / output overrides against the active
-* provider's declared {@link ImageGenerationProviderCapabilities}. Returns:
-*   - the actually-applied values to forward to the provider
-*   - per-field {@link MediaNormalizationEntry} (requested / applied / derivedFrom)
-*   - a list of {@link ImageGenerationIgnoredOverride} entries for unsupported
-*     soft fields (so the LLM / UI can surface a Note)
-*
-* Hard errors (unsupported edit, too many input images) are thrown so the
-* caller can fail fast — they are NOT downgraded to ignored overrides.
-*
-* Decision table — see docs/image-generation-rearchitecture.md §6.3
-*/
-function resolveImageGenerationOverrides(params) {
-	const provider = params.provider;
-	const caps = provider.capabilities ?? {};
-	const isEdit = (params.inputImages?.length ?? 0) > 0;
-	assertEditSupported(provider, isEdit, params.inputImages);
-	const modeCaps = isEdit ? caps.edit : caps.generate;
-	const supportsSize = modeCaps?.supportsSize === true;
-	const supportsAspectRatio = modeCaps?.supportsAspectRatio === true;
-	const supportsResolution = caps.generate?.supportsResolution === true && !isEdit;
-	const ignoredOverrides = [];
-	const normalization = {};
-	const { size, aspectRatio, resolution } = resolveGeometry({
-		requestedSize: params.size,
-		requestedAspectRatio: params.aspectRatio,
-		requestedResolution: params.resolution,
-		supportsSize,
-		supportsAspectRatio,
-		supportsResolution,
-		geometry: caps.geometry,
-		ignoredOverrides,
-		normalization
-	});
-	const quality = filterEnumOverride({
-		key: "quality",
-		requested: params.quality,
-		supported: caps.output?.qualities,
-		ignoredOverrides
-	});
-	const outputFormat = filterEnumOverride({
-		key: "outputFormat",
-		requested: params.outputFormat,
-		supported: caps.output?.formats,
-		ignoredOverrides
-	});
-	const background = filterEnumOverride({
-		key: "background",
-		requested: params.background,
-		supported: caps.output?.backgrounds,
-		ignoredOverrides
-	});
-	return {
-		...size !== void 0 ? { size } : {},
-		...aspectRatio !== void 0 ? { aspectRatio } : {},
-		...resolution !== void 0 ? { resolution } : {},
-		...quality !== void 0 ? { quality } : {},
-		...outputFormat !== void 0 ? { outputFormat } : {},
-		...background !== void 0 ? { background } : {},
-		ignoredOverrides,
-		...hasAnyEntry(normalization) ? { normalization } : {}
-	};
-}
-function resolveGeometry(params) {
-	const supportedSizes = params.geometry?.sizes;
-	const supportedAspectRatios = params.geometry?.aspectRatios;
-	const supportedResolutions = params.geometry?.resolutions;
-	let size;
-	let aspectRatio;
-	let resolution;
-	if (params.requestedSize) if (params.supportsSize) {
-		const applied = resolveClosestSize({
-			requestedSize: params.requestedSize,
-			supportedSizes
-		});
-		if (applied) {
-			size = applied;
-			params.normalization.size = entry({
-				requested: params.requestedSize,
-				applied,
-				supportedValues: supportedSizes
-			});
-		} else size = params.requestedSize;
-	} else if (params.supportsAspectRatio) {
-		const derived = resolveClosestAspectRatio({
-			requestedSize: params.requestedSize,
-			supportedAspectRatios
-		});
-		if (derived) {
-			aspectRatio = derived;
-			params.normalization.aspectRatio = entry({
-				applied: derived,
-				derivedFrom: "size",
-				supportedValues: supportedAspectRatios
-			});
-		} else ignored(params.ignoredOverrides, "size", params.requestedSize);
-	} else ignored(params.ignoredOverrides, "size", params.requestedSize);
-	if (params.requestedAspectRatio) {
-		if (params.supportsAspectRatio) {
-			const finalApplied = resolveClosestAspectRatio({
-				requestedAspectRatio: params.requestedAspectRatio,
-				supportedAspectRatios
-			}) ?? params.requestedAspectRatio;
-			aspectRatio = finalApplied;
-			params.normalization.aspectRatio = entry({
-				requested: params.requestedAspectRatio,
-				applied: finalApplied,
-				supportedValues: supportedAspectRatios
-			});
-		} else if (params.supportsSize && size === void 0) {
-			const derived = resolveClosestSize({
-				requestedAspectRatio: params.requestedAspectRatio,
-				supportedSizes
-			});
-			if (derived) {
-				size = derived;
-				params.normalization.size = entry({
-					applied: derived,
-					derivedFrom: "aspectRatio",
-					supportedValues: supportedSizes
-				});
-			} else ignored(params.ignoredOverrides, "aspectRatio", params.requestedAspectRatio);
-		} else if (!params.supportsSize) ignored(params.ignoredOverrides, "aspectRatio", params.requestedAspectRatio);
-		if (!params.supportsAspectRatio && params.supportsSize && size !== void 0 && params.normalization.size?.derivedFrom !== "aspectRatio") ignored(params.ignoredOverrides, "aspectRatio", params.requestedAspectRatio);
-	}
-	if (params.requestedResolution) if (params.supportsResolution) {
-		const finalApplied = resolveClosestResolution({
-			requestedResolution: params.requestedResolution,
-			supportedResolutions
-		}) ?? params.requestedResolution;
-		resolution = finalApplied;
-		params.normalization.resolution = entry({
-			requested: params.requestedResolution,
-			applied: finalApplied,
-			supportedValues: supportedResolutions
-		});
-	} else ignored(params.ignoredOverrides, "resolution", params.requestedResolution);
-	return {
-		size,
-		aspectRatio,
-		resolution
-	};
-}
-function assertEditSupported(provider, isEdit, inputImages) {
-	if (!isEdit) return;
-	const editCap = (provider.capabilities ?? {}).edit;
-	if (!(editCap?.enabled === true)) throw new Error(`${provider.id} image editing is not supported.`);
-	const max = editCap.maxInputImages;
-	if (typeof max === "number" && (inputImages?.length ?? 0) > max) throw new Error(`${provider.id} accepts at most ${max} input image(s); got ${inputImages?.length ?? 0}.`);
-}
-function filterEnumOverride(params) {
-	if (params.requested === void 0) return void 0;
-	if (!params.supported || params.supported.length === 0) return params.requested;
-	if (params.supported.includes(params.requested)) return params.requested;
-	ignored(params.ignoredOverrides, params.key, params.requested);
-}
-function ignored(list, key, value) {
-	list.push({
-		key,
-		value
-	});
-}
-function entry(init) {
-	return {
-		...init.requested !== void 0 ? { requested: init.requested } : {},
-		...init.applied !== void 0 ? { applied: init.applied } : {},
-		...init.derivedFrom !== void 0 ? { derivedFrom: init.derivedFrom } : {},
-		...init.supportedValues ? { supportedValues: [...init.supportedValues] } : {}
-	};
-}
-function hasAnyEntry(n) {
-	return n.size !== void 0 || n.aspectRatio !== void 0 || n.resolution !== void 0;
-}
-//#endregion
-export { resolveImageGenerationOverrides };

package/dist/src/agent/image/generation/providers/dashscope.d.ts

@@ -1,35 +0,0 @@
-import type { ImageGenerationProvider, ImageGenerationRequest, ImageGenerationResult } from '../types.js';
-/**
- * Wan image model ids for **HTTP synchronous** `multimodal-generation/generation`.
- * - **2.7** (`wan2.7-image-pro` / `wan2.7-image`): see Wan 2.7 image API (size presets 1K/2K/4K, `thinking_mode`, …).
- * - **2.6** (`wan2.6-t2i`): Wan 2.6 T2I (`prompt_extend`, pixel `宽*高`, …).
- * Wan 2.5 and earlier async-only models are not listed here.
- * @see https://www.alibabacloud.com/help/en/model-studio/wan-image-generation-and-editing-api-reference
- * @see https://www.alibabacloud.com/help/en/model-studio/text-to-image-v2-api-reference
- * @see https://www.alibabacloud.com/help/en/model-studio/model-pricing
- */
-export declare const DASHSCOPE_IMAGE_MODELS: readonly string[];
-export declare const DASHSCOPE_DEFAULT_IMAGE_MODEL: string;
-/**
- * Official synchronous wan2.6 text-to-image endpoints. Each region uses its own API key.
- * @see https://www.alibabacloud.com/help/zh/model-studio/text-to-image-v2-api-reference
- */
-export declare const DASHSCOPE_IMAGE_ENDPOINTS: {
-    readonly beijing: "https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation";
-    readonly singapore: "https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation";
-};
-export type DashScopeImageRegion = keyof typeof DASHSCOPE_IMAGE_ENDPOINTS;
-export declare function resolveDashScopeImageGenerationUrl(req: ImageGenerationRequest): string;
-/** Map tool size (e.g. `1024x1024`) to DashScope `宽*高` format. */
-export declare function mapSizeToDashScopeFormat(size?: string): string;
-export declare function isWan27ImageModel(model: string): boolean;
-/**
- * Map tool `size` to Wan 2.7 `parameters.size` (1K / 2K / 4K presets or `宽*高` pixels).
- * `wan2.7-image` does not support 4K — falls back to 2K.
- */
-export declare function mapSizeToWan27Format(size: string | undefined, modelId: string): string;
-export declare function generateDashScopeImages(params: {
-    req: ImageGenerationRequest;
-    apiKey: string;
-}): Promise<ImageGenerationResult>;
-export declare function buildDashScopeImageGenerationProvider(): ImageGenerationProvider;

package/dist/src/agent/image/generation/providers/dashscope.js

@@ -1,257 +0,0 @@
-import { createLogger } from "../../../../utils/logger/index.js";
-import { init_logger } from "../../../../utils/logger.js";
-import { imageFileExtensionForMimeType } from "../image-assets.js";
-import { pickTimeoutMsOrFallback } from "../../../../media-shared/http/deadline.js";
-import { privateNetworkPolicyToSsrfGuardOptions } from "../../../../media-shared/http/private-network.js";
-import { resolveProviderHttpRequestConfig } from "../../../../media-shared/http/resolve-provider-http-request-config.js";
-import { postJsonRequest } from "../../../../media-shared/http/provider-http.js";
-import "../../../../media-shared/http/index.js";
-import { resolveApiKeyForProvider } from "../../../../providers/auth-runtime/resolve-api-key.js";
-import { isProviderApiKeyConfigured } from "../../../../providers/auth-runtime/is-configured.js";
-import "../../../../providers/auth-runtime/index.js";
-//#region src/agent/image/generation/providers/dashscope.ts
-/**
-* Built-in DashScope (Alibaba Model Studio) image-generation provider.
-*/
-init_logger();
-const log = createLogger("ImageGen:DashScope");
-/**
-* Wan image model ids for **HTTP synchronous** `multimodal-generation/generation`.
-* - **2.7** (`wan2.7-image-pro` / `wan2.7-image`): see Wan 2.7 image API (size presets 1K/2K/4K, `thinking_mode`, …).
-* - **2.6** (`wan2.6-t2i`): Wan 2.6 T2I (`prompt_extend`, pixel `宽*高`, …).
-* Wan 2.5 and earlier async-only models are not listed here.
-* @see https://www.alibabacloud.com/help/en/model-studio/wan-image-generation-and-editing-api-reference
-* @see https://www.alibabacloud.com/help/en/model-studio/text-to-image-v2-api-reference
-* @see https://www.alibabacloud.com/help/en/model-studio/model-pricing
-*/
-const DASHSCOPE_IMAGE_MODELS = [
-	"wan2.7-image-pro",
-	"wan2.7-image",
-	"wan2.6-t2i"
-];
-const DASHSCOPE_DEFAULT_IMAGE_MODEL = DASHSCOPE_IMAGE_MODELS[0];
-const DEFAULT_TIMEOUT_MS = 18e4;
-const DASHSCOPE_CAPABILITIES = {
-	generate: {
-		maxCount: 4,
-		supportsSize: true
-	},
-	edit: { enabled: false },
-	geometry: { sizes: [
-		"2K",
-		"1K",
-		"4K",
-		"1280x1280",
-		"1024x1024",
-		"1280x720",
-		"720x1280",
-		"1024x1536",
-		"1536x1024"
-	] },
-	output: { formats: [
-		"png",
-		"jpeg",
-		"webp"
-	] }
-};
-/**
-* Official synchronous wan2.6 text-to-image endpoints. Each region uses its own API key.
-* @see https://www.alibabacloud.com/help/zh/model-studio/text-to-image-v2-api-reference
-*/
-const DASHSCOPE_IMAGE_ENDPOINTS = {
-	beijing: "https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation",
-	singapore: "https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation"
-};
-const DEFAULT_OUTPUT_MIME = "image/png";
-function resolveDashScopeImageGenerationUrl(req) {
-	const cfgBase = readDashScopeCfgString(req.cfg, "baseUrl");
-	if (cfgBase) return cfgBase.replace(/\/+$/, "");
-	const region = readDashScopeCfgString(req.cfg, "region");
-	if (region === "cn") return DASHSCOPE_IMAGE_ENDPOINTS.beijing;
-	if (region === "intl") return DASHSCOPE_IMAGE_ENDPOINTS.singapore;
-	throw new Error("DashScope image generation requires providers.dashscope.region (cn or intl)");
-}
-function readDashScopeCfgString(cfg, key) {
-	const providers = cfg?.providers;
-	if (!providers || typeof providers !== "object") return void 0;
-	const entry = providers.dashscope;
-	if (!entry || typeof entry !== "object") return void 0;
-	const v = entry[key];
-	return typeof v === "string" && v.trim() ? v.trim() : void 0;
-}
-/** Map tool size (e.g. `1024x1024`) to DashScope `宽*高` format. */
-function mapSizeToDashScopeFormat(size) {
-	if (!size?.trim()) return "1280*1280";
-	const s = size.trim();
-	if (s.includes("*")) return s.replace(/\s/g, "");
-	const m = /^(\d+)\s*[xX]\s*(\d+)$/.exec(s);
-	if (m) return `${m[1]}*${m[2]}`;
-	return "1280*1280";
-}
-function isWan27ImageModel(model) {
-	const m = model.trim().toLowerCase();
-	return m === "wan2.7-image-pro" || m === "wan2.7-image";
-}
-/**
-* Map tool `size` to Wan 2.7 `parameters.size` (1K / 2K / 4K presets or `宽*高` pixels).
-* `wan2.7-image` does not support 4K — falls back to 2K.
-*/
-function mapSizeToWan27Format(size, modelId) {
-	const id = modelId.trim().toLowerCase();
-	if (!size?.trim()) return "2K";
-	const s = size.trim();
-	const preset = s.toUpperCase();
-	if (preset === "1K" || preset === "2K" || preset === "4K") {
-		if (preset === "4K" && id === "wan2.7-image") return "2K";
-		return preset;
-	}
-	if (s.includes("*")) return s.replace(/\s/g, "");
-	const dim = /^(\d+)\s*[xX]\s*(\d+)$/.exec(s);
-	if (dim) return `${dim[1]}*${dim[2]}`;
-	return "2K";
-}
-function collectImageUrls(data) {
-	const urls = [];
-	for (const choice of data.output?.choices ?? []) for (const item of choice.message?.content ?? []) if (item.type === "image" && typeof item.image === "string" && item.image.length > 0) urls.push(item.image);
-	return urls;
-}
-async function fetchImageBuffers(urls, signal) {
-	const out = [];
-	let index = 0;
-	for (const url of urls) {
-		index += 1;
-		const res = await fetch(url, {
-			redirect: "follow",
-			signal
-		});
-		if (!res.ok) {
-			const t = await res.text().catch(() => "");
-			throw new Error(`Failed to download generated image (${res.status}): ${t || res.statusText}`);
-		}
-		const buf = Buffer.from(await res.arrayBuffer());
-		const mimeType = (res.headers.get("content-type") || "").split(";")[0]?.trim() || DEFAULT_OUTPUT_MIME;
-		const ext = imageFileExtensionForMimeType(mimeType);
-		out.push({
-			buffer: buf,
-			mimeType,
-			fileName: `image-${index}.${ext}`
-		});
-	}
-	return out;
-}
-async function generateDashScopeImages(params) {
-	const { req, apiKey } = params;
-	const providerId = "dashscope";
-	if (req.inputImages && req.inputImages.length > 0) throw new Error("Image-to-image is not supported for Qwen/DashScope in this build");
-	const n = Math.min(4, Math.max(1, req.count ?? 1));
-	const model = req.model?.trim() || DASHSCOPE_DEFAULT_IMAGE_MODEL;
-	const parameters = isWan27ImageModel(model) ? {
-		size: mapSizeToWan27Format(req.size, model),
-		n,
-		watermark: false,
-		thinking_mode: true
-	} : {
-		prompt_extend: true,
-		watermark: false,
-		n,
-		negative_prompt: "",
-		size: mapSizeToDashScopeFormat(req.size)
-	};
-	const body = {
-		model,
-		input: { messages: [{
-			role: "user",
-			content: [{ text: req.prompt }]
-		}] },
-		parameters
-	};
-	const url = resolveDashScopeImageGenerationUrl(req);
-	const httpDefaults = resolveProviderHttpRequestConfig({
-		providerId,
-		cfg: req.cfg,
-		fallbackTimeoutMs: DEFAULT_TIMEOUT_MS
-	});
-	log.debug({
-		providerId,
-		model,
-		url,
-		count: n,
-		phase: "request"
-	}, "DashScope image generation request");
-	const response = await postJsonRequest(url, {
-		label: providerId,
-		timeoutMs: pickTimeoutMsOrFallback(req.timeoutMs, httpDefaults.timeoutMs, DEFAULT_TIMEOUT_MS),
-		signal: req.signal,
-		body,
-		headers: {
-			...httpDefaults.headers,
-			authorization: `Bearer ${apiKey}`
-		},
-		...privateNetworkPolicyToSsrfGuardOptions()
-	});
-	let data;
-	const rawText = await response.text();
-	try {
-		data = JSON.parse(rawText);
-	} catch {
-		throw new Error(`DashScope returned non-JSON: ${rawText.slice(0, 240)}`);
-	}
-	if (!data.output?.choices?.length) {
-		if (data.message || data.code) throw new Error(data.code ? `DashScope: ${data.code}: ${data.message ?? ""}` : `DashScope: ${data.message ?? "unknown error"}`);
-		throw new Error("DashScope returned no output");
-	}
-	const urls = collectImageUrls(data);
-	if (urls.length === 0) throw new Error("DashScope returned no image URLs in response");
-	return {
-		images: await fetchImageBuffers(urls, req.signal),
-		model
-	};
-}
-function buildDashScopeImageGenerationProvider() {
-	return {
-		id: "dashscope",
-		label: "Alibaba Model Studio",
-		documentationUrl: "https://www.alibabacloud.com/help/en/model-studio/wan-image-generation-and-editing-api-reference",
-		apiKeyUrl: "https://dashscope.console.aliyun.com/apiKey",
-		configFields: [{
-			key: "region",
-			label: "Service region",
-			type: "select",
-			required: true,
-			options: [{
-				value: "cn",
-				label: "China"
-			}, {
-				value: "intl",
-				label: "International"
-			}]
-		}, {
-			key: "baseUrl",
-			label: "Base URL",
-			type: "url",
-			placeholder: "https://…"
-		}],
-		defaultModel: DASHSCOPE_DEFAULT_IMAGE_MODEL,
-		models: [...DASHSCOPE_IMAGE_MODELS],
-		capabilities: DASHSCOPE_CAPABILITIES,
-		isConfigured: (ctx) => isProviderApiKeyConfigured({
-			providerId: "dashscope",
-			cfg: ctx.cfg,
-			agentId: ctx.agentId
-		}) && ["cn", "intl"].includes(readDashScopeCfgString(ctx.cfg, "region") ?? ""),
-		async generateImage(req) {
-			const apiKey = resolveApiKeyForProvider({
-				providerId: "dashscope",
-				cfg: req.cfg,
-				agentId: req.agentId
-			});
-			if (!apiKey) throw new Error("DashScope API key missing (set DASHSCOPE_API_KEY or save a credential)");
-			return generateDashScopeImages({
-				req,
-				apiKey
-			});
-		}
-	};
-}
-//#endregion
-export { DASHSCOPE_DEFAULT_IMAGE_MODEL, DASHSCOPE_IMAGE_ENDPOINTS, DASHSCOPE_IMAGE_MODELS, buildDashScopeImageGenerationProvider, generateDashScopeImages, isWan27ImageModel, mapSizeToDashScopeFormat, mapSizeToWan27Format, resolveDashScopeImageGenerationUrl };

package/dist/src/agent/image/generation/providers/fal.d.ts

@@ -1,15 +0,0 @@
-import type { ImageGenerationProvider, ImageGenerationRequest, ImageGenerationResult } from '../types.js';
-export declare const FAL_DEFAULT_IMAGE_MODEL = "fal-ai/flux-2";
-export declare const FAL_IMAGE_MODELS: readonly string[];
-/**
- * Resolve Fal queue base URL precedence:
- * 1. cfg.providers.fal.baseUrl
- * 2. FAL_QUEUE_BASE_URL / FAL_BASE_URL env
- * 3. Default https://queue.fal.run
- */
-export declare function resolveFalBaseUrl(req: ImageGenerationRequest): string;
-export declare function generateFalImages(params: {
-    req: ImageGenerationRequest;
-    apiKey: string;
-}): Promise<ImageGenerationResult>;
-export declare function buildFalImageGenerationProvider(): ImageGenerationProvider;