tongflow 0.1.0 → 1.0.0

package/dist/index.js

@@ -502,7 +502,11 @@ const ABI_NODES = {
 			properties: {
 				success: { type: "boolean" },
 				error: { type: "string" },
-				text: { type: "string" }
+				text: { type: "string" },
+				images: {
+					type: "array",
+					items: { $ref: "#/$defs/ImageRef" }
+				}
 			},
 			additionalProperties: false
 		}
@@ -618,6 +622,34 @@ const ABI_NODES = {
 			additionalProperties: false
 		}
 	},
+	"text-gen-audio": {
+		inputs: {
+			type: "object",
+			required: ["text"],
+			properties: {
+				text: {
+					type: "string",
+					minLength: 1
+				},
+				ref_audios: {
+					type: "array",
+					items: { $ref: "#/$defs/Asset" }
+				},
+				seed: { type: "integer" }
+			},
+			additionalProperties: false
+		},
+		outputs: {
+			type: "object",
+			required: ["success"],
+			properties: {
+				success: { type: "boolean" },
+				error: { type: "string" },
+				audio: { $ref: "#/$defs/AudioRef" }
+			},
+			additionalProperties: false
+		}
+	},
 	"text-gen-speech-preset": {
 		inputs: {
 			type: "object",
@@ -1487,10 +1519,10 @@ const ABI_NODES = {
 	convert_voice: {
 		inputs: {
 			type: "object",
-			required: ["sourceKey", "targetKey"],
+			required: ["audio", "ref_audio"],
 			properties: {
-				sourceKey: { $ref: "#/$defs/Asset" },
-				targetKey: { type: "string" }
+				audio: { $ref: "#/$defs/Asset" },
+				ref_audio: { $ref: "#/$defs/Asset" }
 			},
 			additionalProperties: false
 		},
@@ -2127,6 +2159,7 @@ const NODE_TYPE_TO_ABI_FEATURE = {
 	imageGenImageUpscaleNode: "image-upscale",
 	textGenImageNode: "image-gen",
 	textGenMusicNode: "gen-music",
+	textGenAudioNode: "text-gen-audio",
 	textGenSpeechCloneNode: "text-gen-speech-clone",
 	textGenSpeechCloneComposeNode: "text-gen-speech-clone",
 	imageGenVideoComposeNode: "image-gen-video",
@@ -2250,6 +2283,18 @@ const NODE_TYPE_SOURCE_SPEC = {
 			manual: true
 		})
 	},
+	musicCoverNode: {
+		text: handle({
+			nodeType: "textNode",
+			path: "texts[0]",
+			manual: true
+		}),
+		lyrics: handle({
+			nodeType: "textNode",
+			path: "texts[0]",
+			manual: true
+		})
+	},
 	textGenSpeechCloneComposeNode: { text: batchOn({
 		nodeType: "textNode",
 		path: "texts"
@@ -2287,7 +2332,10 @@ const NODE_TYPE_SOURCE_SPEC = {
 	audioGenTextSpeechRecognizeNode: { audio: batchOn() },
 	concatVideoComposeNode: { videos: collectAll() },
 	concatVideoNode: { videos: collectAll() },
-	convertVoiceNode: { sourceKey: batchOn({ nodeType: "audioNode" }) },
+	convertVoiceNode: {
+		audio: batchOn({ nodeType: "audioNode" }),
+		ref_audio: handle({ nodeType: "audioNode" })
+	},
 	denoiseAudioSubtitleNode: { fileKey: batchOn({ nodeType: "audioNode" }) },
 	dropVideoNode: { videos: collectAll() },
 	extractAudioNode: { video: batchOn() },
@@ -2335,6 +2383,14 @@ const NODE_TYPE_SOURCE_SPEC = {
 			path: "texts[0]"
 		})
 	},
+	textGenAudioNode: {
+		text: handle({
+			nodeType: "textNode",
+			path: "texts[0]",
+			manual: true
+		}),
+		ref_audios: collectAll({ nodeType: "audioNode" })
+	},
 	textGenSpeechCloneNode: {
 		text: batchOn({
 			nodeType: "textNode",
@@ -2579,6 +2635,381 @@ function getEdgeTargetOptions(edge, nodes) {
 	return options;
 }
 //#endregion
+//#region src/core/abi/node-actions.ts
+const MEDIA_TYPES = [
+	"imageNode",
+	"videoNode",
+	"audioNode"
+];
+/**
+* Per-node-type presentation + caps. Every ABI node type must appear here (a
+* vitest guard fails otherwise) so a new slot can't quietly end up without an
+* entry point. Order groups by the modality a button hangs off: text 100s,
+* image 200s, video 300s, audio 400s, document/link/model 500s, combos 600s.
+*/
+const NODE_ACTION_META = {
+	splitTextNode: {
+		label: "splitText",
+		order: 100
+	},
+	genTextNode: {
+		label: "generateText",
+		order: 110
+	},
+	textGenImageNode: {
+		label: "generateImage",
+		order: 120
+	},
+	textGenMusicNode: {
+		label: "generateMusic",
+		order: 130,
+		limits: { textNode: [1, 2] }
+	},
+	textGenAudioNode: {
+		label: "generateAudio",
+		order: 135
+	},
+	textGenSpeechCloneNode: {
+		label: "textToSpeechClone",
+		order: 140
+	},
+	textGenSpeechPresetNode: {
+		label: "textToSpeechPreset",
+		order: 150
+	},
+	textGenSpeechInstructNode: {
+		label: "textToSpeechInstruct",
+		order: 160
+	},
+	textGenVideoNode: {
+		label: "generateVideo",
+		order: 170
+	},
+	musicBriefNode: {
+		label: "musicBrief",
+		order: 180
+	},
+	textsGenTextNode: {
+		label: "rewriteText",
+		order: 190,
+		limits: { textNode: [2, Number.POSITIVE_INFINITY] }
+	},
+	imageGenTextNode: {
+		label: "describeReverse",
+		order: 200,
+		aliases: { modelNode: "imageNode" }
+	},
+	imageGenVideoNode: {
+		label: "generateVideo",
+		order: 210,
+		aliases: { modelNode: "imageNode" }
+	},
+	imageGenVideoComposeNode: {
+		label: "generateVideo",
+		order: 211
+	},
+	imageGenImageNode: {
+		label: "editImage",
+		order: 220
+	},
+	imageGenImageUpscaleNode: {
+		label: "upscale",
+		order: 230
+	},
+	imageGenModelNode: {
+		label: "generate3D",
+		order: 240
+	},
+	imagePoseNode: {
+		label: "detectPose",
+		order: 250
+	},
+	imageBodySegNode: {
+		label: "segmentBody",
+		order: 260
+	},
+	imageNormalNode: {
+		label: "estimateNormal",
+		order: 270
+	},
+	imageMattingNode: {
+		label: "extractForeground",
+		order: 280
+	},
+	imageFusionNode: {
+		label: "imageFusion",
+		order: 290,
+		limits: { imageNode: [2, 14] }
+	},
+	imagesGenVideoNode: {
+		label: "imagesGenVideo",
+		order: 291,
+		limits: { imageNode: [2, 9] }
+	},
+	imageImageGenVideoNode: {
+		label: "firstLastFrameVideo",
+		order: 292,
+		limits: { imageNode: [2, 2] }
+	},
+	videoGenTextNode: {
+		label: "describeReverse",
+		order: 300
+	},
+	videoGenTextSpeechRecognizeNode: {
+		label: "speechRecognize",
+		order: 310
+	},
+	videoUpscaleNode: {
+		label: "upscale",
+		order: 320
+	},
+	videoGenModelNode: {
+		label: "captureMotion",
+		order: 330
+	},
+	videoEditNode: {
+		label: "editVideo",
+		order: 340
+	},
+	extractAudioNode: {
+		label: "extractAudioTrack",
+		order: 350
+	},
+	removeVideoAudioNode: {
+		label: "removeVideoAudio",
+		order: 360
+	},
+	removeWatermarkNode: {
+		label: "removeWatermark",
+		order: 365
+	},
+	removeVideoSubtitleNode: {
+		label: "removeSubtitle",
+		order: 366
+	},
+	splitVideoNode: {
+		label: "slice",
+		order: 370
+	},
+	getFirstFrameNode: {
+		label: "firstFrame",
+		order: 380
+	},
+	getLastFrameNode: {
+		label: "lastFrame",
+		order: 390
+	},
+	dropVideoNode: {
+		label: "filter",
+		order: 391,
+		groupOnly: true
+	},
+	arrangeNode: {
+		label: "arrange",
+		order: 392,
+		groupOnly: true
+	},
+	concatVideoNode: {
+		label: "concat",
+		order: 393,
+		groupOnly: true
+	},
+	concatVideoComposeNode: {
+		label: "concat",
+		order: 394,
+		minNodes: 2
+	},
+	audioDescribeNode: {
+		label: "describeReverse",
+		order: 400
+	},
+	audioGenTextSpeechRecognizeNode: {
+		label: "speechRecognize",
+		order: 410
+	},
+	separateAudioTrackNode: {
+		label: "separateAudio",
+		order: 420
+	},
+	separateSpeakerNode: {
+		label: "separateSpeaker",
+		order: 430
+	},
+	separateSoundNode: {
+		label: "separateSound",
+		order: 440
+	},
+	denoiseAudioSubtitleNode: {
+		label: "denoise",
+		order: 450
+	},
+	convertVoiceNode: {
+		label: "convertVoice",
+		order: 460
+	},
+	musicRepaintNode: {
+		label: "repaintMusic",
+		order: 470
+	},
+	musicCoverNode: {
+		label: "coverMusic",
+		order: 480
+	},
+	musicExtractNode: {
+		label: "extractStem",
+		order: 490
+	},
+	musicLegoNode: {
+		label: "addTrack",
+		order: 491
+	},
+	musicCompleteNode: {
+		label: "completeMusic",
+		order: 492
+	},
+	fileGenTextNode: {
+		label: "parseDocument",
+		order: 500
+	},
+	linkGenTextNode: {
+		label: "extractContent",
+		order: 510
+	},
+	audioVideoLipSyncNode: {
+		label: "lipSync",
+		order: 600
+	},
+	mergeVideoAudioNode: {
+		label: "merge",
+		order: 610
+	},
+	speechVideoGenVideoNode: {
+		label: "lipDub",
+		order: 620
+	},
+	videoImageGenVideoMoveNode: {
+		label: "videoTransfer",
+		order: 630
+	},
+	videoImageGenVideoMixNode: {
+		label: "characterReplace",
+		order: 640
+	},
+	speechImageGenVideoNode: {
+		label: "generateVideo",
+		order: 650
+	},
+	speechTextGenVideoNode: {
+		label: "generateVideo",
+		order: 660
+	},
+	speechGenVideoNode: {
+		label: "generateVideo",
+		order: 661
+	},
+	textAudioGenSpeechNode: {
+		label: "speakWithStyle",
+		order: 670
+	},
+	textGenSpeechCloneComposeNode: {
+		label: "cloneVoice",
+		order: 680
+	},
+	refsGenVideoNode: {
+		label: "refsGenVideo",
+		order: 690,
+		minNodes: 2,
+		limits: {
+			imageNode: [0, 9],
+			videoNode: [0, 3],
+			audioNode: [0, 3],
+			textNode: [0, 1]
+		},
+		totalMedia: [1, 12]
+	}
+};
+function capacities(nodeType) {
+	const spec = resolvedSpecForNodeType(nodeType);
+	if (!spec) return void 0;
+	const caps = {};
+	for (const field of spec.topology.inputOrder) {
+		const f = spec.fields[field];
+		if (f?.kind !== "handle") continue;
+		const cap = caps[f.nodeType] ?? {
+			max: 0,
+			min: 0
+		};
+		caps[f.nodeType] = cap;
+		cap.max = f.array || f.collect === true ? Number.POSITIVE_INFINITY : cap.max + 1;
+		if (f.required && !f.manual) cap.min = Math.max(cap.min, 1);
+	}
+	return caps;
+}
+/** Fold aliased modalities into the modality they stand in for. */
+function applyAliases(counts, aliases) {
+	if (!aliases) return counts;
+	const out = { ...counts };
+	for (const [from, to] of Object.entries(aliases)) {
+		const n = out[from];
+		if (!n) continue;
+		out[to] = (out[to] ?? 0) + n;
+		delete out[from];
+	}
+	return out;
+}
+function withinLimits(counts, meta) {
+	for (const [type, range] of Object.entries(meta.limits ?? {})) {
+		const n = counts[type] ?? 0;
+		if (n < range[0] || n > range[1]) return false;
+	}
+	if (meta.totalMedia) {
+		const total = MEDIA_TYPES.reduce((sum, t) => sum + (counts[t] ?? 0), 0);
+		if (total < meta.totalMedia[0] || total > meta.totalMedia[1]) return false;
+	}
+	return true;
+}
+/**
+* Node types the given selection can be turned into, ordered for display.
+*
+* `counts` holds only modality nodes — the caller drops processing nodes and
+* `add*` nodes before calling, since neither carries an output to feed.
+*/
+function nodeActionsForSelection(counts, options = {}) {
+	const total = Object.values(counts).reduce((sum, n) => sum + (n ?? 0), 0);
+	const out = [];
+	for (const [nodeType, meta] of Object.entries(NODE_ACTION_META)) {
+		if (meta.groupOnly && !(options.group && total === 1)) continue;
+		if (meta.minNodes && total < meta.minNodes) continue;
+		const caps = capacities(nodeType);
+		if (!caps) continue;
+		const effective = applyAliases(counts, meta.aliases);
+		if (!withinLimits(effective, meta)) continue;
+		const modalities = /* @__PURE__ */ new Set([...Object.keys(caps), ...Object.keys(effective)]);
+		let ok = true;
+		for (const modality of modalities) {
+			const n = effective[modality] ?? 0;
+			const cap = caps[modality] ?? {
+				max: 0,
+				min: 0
+			};
+			if (n > cap.max || n < cap.min) {
+				ok = false;
+				break;
+			}
+		}
+		if (!ok) continue;
+		const feature = NODE_TYPE_TO_ABI_FEATURE[nodeType];
+		if (!feature) continue;
+		out.push({
+			nodeType,
+			feature,
+			label: meta.label,
+			order: meta.order
+		});
+	}
+	return out.sort((a, b) => a.order - b.order);
+}
+//#endregion
 //#region src/core/workflow/connection-validator.ts
 function resolveRefs(schema, depth = 0) {
 	if (depth > 48 || typeof schema !== "object" || schema === null) return schema ?? {};
@@ -3490,6 +3921,7 @@ function applyGraphPatch(store, patch, options = {}) {
 		const nodeData = { ...data };
 		if (spec.pluginId) nodeData.pluginId = spec.pluginId;
 		if (spec.pluginModel) nodeData.pluginModel = spec.pluginModel;
+		if (spec.pluginParams && Object.keys(spec.pluginParams).length > 0) nodeData.pluginParams = { ...spec.pluginParams };
 		const edgeIdx = pendingEdges.findIndex((e) => {
 			if (e.to !== spec.alias) return false;
 			return !!resolveNodeRef(e.from, store.getState().nodes, aliases).id;
@@ -3839,6 +4271,11 @@ const TONGFLOW_TOOL_DEFS = [
 								type: "string",
 								description: "Optional model id, only for plugins that advertise models."
 							},
+							pluginParams: {
+								type: "object",
+								description: "Optional advanced parameters, only keys the plugin advertises for this slot.",
+								additionalProperties: true
+							},
 							fromAttachment: {
 								type: "integer",
 								description: "1-based index of a file the user attached to the chat. Use this for add*Node/modality nodes carrying user uploads — never write a storage key yourself."
@@ -4694,7 +5131,11 @@ var tongflow_abi_default = {
 				"properties": {
 					"success": { "type": "boolean" },
 					"error": { "type": "string" },
-					"text": { "type": "string" }
+					"text": { "type": "string" },
+					"images": {
+						"type": "array",
+						"items": { "$ref": "#/$defs/ImageRef" }
+					}
 				},
 				"additionalProperties": false
 			}
@@ -4814,6 +5255,35 @@ var tongflow_abi_default = {
 				"additionalProperties": false
 			}
 		},
+		{
+			"nodeSlot": "text-gen-audio",
+			"inputs": {
+				"type": "object",
+				"required": ["text"],
+				"properties": {
+					"text": {
+						"type": "string",
+						"minLength": 1
+					},
+					"ref_audios": {
+						"type": "array",
+						"items": { "$ref": "#/$defs/Asset" }
+					},
+					"seed": { "type": "integer" }
+				},
+				"additionalProperties": false
+			},
+			"outputs": {
+				"type": "object",
+				"required": ["success"],
+				"properties": {
+					"success": { "type": "boolean" },
+					"error": { "type": "string" },
+					"audio": { "$ref": "#/$defs/AudioRef" }
+				},
+				"additionalProperties": false
+			}
+		},
 		{
 			"nodeSlot": "text-gen-speech-preset",
 			"inputs": {
@@ -5716,10 +6186,10 @@ var tongflow_abi_default = {
 			"nodeSlot": "convert_voice",
 			"inputs": {
 				"type": "object",
-				"required": ["sourceKey", "targetKey"],
+				"required": ["audio", "ref_audio"],
 				"properties": {
-					"sourceKey": { "$ref": "#/$defs/Asset" },
-					"targetKey": { "type": "string" }
+					"audio": { "$ref": "#/$defs/Asset" },
+					"ref_audio": { "$ref": "#/$defs/Asset" }
 				},
 				"additionalProperties": false
 			},
@@ -6099,6 +6569,103 @@ const resolveLabelLookupFeatureName = clientRegistry.resolveLabelLookupFeatureNa
 const getFeatureByName = clientRegistry.getFeatureByName;
 const getFeatureRegistryAliases = clientRegistry.getFeatureRegistryAliases;
 //#endregion
+//#region src/core/registry/model-catalog.ts
+/** Read a dot-path (`a.b.c`) off an unknown JSON value; `undefined` when absent. */
+function getPath(value, path) {
+	let cur = value;
+	for (const key of path.split(".")) {
+		if (cur === null || typeof cur !== "object") return void 0;
+		cur = cur[key];
+	}
+	return cur;
+}
+/** Substring match against the field's JSON serialization (strings as-is). */
+function fieldContains(value, token) {
+	if (value === void 0 || value === null) return false;
+	return (typeof value === "string" ? value : JSON.stringify(value)).includes(token);
+}
+/**
+* Filter a fetched catalog payload into `slot -> model ids`, applying the
+* plugin's declared `exclude` and per-slot `slots` rules (substring tokens,
+* `!`-prefixed = must be absent). Ids keep catalog order; malformed records
+* are skipped. Pure — the fetch lives in the canvas.
+*/
+function filterModelCatalog(catalog, payload) {
+	const out = {};
+	for (const slot of Object.keys(catalog.slots)) out[slot] = [];
+	const items = getPath(payload, catalog.items);
+	if (!Array.isArray(items)) return out;
+	const exclude = Object.entries(catalog.exclude ?? {});
+	for (const record of items) {
+		const id = getPath(record, catalog.id);
+		if (typeof id !== "string" || !id.trim()) continue;
+		if (exclude.some(([field, literal]) => getPath(record, field) === literal)) continue;
+		for (const [slot, rules] of Object.entries(catalog.slots)) if (Object.entries(rules).every(([field, tokens]) => {
+			const value = getPath(record, field);
+			return (Array.isArray(tokens) ? tokens : [tokens]).every((token) => token.startsWith("!") ? !fieldContains(value, token.slice(1)) : fieldContains(value, token));
+		}) && !out[slot].includes(id)) out[slot].push(id);
+	}
+	return out;
+}
+//#endregion
+//#region src/core/registry/plugin-params.ts
+/**
+* The params a node offers for the active plugin + model: every declared entry
+* whose `models` gate is absent or names the selected model.
+*/
+function visiblePluginParams(params, model) {
+	if (!params) return [];
+	const out = [];
+	for (const [name, spec] of Object.entries(params)) {
+		if (spec.models && !(model && spec.models.includes(model))) continue;
+		out.push({
+			name,
+			spec
+		});
+	}
+	return out;
+}
+/** True when `value` is a legal setting for `spec` (type + range/options). */
+function isValidPluginParamValue(spec, value) {
+	switch (spec.type) {
+		case "select": return (spec.options ?? []).some((o) => o === value);
+		case "boolean": return typeof value === "boolean";
+		case "text": return typeof value === "string";
+		case "number":
+		case "integer":
+			if (typeof value !== "number" || !Number.isFinite(value)) return false;
+			if (spec.type === "integer" && !Number.isInteger(value)) return false;
+			if (spec.min !== void 0 && value < spec.min) return false;
+			if (spec.max !== void 0 && value > spec.max) return false;
+			return true;
+		default: return false;
+	}
+}
+/**
+* Keep only the entries of `values` that the visible params accept and that
+* differ from the declared default. Unset means "plugin default", so a value
+* equal to it is dropped; the result is what travels to the plugin.
+*/
+function normalizePluginParams(entries, values) {
+	const out = {};
+	if (!values) return out;
+	for (const { name, spec } of entries) {
+		if (!(name in values)) continue;
+		const v = values[name];
+		if (!isValidPluginParamValue(spec, v)) continue;
+		if (spec.default !== void 0 && v === spec.default) continue;
+		out[name] = v;
+	}
+	return out;
+}
+/** Shallow key/value equality for two param records. */
+function samePluginParams(a, b) {
+	const ka = Object.keys(a ?? {});
+	const kb = Object.keys(b ?? {});
+	if (ka.length !== kb.length) return false;
+	return ka.every((k) => Object.is(a?.[k], b?.[k]));
+}
+//#endregion
 //#region src/core/registry/plugins-registry-schema.ts
 /**
 * Plugins registry produced by the Python scanner over `plugins/*`.
@@ -6116,12 +6683,75 @@ const getFeatureRegistryAliases = clientRegistry.getFeatureRegistryAliases;
 *   the first plugin in directory order.
 * - plugins[pluginId]: how to launch that plugin's entry
 */
+/**
+* One entry of a plugin's `TONGFLOW_SLOT_PARAMS` declaration: a plugin-specific
+* run-time knob the node offers under its collapsed "Advanced" section. These
+* are never ABI fields — the canvas sends the user's picks top-level as
+* `params` and the plugin reads them via `tongflow.slots.current_params()`,
+* falling back to its own defaults for anything unset.
+*/
+const paramLiteral = z.union([
+	z.string(),
+	z.number(),
+	z.boolean()
+]);
+const PluginParamSpecSchema = z.object({
+	type: z.enum([
+		"select",
+		"number",
+		"integer",
+		"boolean",
+		"text"
+	]),
+	label: z.string().min(1).optional(),
+	description: z.string().min(1).optional(),
+	default: paramLiteral.optional(),
+	/** `select` only. */
+	options: z.array(z.union([z.string(), z.number()])).min(1).optional(),
+	/** `number` / `integer` only. */
+	min: z.number().optional(),
+	max: z.number().optional(),
+	step: z.number().optional(),
+	/** When set, only offered while one of these router models is selected. */
+	models: z.array(z.string().min(1)).min(1).optional()
+});
 const PluginMethodSchema = z.object({
 	methodName: z.string().min(1),
 	/** Optional per-slot model ids a router-style plugin exposes
 	* (`TONGFLOW_SLOT_MODELS` in the plugin source); first entry is the
 	* default. Absent for single-model plugins. */
-	models: z.array(z.string().min(1)).optional()
+	models: z.array(z.string().min(1)).optional(),
+	/** Optional per-slot advanced parameters (`TONGFLOW_SLOT_PARAMS` in the
+	* plugin source), in declared order. Absent when the plugin exposes none. */
+	params: z.record(z.string().min(1), PluginParamSpecSchema).optional()
+});
+/**
+* Optional live model catalog (`TONGFLOW_MODEL_CATALOG` in the plugin source).
+* The canvas GETs `url` in the browser (public, CORS-enabled, no auth) — or,
+* when `authEnv` names the env key holding a bearer token, through the app's
+* `/api/plugins/model-catalog` route, which injects the stored key server-side
+* — reads the record array at dot-path `items`, each model id at dot-path `id`, drops
+* records where an `exclude` field equals its literal, and keeps a record for
+* a slot when every `slots[slot]` token is a substring of the named field
+* (arrays/objects are JSON-serialized before matching; a token prefixed with
+* `!` must be absent instead). Matching ids extend
+* that slot's dropdown after the static `models` shortlist.
+*/
+const PluginModelCatalogSchema = z.object({
+	url: z.string().url(),
+	/** Env key whose value is sent as `Authorization: Bearer …`; the fetch is
+	* proxied server-side so the key never reaches the browser. */
+	authEnv: z.string().min(1).optional(),
+	items: z.string().min(1).default("data"),
+	id: z.string().min(1).default("id"),
+	exclude: z.record(z.string().min(1), z.union([
+		z.string(),
+		z.boolean(),
+		z.number()
+	])).optional(),
+	/** slot -> field -> token(s). Every token must be a substring of the
+	* field's JSON; a token prefixed with `!` must be absent. */
+	slots: z.record(z.string().min(1), z.record(z.string().min(1), z.union([z.string().min(1), z.array(z.string().min(1)).min(1)])))
 });
 const PluginConfigSchema = z.object({
 	/** Relative to repo root, e.g. `plugins/tongflow-<runner>-foo` */
@@ -6136,6 +6766,8 @@ const PluginConfigSchema = z.object({
 	* such as Modal): its entry.py deploys once before invoking. Informational —
 	* the deploy step lives inside the plugin's entry.py. */
 	needsDeploy: z.boolean().optional(),
+	/** Live model catalog the canvas can fetch to extend the model dropdown. */
+	modelCatalog: PluginModelCatalogSchema.optional(),
 	/** Presentation-only metadata merged in from `tongflow.plugin.json`'s
 	* top-level `plugin` block (name/description/icon). Not produced by the
 	* scanner; attached by the registry API route for the node picker. */
@@ -6261,6 +6893,10 @@ const NODE_SIZE_TABLE = {
 		w: 520,
 		h: 480
 	},
+	textGenAudioNode: {
+		w: 480,
+		h: 480
+	},
 	musicExtractNode: {
 		w: 420,
 		h: 400
@@ -6765,7 +7401,7 @@ function createFlowSlice(set, get, options = {}) {
 			if (newlyCreatedIds.length > 0) get().nodeCreatedCallbacks.forEach((cb) => cb(newlyCreatedIds));
 			return ids;
 		},
-		compose: ({ type, data }) => {
+		compose: ({ type, data, sourceOrder }) => {
 			get().commitHistory();
 			const { comboSelectedIds, nodes, edges } = get();
 			const nodeId = createId();
@@ -6793,7 +7429,7 @@ function createFlowSlice(set, get, options = {}) {
 				data: data ?? {}
 			};
 			const usedTargetHandles = /* @__PURE__ */ new Set();
-			const newEdges = Array.from(comboSelectedIds).map((id) => {
+			const newEdges = (sourceOrder ? [...sourceOrder.filter((id) => comboSelectedIds.has(id)), ...Array.from(comboSelectedIds).filter((id) => !sourceOrder.includes(id))] : Array.from(comboSelectedIds)).map((id) => {
 				const node = nodes.find((n) => n.id === id);
 				if (!node) return null;
 				const { sourceHandle, targetHandle } = resolveEdgeHandles({
@@ -6909,6 +7545,16 @@ function getUpstreamNodeData(nodeId, nodes, edges) {
 		}];
 	});
 }
+/**
+* Workflow input name for a level-0 data / add node: an explicit
+* `data.inputName` (a-z, 0-9, _ , -; set by authors so bindings read
+* `refs`, `prompt` …) else the legacy `input_<id8>`.
+*/
+function inputNameFor(nodeId, nodeData) {
+	const custom = nodeData.inputName;
+	if (typeof custom === "string" && /^[A-Za-z][A-Za-z0-9_-]{0,63}$/.test(custom)) return custom;
+	return `input_${nodeId.substring(0, 8)}`;
+}
 var WorkflowExporter = class {
 	nodes;
 	edges;
@@ -7019,16 +7665,14 @@ var WorkflowExporter = class {
 		const texts = nodeData.texts;
 		const hasStaticData = fileKeys && fileKeys.length > 0 || texts && texts.length > 0;
 		const isInput = this.parser.getStartNodes().includes(node.id) && !hasStaticData;
-		if (isInput) {
-			const inputName = `input_${node.id.substring(0, 8)}`;
-			inputs.push({
-				name: inputName,
-				type: dataTypeInfo.outputField === "texts" ? "text[]" : "file[]",
-				description: `Input data for ${nodeType}`,
-				required: true,
-				nodeId: node.id
-			});
-		}
+		const inputName = inputNameFor(node.id, nodeData);
+		if (isInput) inputs.push({
+			name: inputName,
+			type: dataTypeInfo.outputField === "texts" ? "text[]" : "file[]",
+			description: `Input data for ${nodeType}`,
+			required: true,
+			nodeId: node.id
+		});
 		const label = nodeData.label;
 		const comment = nodeData.comment;
 		return {
@@ -7038,7 +7682,7 @@ var WorkflowExporter = class {
 			label,
 			comment,
 			isInput,
-			inputName: isInput ? `input_${node.id.substring(0, 8)}` : void 0,
+			inputName: isInput ? inputName : void 0,
 			staticData: hasStaticData ? {
 				fileKeys,
 				texts
@@ -7083,7 +7727,7 @@ var WorkflowExporter = class {
 			const dataTypeInfo = DATA_NODE_TYPES[outputType];
 			if (dataTypeInfo) {
 				const isInput = level === 0;
-				const inputName = `input_${node.id.substring(0, 8)}`;
+				const inputName = inputNameFor(node.id, nodeData);
 				if (isInput) inputs.push({
 					name: inputName,
 					type: dataTypeInfo.outputField === "texts" ? "text[]" : "file[]",
@@ -7209,12 +7853,14 @@ var WorkflowExporter = class {
 		}));
 		const pluginId = typeof nodeData.pluginId === "string" ? nodeData.pluginId.trim() : "";
 		const model = typeof nodeData.pluginModel === "string" ? nodeData.pluginModel.trim() : "";
+		const params = nodeData.pluginParams && typeof nodeData.pluginParams === "object" && !Array.isArray(nodeData.pluginParams) && Object.keys(nodeData.pluginParams).length > 0 ? { ...nodeData.pluginParams } : void 0;
 		return {
 			id: node.id,
 			type: nodeType,
 			feature: ns.abi.feature,
 			pluginId,
 			...model ? { model } : {},
+			...params ? { params } : {},
 			label,
 			comment,
 			locked,
@@ -7458,4 +8104,4 @@ function coerceBaseNodeData(data) {
 	return {};
 }
 //#endregion
-export { ABI_DEFINITIONS, ABI_NODES, ADD_NODE_OUTPUT_TYPE, ADD_NODE_TYPES, COMPONENT_V_GAP, DATA_NODE_TYPES, FeatureRegistryBundleSchema, HISTORY_LIMIT, H_GAP, IMAGE_ASPECT_RATIOS, IMAGE_RESOLUTION_TIERS, KNOWN_NODE_TYPES, MEDIA_NODE_MAX_DISPLAY_WIDTH_PX, MEDIA_NODE_MIN_DISPLAY_WIDTH_PX, MEDIA_NODE_REF_DISPLAY_WIDTH_PX, MEDIA_NODE_REF_LONG_EDGE_PX, MIN_SUPPORTED_ABI_VERSION, MODALITY_NODE_TYPES, NODE_TYPE_SOURCE_SPEC, NODE_TYPE_TO_ABI_FEATURE, NodeStatus, PluginConfigSchema, PluginMethodSchema, PluginsRegistrySchema, RUNNING_STATUSES, SHORT_ID_LENGTH, TERMINAL_STATUSES, TONGFLOW_ABI_NODES, TONGFLOW_ABI_VERSION, TONGFLOW_TOOL_DEFS, TONGFLOW_TOOL_NAMES, TaskStatus, VIDEO_ASPECT_RATIOS, VIDEO_DURATIONS, VIDEO_DURATION_DEFAULT, VIDEO_DURATION_MAX, VIDEO_DURATION_MIN, V_GAP, WORKFLOW_IMPORT_NO_CANVAS, WorkflowExecutor, WorkflowExporter, WorkflowParser, WorkflowStatus, abiSpecForNodeType, addEdgeIfAbsent, applyGraphPatch, batchOn, buildFeatureRegistry, buildPrompts, bumpFocusGeneration, clampVideoDuration, closestNodeTypes, coerceBaseNodeData, collectAll, collectHandleValues, compareAbiProducerConsumerSchemas, componentsContaining, computeAutoLayout, configField, createFlowSlice, createFlowStore, currentFocusGeneration, describeNodeType, edgeShapeError, estimateNodeSize, executeGraphTool, exportWorkflow, featureForNodeType, getAbiNodeBySlot, getAbiOutputRoutesBySlot, getAbiTopology, getAllFeatures, getAspectRatioIconSize, getEdgeTargetOptions, getEffectiveOutputType, getFeatureByName, getFeatureRegistryAliases, getValueByPath, getWorkflowEndNodes, getWorkflowStartNodes, handle, hasDuplicateAddSourceEdge, hasDuplicateTargetHandle, isAbiNodeType, isKnownNodeType, isModalityNode, isRunningStatus, isTerminalStatus, isValidFlowConnection, isWorkflowValid, logger, mapSSEStatusToTaskStatus, neighborhood, nodeKind, parseExecutableWorkflow, parseSourceHandleId, parseTargetHandleId, parseWorkflow, parseWorkflowImportJson, promptMissingRequired, proportionalMediaNodeWidthPx, pushSnapshot, readCanvas, renderCanvas, resolveAbiOutputMappings, resolveCanonicalFeatureName, resolveEdgeHandles, resolveLabelLookupFeatureName, resolveNodeRef, resolveSpec, resolvedSpecForNodeType, shortId, singleEdgeTextScalarTargetHandles, snapshotFlow, sourceHandleId, sourceSpecForNodeType, staticValue, stringifyExecutableWorkflow, targetHandleId, tryAbiCompatibility, validateFeatureRegistryBundle, validateWorkflow, workflowInput };
+export { ABI_DEFINITIONS, ABI_NODES, ADD_NODE_OUTPUT_TYPE, ADD_NODE_TYPES, COMPONENT_V_GAP, DATA_NODE_TYPES, FeatureRegistryBundleSchema, HISTORY_LIMIT, H_GAP, IMAGE_ASPECT_RATIOS, IMAGE_RESOLUTION_TIERS, KNOWN_NODE_TYPES, MEDIA_NODE_MAX_DISPLAY_WIDTH_PX, MEDIA_NODE_MIN_DISPLAY_WIDTH_PX, MEDIA_NODE_REF_DISPLAY_WIDTH_PX, MEDIA_NODE_REF_LONG_EDGE_PX, MIN_SUPPORTED_ABI_VERSION, MODALITY_NODE_TYPES, NODE_ACTION_META, NODE_TYPE_SOURCE_SPEC, NODE_TYPE_TO_ABI_FEATURE, NodeStatus, PluginConfigSchema, PluginMethodSchema, PluginModelCatalogSchema, PluginParamSpecSchema, PluginsRegistrySchema, RUNNING_STATUSES, SHORT_ID_LENGTH, TERMINAL_STATUSES, TONGFLOW_ABI_NODES, TONGFLOW_ABI_VERSION, TONGFLOW_TOOL_DEFS, TONGFLOW_TOOL_NAMES, TaskStatus, VIDEO_ASPECT_RATIOS, VIDEO_DURATIONS, VIDEO_DURATION_DEFAULT, VIDEO_DURATION_MAX, VIDEO_DURATION_MIN, V_GAP, WORKFLOW_IMPORT_NO_CANVAS, WorkflowExecutor, WorkflowExporter, WorkflowParser, WorkflowStatus, abiSpecForNodeType, addEdgeIfAbsent, applyGraphPatch, batchOn, buildFeatureRegistry, buildPrompts, bumpFocusGeneration, clampVideoDuration, closestNodeTypes, coerceBaseNodeData, collectAll, collectHandleValues, compareAbiProducerConsumerSchemas, componentsContaining, computeAutoLayout, configField, createFlowSlice, createFlowStore, currentFocusGeneration, describeNodeType, edgeShapeError, estimateNodeSize, executeGraphTool, exportWorkflow, featureForNodeType, filterModelCatalog, getAbiNodeBySlot, getAbiOutputRoutesBySlot, getAbiTopology, getAllFeatures, getAspectRatioIconSize, getEdgeTargetOptions, getEffectiveOutputType, getFeatureByName, getFeatureRegistryAliases, getValueByPath, getWorkflowEndNodes, getWorkflowStartNodes, handle, hasDuplicateAddSourceEdge, hasDuplicateTargetHandle, inputNameFor, isAbiNodeType, isKnownNodeType, isModalityNode, isRunningStatus, isTerminalStatus, isValidFlowConnection, isValidPluginParamValue, isWorkflowValid, logger, mapSSEStatusToTaskStatus, neighborhood, nodeActionsForSelection, nodeKind, normalizePluginParams, parseExecutableWorkflow, parseSourceHandleId, parseTargetHandleId, parseWorkflow, parseWorkflowImportJson, promptMissingRequired, proportionalMediaNodeWidthPx, pushSnapshot, readCanvas, renderCanvas, resolveAbiOutputMappings, resolveCanonicalFeatureName, resolveEdgeHandles, resolveLabelLookupFeatureName, resolveNodeRef, resolveSpec, resolvedSpecForNodeType, samePluginParams, shortId, singleEdgeTextScalarTargetHandles, snapshotFlow, sourceHandleId, sourceSpecForNodeType, staticValue, stringifyExecutableWorkflow, targetHandleId, tryAbiCompatibility, validateFeatureRegistryBundle, validateWorkflow, visiblePluginParams, workflowInput };