@neta-art/generation 0.1.2 → 0.1.3

package/dist/{export-config-BPnZYpmN.js → export-config-D8By2_r7.js}

@@ -1,4 +1,4 @@
-import { a as compactArray, c as slugifyFileName, i as cloneJson, l as MODEL_SCHEMA, n as getBuiltinGenerationModel, o as compactObject, r as listBuiltinGenerationModels, s as getBlockMeta, t as builtinGenerationModels } from "./builtins-B1AheaEa.js";
+import { a as compactArray, c as slugifyFileName, i as cloneJson, l as MODEL_SCHEMA, n as getBuiltinGenerationModel, o as compactObject, r as listBuiltinGenerationModels, s as getBlockMeta, t as builtinGenerationModels } from "./builtins-FumzmWvj.js";
 import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
 import { extname, join } from "node:path";
 import { parse, stringify } from "yaml";
@@ -161,7 +161,12 @@ function validateGenerationContent(declaration, content) {
 function resolveGenerationParameters(declaration, parameters) {
 	const specs = declaration.parameters ?? {};
 	const resolved = {};
-	for (const key of Object.keys(parameters ?? {})) if (!specs[key]) throw new GenerationValidationError(`Unknown parameter: ${key}`);
+	const allowUnknownParameters = declaration.allowUnknownParameters ?? false;
+	for (const key of Object.keys(parameters ?? {})) if (!specs[key]) {
+		if (!allowUnknownParameters) throw new GenerationValidationError(`Unknown parameter: ${key}`);
+		const value = parameters?.[key];
+		if (value !== void 0) resolved[key] = value;
+	}
 	for (const [key, spec] of Object.entries(specs)) {
 		const value = parameters?.[key];
 		if (value === void 0) {
@@ -169,27 +174,73 @@ function resolveGenerationParameters(declaration, parameters) {
 			else if (!spec.optional) throw new GenerationValidationError(`Missing required parameter: ${key}`);
 			continue;
 		}
-		switch (spec.type) {
-			case "string":
-				if (typeof value !== "string") throw new GenerationValidationError(`Parameter ${key} must be a string`);
-				if (spec.enum && !spec.enum.includes(value)) throw new GenerationValidationError(`Parameter ${key} must be one of: ${spec.enum.join(", ")}`);
-				break;
-			case "number":
-				if (typeof value !== "number" || !Number.isFinite(value)) throw new GenerationValidationError(`Parameter ${key} must be a number`);
-				if (spec.min !== void 0 && value < spec.min) throw new GenerationValidationError(`Parameter ${key} must be >= ${spec.min}`);
-				if (spec.max !== void 0 && value > spec.max) throw new GenerationValidationError(`Parameter ${key} must be <= ${spec.max}`);
-				break;
-			case "integer":
-				if (typeof value !== "number" || !Number.isInteger(value)) throw new GenerationValidationError(`Parameter ${key} must be an integer`);
-				if (spec.min !== void 0 && value < spec.min) throw new GenerationValidationError(`Parameter ${key} must be >= ${spec.min}`);
-				if (spec.max !== void 0 && value > spec.max) throw new GenerationValidationError(`Parameter ${key} must be <= ${spec.max}`);
-				break;
-			case "boolean":
-				if (typeof value !== "boolean") throw new GenerationValidationError(`Parameter ${key} must be a boolean`);
-				break;
+		validateSpecValue(`Parameter ${key}`, spec, value);
+		resolved[key] = value;
+	}
+	return resolved;
+}
+function mergeGenerationMeta(requestMeta, content) {
+	const merged = {};
+	mergeMetaFields(merged, requestMeta);
+	for (const block of content) mergeMetaFields(merged, block.meta);
+	return merged;
+}
+function normalizeMetaKey(key) {
+	return key === "metadataParams" ? "metadata_params" : key;
+}
+function mergeMetaFields(target, meta) {
+	for (const [key, value] of Object.entries(meta ?? {})) {
+		const normalizedKey = normalizeMetaKey(key);
+		if (value !== void 0 && target[normalizedKey] === void 0) target[normalizedKey] = value;
+	}
+}
+function validateSpecValue(label, spec, value) {
+	switch (spec.type) {
+		case "string":
+			if (typeof value !== "string") throw new GenerationValidationError(`${label} must be a string`);
+			if (spec.enum && !spec.enum.includes(value)) throw new GenerationValidationError(`${label} must be one of: ${spec.enum.join(", ")}`);
+			break;
+		case "number":
+			if (typeof value !== "number" || !Number.isFinite(value)) throw new GenerationValidationError(`${label} must be a number`);
+			if (spec.min !== void 0 && value < spec.min) throw new GenerationValidationError(`${label} must be >= ${spec.min}`);
+			if (spec.max !== void 0 && value > spec.max) throw new GenerationValidationError(`${label} must be <= ${spec.max}`);
+			break;
+		case "integer":
+			if (typeof value !== "number" || !Number.isInteger(value)) throw new GenerationValidationError(`${label} must be an integer`);
+			if (spec.min !== void 0 && value < spec.min) throw new GenerationValidationError(`${label} must be >= ${spec.min}`);
+			if (spec.max !== void 0 && value > spec.max) throw new GenerationValidationError(`${label} must be <= ${spec.max}`);
+			break;
+		case "boolean":
+			if (typeof value !== "boolean") throw new GenerationValidationError(`${label} must be a boolean`);
+			break;
+		case "object":
+			if (!value || typeof value !== "object" || Array.isArray(value)) throw new GenerationValidationError(`${label} must be an object`);
+			break;
+	}
+}
+function resolveGenerationMeta(declaration, meta, content) {
+	const specs = declaration.meta?.fields ?? {};
+	const resolved = {};
+	for (const key of Object.keys(meta ?? {})) if (!specs[key]) {
+		const value = meta?.[key];
+		if (value !== void 0) resolved[key] = value;
+	}
+	for (const [key, spec] of Object.entries(specs)) {
+		const value = meta?.[key];
+		if (value === void 0) {
+			if (!spec.optional) throw new GenerationValidationError(`Missing required meta: ${key}`);
+			continue;
 		}
+		validateSpecValue(`meta.${key}`, spec, value);
 		resolved[key] = value;
 	}
+	const taskField = declaration.meta?.taskField;
+	const task = taskField && typeof resolved[taskField] === "string" ? resolved[taskField] : void 0;
+	if (!task) return resolved;
+	const variant = declaration.meta?.taskVariants?.[task];
+	if (!variant) throw new GenerationValidationError(`Unsupported meta.${taskField}: ${task}`);
+	for (const key of variant.required ?? []) if (resolved[key] === void 0 || resolved[key] === null || resolved[key] === "") throw new GenerationValidationError(`meta.${taskField} ${task} requires meta.${key}`);
+	for (const type of variant.requiredContent ?? []) if (!content.some((block) => block.type === type)) throw new GenerationValidationError(`meta.${taskField} ${task} requires ${type} content`);
 	return resolved;
 }
 function mergeTextBlocks(declaration, content) {
@@ -200,9 +251,9 @@ function mergeTextBlocks(declaration, content) {
 
 //#endregion
 //#region src/adapters/ark-video-generations.ts
-const REQUEST_TIMEOUT_MS$2 = 6e4;
-const DEFAULT_POLL_INTERVAL_SEC = 2;
-const DEFAULT_MAX_WAIT_SEC = 600;
+const REQUEST_TIMEOUT_MS$3 = 6e4;
+const DEFAULT_POLL_INTERVAL_SEC$1 = 2;
+const DEFAULT_MAX_WAIT_SEC$1 = 600;
 const RESOLUTION_SHORT_EDGE = {
 	"480p": 480,
 	"720p": 720,
@@ -220,10 +271,10 @@ const ASPECT_RATIOS = {
 	"21:9": [21, 9],
 	adaptive: null
 };
-function sleep(ms) {
+function sleep$1(ms) {
 	return new Promise((resolve) => setTimeout(resolve, ms));
 }
-function asString(value) {
+function asString$1(value) {
 	return typeof value === "string" && value ? value : void 0;
 }
 function asNumber(value) {
@@ -232,7 +283,7 @@ function asNumber(value) {
 function asBoolean(value) {
 	return typeof value === "boolean" ? value : void 0;
 }
-function normalizeStatus(value) {
+function normalizeStatus$1(value) {
 	const status = value.toLowerCase();
 	return status === "success" ? "succeeded" : status;
 }
@@ -286,8 +337,8 @@ function buildMetadataContent(prompt, images, mode) {
 	}
 	return content;
 }
-function extractTaskId(response) {
-	const taskId = asString(response.task_id) ?? asString(response.id);
+function extractTaskId$1(response) {
+	const taskId = asString$1(response.task_id) ?? asString$1(response.id);
 	if (!taskId) throw new GenerationProviderError("Video generation provider did not return a task id", { details: { response } });
 	return taskId;
 }
@@ -295,9 +346,9 @@ function normalizeTaskStatus(response) {
 	if (response.data) {
 		const wrapper = response.data;
 		const native = wrapper.data;
-		const status = normalizeStatus(asString(native?.status) ?? asString(wrapper.status) ?? "unknown");
-		const videoUrl = asString(wrapper.result_url) ?? asString(native?.content?.video_url);
-		const lastFrameUrl = asString(wrapper.first_frame) ?? asString(native?.content?.first_frame);
+		const status = normalizeStatus$1(asString$1(native?.status) ?? asString$1(wrapper.status) ?? "unknown");
+		const videoUrl = asString$1(wrapper.result_url) ?? asString$1(native?.content?.video_url);
+		const lastFrameUrl = asString$1(wrapper.first_frame) ?? asString$1(native?.content?.first_frame);
 		const metadata = {
 			progress: wrapper.progress,
 			resolution: native?.resolution,
@@ -324,7 +375,7 @@ function normalizeTaskStatus(response) {
 		metadata: {}
 	};
 }
-async function requestJson(input, path, init) {
+async function requestJson$1(input, path, init) {
 	const response = await fetchWithTimeout(input.context.fetch, joinUrl(input.context.baseUrl, path), {
 		...init,
 		headers: {
@@ -332,7 +383,7 @@ async function requestJson(input, path, init) {
 			"Content-Type": "application/json",
 			...init.headers
 		}
-	}, REQUEST_TIMEOUT_MS$2);
+	}, REQUEST_TIMEOUT_MS$3);
 	if (!response.ok) {
 		const body = await response.text().catch(() => response.statusText);
 		throw new GenerationProviderError("Video generation provider request failed", {
@@ -351,12 +402,12 @@ async function arkVideoGenerationsAdapter(input) {
 		role: getImageRole(block)
 	})));
 	const mode = classifyImages(images);
-	const resolution = asString(input.parameters.resolution) ?? "720p";
-	const aspectRatio = asString(input.parameters.aspect_ratio) ?? "16:9";
+	const resolution = asString$1(input.parameters.resolution) ?? "720p";
+	const aspectRatio = asString$1(input.parameters.aspect_ratio) ?? "16:9";
 	const duration = getIntegerParameter(input.parameters, "duration", 5);
 	const fps = getIntegerParameter(input.parameters, "fps", 30);
-	const pollIntervalSec = getIntegerParameter(input.parameters, "poll_interval", DEFAULT_POLL_INTERVAL_SEC);
-	const maxWaitSec = getIntegerParameter(input.parameters, "max_wait", DEFAULT_MAX_WAIT_SEC);
+	const pollIntervalSec = getIntegerParameter(input.parameters, "poll_interval", DEFAULT_POLL_INTERVAL_SEC$1);
+	const maxWaitSec = getIntegerParameter(input.parameters, "max_wait", DEFAULT_MAX_WAIT_SEC$1);
 	const generateAudio = asBoolean(input.parameters.generate_audio) ?? true;
 	const returnLastFrame = asBoolean(input.parameters.return_last_frame) ?? true;
 	const cameraFixed = asBoolean(input.parameters.camera_fixed) ?? false;
@@ -388,14 +439,14 @@ async function arkVideoGenerationsAdapter(input) {
 		if (images[0]) payload.image = images[0].url;
 	}
 	payload.metadata = metadata;
-	const taskId = extractTaskId(await requestJson(input, "/v1/video/generations", {
+	const taskId = extractTaskId$1(await requestJson$1(input, "/v1/video/generations", {
 		method: "POST",
 		body: JSON.stringify(payload)
 	}));
 	const startedAt = Date.now();
 	while (Date.now() - startedAt <= maxWaitSec * 1e3) {
-		await sleep(pollIntervalSec * 1e3);
-		const rawStatus = await requestJson(input, `/v1/video/generations/${encodeURIComponent(taskId)}`, { method: "GET" });
+		await sleep$1(pollIntervalSec * 1e3);
+		const rawStatus = await requestJson$1(input, `/v1/video/generations/${encodeURIComponent(taskId)}`, { method: "GET" });
 		const status = normalizeTaskStatus(rawStatus);
 		if (status.status === "succeeded") {
 			if (!status.videoUrl) throw new GenerationProviderError("Video generation succeeded but returned no video URL", { details: compactObject({
@@ -442,7 +493,7 @@ async function arkVideoGenerationsAdapter(input) {
 
 //#endregion
 //#region src/adapters/gemini-generate-content.ts
-const REQUEST_TIMEOUT_MS$1 = 3e5;
+const REQUEST_TIMEOUT_MS$2 = 3e5;
 const IMAGE_FETCH_TIMEOUT_MS = 6e4;
 const MAX_REFERENCE_IMAGE_BYTES = 10 * 1024 * 1024;
 const DATA_URI_PATTERN = /^data:([^;]+);base64,(.+)$/s;
@@ -580,7 +631,7 @@ async function geminiGenerateContentAdapter(input) {
 			"Content-Type": "application/json"
 		},
 		body: JSON.stringify(payload)
-	}, REQUEST_TIMEOUT_MS$1);
+	}, REQUEST_TIMEOUT_MS$2);
 	if (!response.ok) {
 		const body = await response.text().catch(() => response.statusText);
 		throw new GenerationProviderError("Gemini generation provider request failed", {
@@ -597,7 +648,7 @@ async function geminiGenerateContentAdapter(input) {
 
 //#endregion
 //#region src/adapters/openai-images.ts
-const REQUEST_TIMEOUT_MS = 3e5;
+const REQUEST_TIMEOUT_MS$1 = 3e5;
 function collectOpenAiImagesNoOutputDetails(raw) {
 	const data = raw.data ?? [];
 	return compactObject({
@@ -632,7 +683,7 @@ async function openAiImagesAdapter(input) {
 			"Content-Type": "application/json"
 		},
 		body: JSON.stringify(payload)
-	}, REQUEST_TIMEOUT_MS);
+	}, REQUEST_TIMEOUT_MS$1);
 	if (!response.ok) {
 		const body = await response.text().catch(() => response.statusText);
 		throw new GenerationProviderError("Image generation provider request failed", {
@@ -668,12 +719,322 @@ async function openAiImagesAdapter(input) {
 	return output;
 }
 
+//#endregion
+//#region src/adapters/suno-tasks.ts
+const REQUEST_TIMEOUT_MS = 6e4;
+const DEFAULT_POLL_INTERVAL_SEC = 5;
+const DEFAULT_MAX_WAIT_SEC = 600;
+const DEFAULT_MUSIC_VERSION = "chirp-v5-5";
+const OPERATION_PATHS = {
+	music: {
+		path: "/suno/submit/music",
+		poll: true,
+		defaultMusicVersion: true,
+		textField: "prompt"
+	},
+	lyrics: {
+		path: "/suno/submit/lyrics",
+		poll: true,
+		textField: "prompt",
+		requireText: true
+	},
+	concat: {
+		path: "/suno/submit/concat",
+		poll: true
+	},
+	upsample_tags: {
+		path: "/suno/submit/upsample-tags",
+		poll: false,
+		textField: "original_tags",
+		requireText: true
+	},
+	upload_audio: {
+		path: "/suno/uploads/audio",
+		poll: true
+	}
+};
+const FINAL_SUCCESS_STATUSES = new Set([
+	"success",
+	"succeeded",
+	"completed"
+]);
+const FINAL_FAILURE_STATUSES = new Set([
+	"failure",
+	"failed",
+	"error",
+	"cancelled",
+	"canceled",
+	"expired"
+]);
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isRecord$1(value) {
+	return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function asString(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function asInteger(value, fallback) {
+	return typeof value === "number" && Number.isInteger(value) ? value : fallback;
+}
+function successCode(value) {
+	const code = String(value ?? "").trim().toLowerCase();
+	return code === "success" || code === "200" || code === "0";
+}
+function requireSuccess(response, fallbackMessage) {
+	if (!successCode(response.code)) throw new GenerationProviderError(fallbackMessage, { details: {
+		code: response.code,
+		message: response.message,
+		data: response.data
+	} });
+	return response.data;
+}
+function extractTaskId(value) {
+	if (typeof value === "string" && value.trim()) return value.trim();
+	if (!isRecord$1(value)) return void 0;
+	for (const key of [
+		"task_id",
+		"id",
+		"taskBatchId"
+	]) {
+		const taskId = asString(value[key]);
+		if (taskId) return taskId;
+	}
+}
+function normalizeStatus(value) {
+	return String(value ?? "").trim().toLowerCase();
+}
+function normalizeTask(operation, data) {
+	if (Array.isArray(data)) return data.length > 0 ? normalizeTask(operation, data[0]) : null;
+	if (!isRecord$1(data)) return null;
+	if ("status" in data || "task_id" in data) return data;
+	if (Array.isArray(data.data) && data.data.length > 0) return normalizeTask(operation, data.data[0]);
+	return {
+		action: operation,
+		status: "SUCCESS",
+		data
+	};
+}
+function getOperation(input) {
+	const operation = asString(input.parameters.operation) ?? "music";
+	if (!OPERATION_PATHS[operation]) throw new GenerationValidationError(`Unsupported Suno operation: ${operation}`);
+	return operation;
+}
+async function buildPayload(input, operation) {
+	const payload = { ...input.meta };
+	const config = OPERATION_PATHS[operation];
+	const prompt = mergeTextBlocks(input.declaration, input.request.content);
+	if (prompt && config?.textField && payload[config.textField] === void 0) payload[config.textField] = prompt;
+	if (config?.textField && config.textField !== "prompt" && payload[config.textField] === void 0 && payload.prompt !== void 0) payload[config.textField] = payload.prompt;
+	const audioBlock = input.request.content.find((block) => block.type === "audio");
+	if (audioBlock && payload.url === void 0) payload.url = await input.context.resolveSource(audioBlock.source);
+	const imageBlock = input.request.content.find((block) => block.type === "image");
+	if (imageBlock && payload.image_url === void 0) payload.image_url = await input.context.resolveSource(imageBlock.source);
+	const videoBlock = input.request.content.find((block) => block.type === "video");
+	if (videoBlock && payload.video_url === void 0) payload.video_url = await input.context.resolveSource(videoBlock.source);
+	normalizeMusicTaskPayload(input, operation, payload);
+	if (config?.defaultMusicVersion && payload.mv === void 0 && payload.model_name === void 0) payload.mv = DEFAULT_MUSIC_VERSION;
+	validateSunoPayload(operation, payload);
+	return payload;
+}
+function contentCount(content, type) {
+	return content.filter((block) => block.type === type).length;
+}
+function normalizeMusicTaskPayload(input, operation, payload) {
+	if (operation !== "music") return;
+	const taskField = input.declaration.meta?.taskField ?? "task";
+	const task = asString(payload[taskField]);
+	if (!task) return;
+	const taskVariant = input.declaration.meta?.taskVariants?.[task];
+	if (!taskVariant) throw new GenerationValidationError(`Unsupported Suno music task: ${task}`);
+	for (const key of taskVariant.required ?? []) if (payload[key] === void 0 || payload[key] === null || payload[key] === "") throw new GenerationValidationError(`Suno task ${task} requires meta.${key}`);
+	for (const type of taskVariant.requiredContent ?? []) if (contentCount(input.request.content, type) === 0) throw new GenerationValidationError(`Suno task ${task} requires ${type} content`);
+	if (taskVariant.sendTask === false) delete payload[taskField];
+}
+function validateSunoPayload(operation, payload) {
+	const config = OPERATION_PATHS[operation];
+	const task = asString(payload.task);
+	if (operation === "music" && task) {
+		if (task === "lyrics") throw new GenerationValidationError("Use operation=lyrics instead of task=lyrics");
+	}
+	if (config?.requireText && !asString(payload[config.textField ?? "prompt"])) throw new GenerationValidationError(`${config.textField ?? "prompt"} text is required`);
+	if (operation === "upload_audio" && !asString(payload.url)) throw new GenerationValidationError("Audio url is required for Suno upload_audio");
+	if (operation === "concat" && !asString(payload.clip_id)) throw new GenerationValidationError("clip_id is required for Suno concat");
+}
+async function requestJson(input, path, init) {
+	const response = await fetchWithTimeout(input.context.fetch, joinUrl(input.context.baseUrl, path), {
+		...init,
+		headers: {
+			Authorization: `Bearer ${input.context.apiKey}`,
+			"Content-Type": "application/json",
+			...init.headers
+		}
+	}, REQUEST_TIMEOUT_MS);
+	const body = await response.text();
+	let parsed;
+	try {
+		parsed = body ? JSON.parse(body) : {};
+	} catch {
+		throw new GenerationProviderError("Suno provider returned invalid JSON", {
+			status: response.status,
+			body
+		});
+	}
+	if (!response.ok) throw new GenerationProviderError("Suno provider request failed", {
+		status: response.status,
+		details: { body: parsed }
+	});
+	return parsed;
+}
+function appendUrlBlock(output, type, url, meta) {
+	const value = asString(url);
+	if (!value) return;
+	output.push({
+		type,
+		source: {
+			type: "url",
+			url: value
+		},
+		meta: compactObject(meta)
+	});
+}
+function appendSunoContent(output, value, meta = {}) {
+	if (Array.isArray(value)) {
+		for (const item of value) appendSunoContent(output, item, meta);
+		return;
+	}
+	if (!isRecord$1(value)) return;
+	if (isRecord$1(value.clips)) for (const clip of Object.values(value.clips)) appendSunoContent(output, clip, meta);
+	if (Array.isArray(value.items)) for (const item of value.items) appendSunoContent(output, item, meta);
+	const itemMeta = compactObject({
+		...meta,
+		id: value.id,
+		clip_id: value.clipId ?? value.clip_id ?? meta.clip_id,
+		task_id: value.task_id ?? value.taskId ?? meta.task_id,
+		title: value.title,
+		status: value.status ?? meta.status,
+		model: value.model_name ?? value.modelName,
+		duration: value.duration ?? (isRecord$1(value.metadata) ? value.metadata.duration : void 0),
+		tags: value.tags ?? (isRecord$1(value.metadata) ? value.metadata.tags : void 0),
+		prompt: value.prompt ?? (isRecord$1(value.metadata) ? value.metadata.prompt : void 0),
+		progress: value.progress ?? meta.progress,
+		progress_message: value.progressMsg ?? value.progress_msg,
+		task_batch_id: value.taskBatchId ?? value.task_batch_id,
+		continue_clip_id: value.continueClipId ?? value.continue_clip_id,
+		input_type: value.inputType ?? value.input_type,
+		make_instrumental: value.makeInstrumental ?? value.make_instrumental,
+		created_at: value.createTime ?? value.created_at
+	});
+	appendUrlBlock(output, "audio", value.audio_url ?? value.audioUrl ?? value.cld2AudioUrl ?? value.cld2_audio_url, itemMeta);
+	appendUrlBlock(output, "audio", value.vocal_audio_url ?? value.vocalAudioUrl, itemMeta);
+	appendUrlBlock(output, "audio", value.instrumental_audio_url ?? value.instrumentalAudioUrl, itemMeta);
+	appendUrlBlock(output, "audio", value.source_audio_url ?? value.sourceAudioUrl, itemMeta);
+	appendUrlBlock(output, "video", value.video_url ?? value.videoUrl ?? value.cld2VideoUrl ?? value.cld2_video_url, itemMeta);
+	appendUrlBlock(output, "image", value.image_large_url ?? value.image_url ?? value.imageUrl ?? value.cld2ImageUrl ?? value.cld2_image_url, itemMeta);
+	const text = asString(value.upsampled_tags) ?? asString(value.text) ?? asString(value.lyrics);
+	if (text) output.push({
+		type: "text",
+		text,
+		meta: itemMeta
+	});
+	if (isRecord$1(value.data)) appendSunoContent(output, value.data, itemMeta);
+}
+function buildImmediateResult(operation, data, raw) {
+	const output = [];
+	const metadata = compactObject({
+		operation,
+		raw
+	});
+	appendSunoContent(output, data, metadata);
+	if (output.length > 0) return output;
+	const value = extractTaskId(data) ?? asString(data);
+	if (value) output.push({
+		type: "text",
+		text: value,
+		meta: metadata
+	});
+	return requireSunoOutput(output, "Suno provider returned no output", {
+		operation,
+		raw
+	});
+}
+function requireSunoOutput(output, message, details) {
+	if (output.length === 0) throw new GenerationProviderError(message, { details });
+	return output;
+}
+function buildResult(operation, task, raw) {
+	const output = [];
+	const metadata = compactObject({
+		operation,
+		task_id: task.task_id,
+		action: task.action,
+		status: task.status,
+		fail_reason: task.fail_reason,
+		progress: task.progress,
+		submit_time: task.submit_time,
+		start_time: task.start_time,
+		finish_time: task.finish_time,
+		raw
+	});
+	appendSunoContent(output, task.data, metadata);
+	appendUrlBlock(output, "audio", task.result_url, metadata);
+	return requireSunoOutput(output, "Suno task succeeded but returned no output", {
+		operation,
+		task,
+		raw
+	});
+}
+async function pollSunoTask(input, operation, taskId, pollIntervalSec, maxWaitSec) {
+	const startedAt = Date.now();
+	while (Date.now() - startedAt <= maxWaitSec * 1e3) {
+		await sleep(pollIntervalSec * 1e3);
+		let raw;
+		try {
+			raw = await requestJson(input, `/suno/fetch/${encodeURIComponent(taskId)}`, { method: "GET" });
+		} catch (error) {
+			if (error instanceof GenerationProviderError) throw error;
+			continue;
+		}
+		const data = requireSuccess(raw, "Suno task fetch failed");
+		const task = normalizeTask(operation, data);
+		if (!task) throw new GenerationProviderError("Suno task fetch returned invalid task data", { details: { data } });
+		const status = normalizeStatus(task.status);
+		if (FINAL_SUCCESS_STATUSES.has(status)) return buildResult(operation, task, data);
+		if (FINAL_FAILURE_STATUSES.has(status)) throw new GenerationProviderError("Suno task failed", { details: {
+			task_id: taskId,
+			status: task.status,
+			fail_reason: task.fail_reason
+		} });
+	}
+	throw new GenerationTimeoutError("Timed out waiting for Suno task", {
+		task_id: taskId,
+		operation
+	});
+}
+async function sunoTasksAdapter(input) {
+	const operation = getOperation(input);
+	const payload = await buildPayload(input, operation);
+	const config = OPERATION_PATHS[operation];
+	if (!config) throw new GenerationValidationError(`Unsupported Suno operation: ${operation}`);
+	const raw = await requestJson(input, config.path, {
+		method: "POST",
+		body: JSON.stringify(payload)
+	});
+	const data = requireSuccess(raw, "Suno task submit failed");
+	if (!config.poll) return buildImmediateResult(operation, data, raw);
+	const taskId = extractTaskId(data);
+	if (!taskId) return buildImmediateResult(operation, data, raw);
+	return pollSunoTask(input, operation, taskId, asInteger(input.parameters.poll_interval, DEFAULT_POLL_INTERVAL_SEC), asInteger(input.parameters.max_wait, DEFAULT_MAX_WAIT_SEC));
+}
+
 //#endregion
 //#region src/adapters/index.ts
 const builtinGenerationAdapters = {
 	"ark.videoGenerations": arkVideoGenerationsAdapter,
 	"gemini.generateContent": geminiGenerateContentAdapter,
-	"openai.images": openAiImagesAdapter
+	"openai.images": openAiImagesAdapter,
+	"suno.tasks": sunoTasksAdapter
 };
 function getGenerationAdapter(type, adapters = {}) {
 	const adapter = adapters[type] ?? builtinGenerationAdapters[type];
@@ -700,13 +1061,26 @@ function isParameterSpec(value) {
 		"boolean"
 	].includes(String(value.type));
 }
+function isMetaFieldSpec(value) {
+	if (!isRecord(value)) return false;
+	return isParameterSpec(value) || String(value.type) === "object";
+}
+function isMetaTaskVariantSpec(value) {
+	if (!isRecord(value)) return false;
+	return (value.description === void 0 || typeof value.description === "string") && (value.required === void 0 || Array.isArray(value.required) && value.required.every((item) => typeof item === "string")) && (value.requiredContent === void 0 || Array.isArray(value.requiredContent) && value.requiredContent.every((item) => typeof item === "string")) && (value.sendTask === void 0 || typeof value.sendTask === "boolean");
+}
+function isMetaSpec(value) {
+	if (!isRecord(value)) return false;
+	return (value.fields === void 0 || isRecord(value.fields) && Object.values(value.fields).every((field) => isMetaFieldSpec(field))) && (value.taskField === void 0 || typeof value.taskField === "string") && (value.taskVariants === void 0 || isRecord(value.taskVariants) && Object.values(value.taskVariants).every((variant) => isMetaTaskVariantSpec(variant)));
+}
 function isGenerationModelDeclaration(value) {
 	if (!isRecord(value)) return false;
 	const adapter = value.adapter;
 	const content = value.content;
 	const parameters = value.parameters;
+	const meta = value.meta;
 	const examples = value.examples;
-	return value.schema === MODEL_SCHEMA && typeof value.model === "string" && value.model.trim().length > 0 && isRecord(adapter) && typeof adapter.type === "string" && isRecord(content) && Array.isArray(content.input) && (parameters === void 0 || isRecord(parameters) && Object.values(parameters).every(isParameterSpec)) && (examples === void 0 || Array.isArray(examples));
+	return value.schema === MODEL_SCHEMA && typeof value.model === "string" && value.model.trim().length > 0 && (value.allowUnknownParameters === void 0 || typeof value.allowUnknownParameters === "boolean") && isRecord(adapter) && typeof adapter.type === "string" && isRecord(content) && Array.isArray(content.input) && (parameters === void 0 || isRecord(parameters) && Object.values(parameters).every(isParameterSpec)) && (meta === void 0 || isMetaSpec(meta)) && (examples === void 0 || Array.isArray(examples));
 }
 function parseGenerationModelDeclaration(rawText, filePath = "model.yaml") {
 	const parsed = extname(filePath) === ".json" ? JSON.parse(rawText) : parse(rawText);
@@ -805,10 +1179,15 @@ function createGenerationClient(options = {}) {
 			const declaration = requireModel(request.model);
 			validateGenerationContent(declaration, request.content);
 			const parameters = resolveGenerationParameters(declaration, request.parameters);
+			const meta = resolveGenerationMeta(declaration, mergeGenerationMeta({
+				...request.metadata ?? {},
+				...request.meta ?? {}
+			}, request.content), request.content);
 			return {
 				declaration: cloneJson(declaration),
 				request: cloneJson(request),
-				parameters
+				parameters,
+				meta
 			};
 		},
 		async generate(request) {
@@ -880,5 +1259,5 @@ async function exportBuiltinModelConfigs(directory) {
 }
 
 //#endregion
-export { GenerationUnsupportedAdapterError as A, mergeTextBlocks as C, GenerationError as D, GenerationConfigError as E, GenerationProviderError as O, arkVideoGenerationsAdapter as S, validateGenerationContent as T, writeGenerationModelDeclarations as _, createGenerationClientFromDirectory as a, openAiImagesAdapter as b, defaultGenerationSourceResolver as c, parseGenerationModelDeclaration as d, readGenerationModelDeclaration as f, writeGenerationModelDeclaration as g, stringifyGenerationModelDeclaration as h, createGenerationClient as i, GenerationValidationError as j, GenerationTimeoutError as k, isGenerationModelDeclaration as l, readGenerationModelDeclarationsFromFiles as m, exportBuiltinModelConfigs as n, createGenerationClientFromFile as o, readGenerationModelDeclarationsFromDirectory as p, stringifyBuiltinModelConfig as r, createGenerationClientFromFiles as s, exportBuiltinModelConfig as t, mergeGenerationModelDeclarations as u, builtinGenerationAdapters as v, resolveGenerationParameters as w, geminiGenerateContentAdapter as x, getGenerationAdapter as y };
-//# sourceMappingURL=export-config-BPnZYpmN.js.map
+export { GenerationError as A, arkVideoGenerationsAdapter as C, resolveGenerationParameters as D, resolveGenerationMeta as E, GenerationTimeoutError as M, GenerationUnsupportedAdapterError as N, validateGenerationContent as O, GenerationValidationError as P, geminiGenerateContentAdapter as S, mergeTextBlocks as T, writeGenerationModelDeclarations as _, createGenerationClientFromDirectory as a, sunoTasksAdapter as b, defaultGenerationSourceResolver as c, parseGenerationModelDeclaration as d, readGenerationModelDeclaration as f, writeGenerationModelDeclaration as g, stringifyGenerationModelDeclaration as h, createGenerationClient as i, GenerationProviderError as j, GenerationConfigError as k, isGenerationModelDeclaration as l, readGenerationModelDeclarationsFromFiles as m, exportBuiltinModelConfigs as n, createGenerationClientFromFile as o, readGenerationModelDeclarationsFromDirectory as p, stringifyBuiltinModelConfig as r, createGenerationClientFromFiles as s, exportBuiltinModelConfig as t, mergeGenerationModelDeclarations as u, builtinGenerationAdapters as v, mergeGenerationMeta as w, openAiImagesAdapter as x, getGenerationAdapter as y };
+//# sourceMappingURL=export-config-D8By2_r7.js.map