@sogni-ai/sogni-creative-agent-skill 2.1.0 → 2.1.2

package/generated/creative-agent-runtime.mjs

@@ -0,0 +1,1138 @@
+// Generated by sogni-creative-agent/scripts/sync-skill-runtime.mjs.
+// Do not edit manually in sogni-creative-agent-skill.
+
+function isLtxWorkflow(workflow) {
+    return workflow === 't2v' || workflow === 'i2v' || workflow === 'ia2v' || workflow === 'a2v' || workflow === 'v2v';
+}
+export const SKILL_RUNTIME_VERSION = '2026-05-04.1';
+export const SEEDANCE_STORYBOARD_REFERENCE_PROMPT = 'Turn the video storyboard in @Image1 into a video by following the thumbnails and script for each segment in the image.';
+export const LTX23_WORKFLOW_MODELS = Object.freeze({
+    t2v: 'ltx23-22b-fp8_t2v_distilled',
+    i2v: 'ltx23-22b-fp8_i2v_distilled',
+    ia2v: 'ltx23-22b-fp8_ia2v_distilled',
+    a2v: 'ltx23-22b-fp8_a2v_distilled',
+    v2v: 'ltx23-22b-fp8_v2v_distilled'
+});
+export const SEEDANCE_WORKFLOW_MODELS = Object.freeze({
+    t2v: 'seedance-2-0',
+    t2vFast: 'seedance-2-0-fast',
+    ia2v: 'seedance-2-0',
+    v2v: 'seedance-2-0'
+});
+export const VIDEO_MODEL_REGISTRY = Object.freeze({
+    [LTX23_WORKFLOW_MODELS.t2v]: {
+        workflow: 't2v',
+        family: 'ltx23',
+        defaultWidth: 1920,
+        defaultHeight: 1088,
+        minDimension: 640,
+        maxDimension: 2048,
+        dimensionMultiple: 64,
+        steps: 8,
+        guidance: 1.0,
+        fps: 24,
+        frameStep: 8,
+        minFrames: 25,
+        maxFrames: 505,
+        sampler: 'euler_ancestral',
+        scheduler: 'simple',
+        supportsNativeAudio: true
+    },
+    [LTX23_WORKFLOW_MODELS.i2v]: {
+        workflow: 'i2v',
+        family: 'ltx23',
+        defaultWidth: 1920,
+        defaultHeight: 1088,
+        minDimension: 640,
+        maxDimension: 2048,
+        dimensionMultiple: 64,
+        steps: 8,
+        guidance: 1.0,
+        fps: 24,
+        frameStep: 8,
+        minFrames: 25,
+        maxFrames: 505,
+        sampler: 'euler_ancestral',
+        scheduler: 'simple',
+        supportsNativeAudio: true
+    },
+    [LTX23_WORKFLOW_MODELS.ia2v]: {
+        workflow: 'ia2v',
+        family: 'ltx23',
+        defaultWidth: 1920,
+        defaultHeight: 1088,
+        minDimension: 640,
+        maxDimension: 2048,
+        dimensionMultiple: 64,
+        steps: 8,
+        guidance: 1.0,
+        fps: 24,
+        frameStep: 8,
+        minFrames: 25,
+        maxFrames: 505,
+        sampler: 'euler_ancestral',
+        scheduler: 'simple'
+    },
+    [LTX23_WORKFLOW_MODELS.a2v]: {
+        workflow: 'a2v',
+        family: 'ltx23',
+        defaultWidth: 1920,
+        defaultHeight: 1088,
+        minDimension: 640,
+        maxDimension: 2048,
+        dimensionMultiple: 64,
+        steps: 8,
+        guidance: 1.0,
+        fps: 24,
+        frameStep: 8,
+        minFrames: 25,
+        maxFrames: 505,
+        sampler: 'euler_ancestral',
+        scheduler: 'simple'
+    },
+    [LTX23_WORKFLOW_MODELS.v2v]: {
+        workflow: 'v2v',
+        family: 'ltx23',
+        defaultWidth: 1920,
+        defaultHeight: 1088,
+        minDimension: 640,
+        maxDimension: 2048,
+        dimensionMultiple: 64,
+        steps: 8,
+        guidance: 1.0,
+        fps: 25,
+        frameStep: 8,
+        minFrames: 25,
+        maxFrames: 505,
+        sampler: 'euler_ancestral',
+        scheduler: 'simple'
+    },
+    'wan_v2.2-14b-fp8_t2v_lightx2v': {
+        workflow: 't2v',
+        family: 'wan22',
+        defaultWidth: 640,
+        defaultHeight: 640,
+        minDimension: 480,
+        maxDimension: 1536,
+        dimensionMultiple: 16,
+        steps: 4,
+        guidance: 1.0,
+        fps: 32,
+        internalFps: 16,
+        frameStep: 1,
+        minFrames: 17,
+        maxFrames: 161,
+        sampler: 'euler',
+        scheduler: 'simple',
+        shift: 5.0
+    },
+    'wan_v2.2-14b-fp8_i2v_lightx2v': {
+        workflow: 'i2v',
+        family: 'wan22',
+        defaultWidth: 832,
+        defaultHeight: 480,
+        minDimension: 480,
+        maxDimension: 1536,
+        dimensionMultiple: 16,
+        steps: 4,
+        guidance: 1.0,
+        fps: 32,
+        internalFps: 16,
+        frameStep: 1,
+        minFrames: 17,
+        maxFrames: 321,
+        sampler: 'euler',
+        scheduler: 'simple',
+        shift: 8.0
+    },
+    'wan_v2.2-14b-fp8_s2v_lightx2v': {
+        workflow: 's2v',
+        family: 'wan22',
+        defaultWidth: 832,
+        defaultHeight: 480,
+        minDimension: 480,
+        maxDimension: 1536,
+        dimensionMultiple: 16,
+        steps: 4,
+        guidance: 1.0,
+        fps: 32,
+        internalFps: 16,
+        frameStep: 1,
+        minFrames: 17,
+        maxFrames: 321,
+        sampler: 'uni_pc',
+        scheduler: 'simple',
+        shift: 8.0
+    },
+    'wan_v2.2-14b-fp8_animate-move_lightx2v': {
+        workflow: 'animate-move',
+        family: 'wan22',
+        defaultWidth: 832,
+        defaultHeight: 480,
+        minDimension: 480,
+        maxDimension: 1536,
+        dimensionMultiple: 16,
+        steps: 4,
+        guidance: 1.0,
+        fps: 32,
+        internalFps: 16,
+        frameStep: 1,
+        minFrames: 17,
+        maxFrames: 321,
+        sampler: 'euler',
+        scheduler: 'simple',
+        shift: 8.0
+    },
+    'wan_v2.2-14b-fp8_animate-replace_lightx2v': {
+        workflow: 'animate-replace',
+        family: 'wan22',
+        defaultWidth: 832,
+        defaultHeight: 480,
+        minDimension: 480,
+        maxDimension: 1536,
+        dimensionMultiple: 16,
+        steps: 4,
+        guidance: 1.0,
+        fps: 32,
+        internalFps: 16,
+        frameStep: 1,
+        minFrames: 17,
+        maxFrames: 321,
+        sampler: 'euler',
+        scheduler: 'simple',
+        shift: 8.0
+    },
+    [SEEDANCE_WORKFLOW_MODELS.t2v]: {
+        workflow: 't2v',
+        family: 'seedance2',
+        defaultWidth: 1920,
+        defaultHeight: 1088,
+        minDimension: 1,
+        maxDimension: 99999,
+        dimensionMultiple: 1,
+        fps: 24,
+        frameStep: 1,
+        minFrames: 97,
+        maxFrames: 361,
+        supportsNativeAudio: true
+    },
+    [SEEDANCE_WORKFLOW_MODELS.t2vFast]: {
+        workflow: 't2v',
+        family: 'seedance2',
+        defaultWidth: 1280,
+        defaultHeight: 720,
+        minDimension: 1,
+        maxDimension: 1280,
+        dimensionMultiple: 1,
+        fps: 24,
+        frameStep: 1,
+        minFrames: 97,
+        maxFrames: 361,
+        supportsNativeAudio: true
+    }
+});
+export const EXPANDED_VIDEO_MODEL_REGISTRY = (() => {
+    const registry = { ...VIDEO_MODEL_REGISTRY };
+    for (const workflow of ['t2v', 'i2v', 'ia2v', 'a2v', 'v2v']) {
+        const ltx2Distilled = 'ltx2-19b-fp8_' + workflow + '_distilled';
+        const ltx2Quality = 'ltx2-19b-fp8_' + workflow;
+        const base = registry[LTX23_WORKFLOW_MODELS[workflow]];
+        if (!base)
+            continue;
+        registry[ltx2Distilled] = {
+            ...base,
+            family: 'ltx2',
+            defaultWidth: 768,
+            defaultHeight: 768,
+            minDimension: 480,
+            maxDimension: 1536,
+            steps: 8,
+            supportsNativeAudio: workflow === 't2v' || workflow === 'i2v'
+        };
+        registry[ltx2Quality] = {
+            ...registry[ltx2Distilled],
+            steps: 20
+        };
+    }
+    return Object.freeze(registry);
+})();
+export const VIDEO_WORKFLOW_DEFAULT_MODELS = Object.freeze({
+    t2v: LTX23_WORKFLOW_MODELS.t2v,
+    i2v: 'wan_v2.2-14b-fp8_i2v_lightx2v',
+    s2v: 'wan_v2.2-14b-fp8_s2v_lightx2v',
+    ia2v: LTX23_WORKFLOW_MODELS.ia2v,
+    a2v: LTX23_WORKFLOW_MODELS.a2v,
+    'animate-move': 'wan_v2.2-14b-fp8_animate-move_lightx2v',
+    'animate-replace': 'wan_v2.2-14b-fp8_animate-replace_lightx2v',
+    v2v: LTX23_WORKFLOW_MODELS.v2v
+});
+export const VIDEO_MODEL_ALIASES = Object.freeze({
+    ltx23: LTX23_WORKFLOW_MODELS.t2v,
+    'ltx23-t2v': LTX23_WORKFLOW_MODELS.t2v,
+    'ltx23-i2v': LTX23_WORKFLOW_MODELS.i2v,
+    'ltx23-ia2v': LTX23_WORKFLOW_MODELS.ia2v,
+    'ltx23-a2v': LTX23_WORKFLOW_MODELS.a2v,
+    'ltx23-v2v': LTX23_WORKFLOW_MODELS.v2v,
+    wan22: 'wan_v2.2-14b-fp8_t2v_lightx2v',
+    'wan22-t2v': 'wan_v2.2-14b-fp8_t2v_lightx2v',
+    'wan22-i2v': 'wan_v2.2-14b-fp8_i2v_lightx2v',
+    'wan22-s2v': 'wan_v2.2-14b-fp8_s2v_lightx2v',
+    'wan22-animate-move': 'wan_v2.2-14b-fp8_animate-move_lightx2v',
+    'wan22-animate-replace': 'wan_v2.2-14b-fp8_animate-replace_lightx2v',
+    seedance2: SEEDANCE_WORKFLOW_MODELS.t2v,
+    'seedance2-t2v': SEEDANCE_WORKFLOW_MODELS.t2v,
+    'seedance2-fast': SEEDANCE_WORKFLOW_MODELS.t2vFast,
+    'seedance2-fast-t2v': SEEDANCE_WORKFLOW_MODELS.t2vFast,
+    'seedance2-ia2v': SEEDANCE_WORKFLOW_MODELS.ia2v,
+    'seedance2-v2v': SEEDANCE_WORKFLOW_MODELS.v2v
+});
+export const QUALITY_TIERS = Object.freeze({
+    fast: {
+        model: 'z_image_turbo_bf16',
+        steps: 8,
+        shortSide: null,
+        video: { steps: 8, shortSide: null }
+    },
+    hq: {
+        model: 'z_image_turbo_bf16',
+        steps: null,
+        shortSide: 768,
+        video: { steps: 8, shortSide: 1088 }
+    },
+    pro: {
+        model: 'flux2_dev_fp8',
+        steps: 40,
+        shortSide: 1024,
+        video: { steps: 20, shortSide: 1920 }
+    }
+});
+export function isLtx2Model(modelId) {
+    return modelId?.startsWith('ltx2-') || modelId?.startsWith('ltx23-') || false;
+}
+export function isWanModel(modelId) {
+    return modelId?.startsWith('wan_') || false;
+}
+export function isSeedanceModel(modelId) {
+    return modelId?.startsWith('seedance-2-0') || false;
+}
+export function resolveVideoControlNetStrength(name, explicitStrength) {
+    if (explicitStrength !== null && explicitStrength !== undefined)
+        return explicitStrength;
+    return name === 'detailer' ? 1.0 : 0.85;
+}
+export function resolveVideoModelAlias(modelId, workflow) {
+    if (!modelId)
+        return modelId;
+    const key = String(modelId).trim().toLowerCase();
+    if (key === 'ltx23' && isLtxWorkflow(workflow)) {
+        return LTX23_WORKFLOW_MODELS[workflow];
+    }
+    if (key === 'wan22' && workflow) {
+        return VIDEO_WORKFLOW_DEFAULT_MODELS[workflow] || VIDEO_MODEL_ALIASES.wan22;
+    }
+    if (key === 'seedance2' &&
+        (workflow === 't2v' || workflow === 'ia2v' || workflow === 'v2v')) {
+        return SEEDANCE_WORKFLOW_MODELS[workflow];
+    }
+    return VIDEO_MODEL_ALIASES[key] || modelId;
+}
+export function getBuiltinVideoModelConfig(modelId) {
+    if (!modelId)
+        return null;
+    const id = resolveVideoModelAlias(modelId);
+    if (!id)
+        return null;
+    if (EXPANDED_VIDEO_MODEL_REGISTRY[id])
+        return EXPANDED_VIDEO_MODEL_REGISTRY[id];
+    const workflow = inferVideoWorkflowFromModel(id);
+    if (!workflow)
+        return null;
+    if (id.startsWith('ltx23-') && isLtxWorkflow(workflow)) {
+        return EXPANDED_VIDEO_MODEL_REGISTRY[LTX23_WORKFLOW_MODELS[workflow]] || null;
+    }
+    if (id.startsWith('ltx2-')) {
+        return {
+            workflow,
+            family: 'ltx2',
+            defaultWidth: 768,
+            defaultHeight: 768,
+            minDimension: 480,
+            maxDimension: 1536,
+            dimensionMultiple: 64,
+            steps: id.includes('distilled') ? 8 : 20,
+            guidance: 1.0,
+            fps: workflow === 'v2v' ? 25 : 24,
+            frameStep: 8,
+            minFrames: 25,
+            maxFrames: 321,
+            sampler: 'euler_ancestral',
+            scheduler: 'simple'
+        };
+    }
+    if (isWanModel(id)) {
+        return {
+            workflow,
+            family: 'wan22',
+            defaultWidth: workflow === 't2v' ? 640 : 832,
+            defaultHeight: workflow === 't2v' ? 640 : 480,
+            minDimension: 480,
+            maxDimension: 1536,
+            dimensionMultiple: 16,
+            steps: id.includes('lightx2v') ? 4 : 20,
+            guidance: 1.0,
+            fps: 32,
+            internalFps: 16,
+            frameStep: 1,
+            minFrames: 17,
+            maxFrames: workflow === 't2v' ? 161 : 321,
+            sampler: workflow === 's2v' ? 'uni_pc' : 'euler',
+            scheduler: 'simple',
+            shift: workflow === 't2v' ? 5.0 : 8.0
+        };
+    }
+    return null;
+}
+export function normalizeVideoWorkflow(value) {
+    if (!value)
+        return null;
+    const normalized = value.toLowerCase();
+    if (normalized === 't2v' || normalized === 'text-to-video')
+        return 't2v';
+    if (normalized === 'i2v' || normalized === 'image-to-video')
+        return 'i2v';
+    if (normalized === 's2v' || normalized === 'sound-to-video')
+        return 's2v';
+    if (normalized === 'ia2v' || normalized === 'image-audio-to-video' || normalized === 'image+audio-to-video')
+        return 'ia2v';
+    if (normalized === 'a2v' || normalized === 'audio-to-video')
+        return 'a2v';
+    if (normalized === 'animate-move' || normalized === 'animate_move')
+        return 'animate-move';
+    if (normalized === 'animate-replace' || normalized === 'animate_replace')
+        return 'animate-replace';
+    if (normalized === 'v2v' || normalized === 'video-to-video')
+        return 'v2v';
+    return null;
+}
+export function inferVideoWorkflowFromModel(modelId) {
+    if (!modelId)
+        return null;
+    const resolvedModelId = resolveVideoModelAlias(modelId);
+    if (!resolvedModelId)
+        return null;
+    const id = resolvedModelId.toLowerCase();
+    if (id.includes('animate-move'))
+        return 'animate-move';
+    if (id.includes('animate-replace'))
+        return 'animate-replace';
+    if (id.includes('_v2v'))
+        return 'v2v';
+    if (id.includes('_ia2v'))
+        return 'ia2v';
+    if (id.includes('_a2v'))
+        return 'a2v';
+    if (id.includes('_t2v') || id.includes('-t2v'))
+        return 't2v';
+    if (id.includes('_i2v') || id.includes('-i2v'))
+        return 'i2v';
+    if (id.includes('_s2v') || id.includes('-s2v'))
+        return 's2v';
+    return null;
+}
+export function promptExplicitlyDisablesSpeech(prompt) {
+    return /\b(no dialogue|no speech|without dialogue|without speech|silent|no voiceover|no voice-over)\b/i.test(prompt || '');
+}
+export function containsQuotedDialogue(prompt) {
+    return /"[^"]{1,400}"/.test(prompt || '');
+}
+export function promptMentionsSpeech(prompt) {
+    if (!prompt || promptExplicitlyDisablesSpeech(prompt))
+        return false;
+    return /\b(dialogue|speaks?|speaking|says?|said|asks?|asked|whispers?|shouts?|yells?|narrates?|narration|voiceover|voice-over|conversation|monologue|interview|talking|tells? (?:a )?story)\b/i.test(prompt);
+}
+export function promptMentionsAudio(prompt) {
+    if (!prompt)
+        return false;
+    return /\b(audio|sound|sounds|ambient sound|music|song|singing|sings|voice|voices|dialogue|speech|voiceover|voice-over|narration|foley)\b/i.test(prompt);
+}
+export function promptLooksLikeLongFormStory(prompt) {
+    return /\b(story|screenplay|script|scene|episode|short film|commercial|storyboard|chapter|narrative)\b/i.test(prompt || '');
+}
+export function promptLooksLikeLipSync(prompt) {
+    return /\b(lip[- ]?sync|lipsync|talking head|mouth movement|sync(?:hronize)? (?:the )?(?:lips|mouth|speech)|face speaks|sing along)\b/i.test(prompt || '');
+}
+export function promptNeedsLtxNativeAudio(prompt) {
+    return !promptExplicitlyDisablesSpeech(prompt) && (containsQuotedDialogue(prompt) ||
+        promptMentionsSpeech(prompt) ||
+        promptMentionsAudio(prompt) ||
+        promptLooksLikeLongFormStory(prompt));
+}
+export function normalizeScreenplayDialogueQuotes(prompt) {
+    if (!prompt)
+        return prompt;
+    return prompt
+        .replace(/^(\s*[A-Za-z][A-Za-z0-9 _.-]{0,48}:\s*)'([^'\n]{1,300})'/gm, '$1"$2"')
+        .replace(/([\s(])'([^'\n]{1,180})'(?=[\s).,!?:;]|$)/g, '$1"$2"');
+}
+export function extractQuotedDialogueSegments(prompt) {
+    const matches = [];
+    const pattern = /"([^"]{1,800})"/g;
+    let match;
+    while ((match = pattern.exec(prompt || '')) !== null) {
+        matches.push(match[1]);
+    }
+    return matches;
+}
+export function countWords(text) {
+    const words = String(text || '').trim().match(/\b[\w'-]+\b/g);
+    return words ? words.length : 0;
+}
+export function quotedDialogueWordCount(prompt) {
+    return extractQuotedDialogueSegments(prompt).reduce((sum, segment) => sum + countWords(segment), 0);
+}
+export function suggestedDurationForDialogue(prompt, currentDuration) {
+    const words = quotedDialogueWordCount(prompt);
+    const baseDuration = currentDuration ?? 0;
+    if (words <= 0)
+        return baseDuration;
+    const speechSeconds = Math.ceil(words / 2.5) + 2;
+    return Math.max(baseDuration, Math.min(20, speechSeconds));
+}
+export function formatAudioIdPrompt(prompt, voiceName) {
+    if (!prompt)
+        return prompt;
+    if (/\[VISUAL\]|\[SPEECH\]|\[SOUNDS\]/i.test(prompt))
+        return prompt;
+    const dialogue = extractQuotedDialogueSegments(prompt);
+    const speechLines = dialogue.length > 0
+        ? dialogue.map((line, index) => (voiceName || 'SPEAKER_' + (index + 1)) + ': "' + line + '"').join('\n')
+        : 'No spoken dialogue unless exact quoted words are present in the visual prompt.';
+    return [
+        '[VISUAL]',
+        prompt.trim(),
+        '',
+        '[SPEECH]',
+        speechLines,
+        '',
+        '[SOUNDS]',
+        'Use natural ambient sound that matches the scene unless the prompt specifies silence.'
+    ].join('\n');
+}
+export function getVideoPromptGuardrailPlan({ prompt, duration, frames, fps, durationExplicit, referenceAudioIdentity, voiceName } = {}) {
+    let nextPrompt = prompt || '';
+    let nextDuration = duration ?? 0;
+    const warnings = [];
+    const normalizedPrompt = normalizeScreenplayDialogueQuotes(nextPrompt);
+    if (normalizedPrompt !== nextPrompt) {
+        nextPrompt = normalizedPrompt;
+        warnings.push({
+            type: 'normalized-dialogue-quotes',
+            message: 'Normalized screenplay dialogue to double quotes for video prompting.'
+        });
+    }
+    if (promptMentionsSpeech(nextPrompt) && !containsQuotedDialogue(nextPrompt)) {
+        warnings.push({
+            type: 'missing-quoted-dialogue',
+            message: 'Warning: video prompt mentions speech/dialogue but has no exact spoken words in double quotes. LTX native audio works best with concrete quoted dialogue.'
+        });
+    }
+    if (!frames && !durationExplicit) {
+        const suggested = suggestedDurationForDialogue(nextPrompt, nextDuration);
+        if (suggested > nextDuration) {
+            warnings.push({
+                type: 'duration-extended-for-dialogue',
+                message: 'Auto-extended video duration from ' + nextDuration + 's to ' + suggested + 's to fit quoted dialogue.'
+            });
+            nextDuration = suggested;
+        }
+    }
+    else {
+        const dialogueWords = quotedDialogueWordCount(nextPrompt);
+        const hardBudget = Math.floor((frames ? frames / (fps ?? 24) : nextDuration) * 3.75);
+        if (dialogueWords > hardBudget) {
+            warnings.push({
+                type: 'dialogue-over-budget',
+                message: 'Warning: quoted dialogue has about ' + dialogueWords + ' words, which may not fit in ' + (frames ? frames + ' frames' : nextDuration + 's') + '.'
+            });
+        }
+    }
+    if (referenceAudioIdentity) {
+        nextPrompt = formatAudioIdPrompt(nextPrompt, voiceName || 'SPEAKER');
+    }
+    return {
+        prompt: nextPrompt,
+        duration: nextDuration,
+        warnings
+    };
+}
+export function inferVideoWorkflowFromAssets(opts = {}) {
+    if (opts.refVideo && opts.videoControlNetName)
+        return 'v2v';
+    if (opts.refVideo)
+        return 'animate-move';
+    if (opts.refAudio && !opts.refImage && !opts.refImageEnd)
+        return 'a2v';
+    if (opts.refAudio && opts.refImage)
+        return promptLooksLikeLipSync(opts.prompt) ? 's2v' : 'ia2v';
+    if (opts.refAudio)
+        return 's2v';
+    if (opts.refImage || opts.refImageEnd)
+        return 'i2v';
+    return null;
+}
+export function workflowRequiresImage(workflow) {
+    return workflow === 'i2v' || workflow === 's2v' || workflow === 'ia2v' || workflow === 'animate-move' || workflow === 'animate-replace';
+}
+export function getModelDefaults(modelId, config) {
+    if (!modelId)
+        return null;
+    const normalizedModelId = resolveVideoModelAlias(modelId) || modelId;
+    const builtin = getBuiltinVideoModelConfig(normalizedModelId);
+    const entry = config?.modelDefaults?.[normalizedModelId] || config?.modelDefaults?.[modelId];
+    if (!entry || typeof entry !== 'object')
+        return builtin;
+    return { ...(builtin || {}), ...entry };
+}
+export function selectDefaultVideoModel(workflow, opts = {}, config) {
+    if (!workflow)
+        return null;
+    const configured = config?.videoModels?.[workflow];
+    if (configured)
+        return resolveVideoModelAlias(configured, workflow) || null;
+    if (workflow === 'ia2v')
+        return LTX23_WORKFLOW_MODELS.ia2v;
+    if (workflow === 'a2v')
+        return LTX23_WORKFLOW_MODELS.a2v;
+    if (workflow === 'v2v')
+        return LTX23_WORKFLOW_MODELS.v2v;
+    if (workflow === 't2v')
+        return LTX23_WORKFLOW_MODELS.t2v;
+    if (workflow === 'i2v' && (opts.referenceAudioIdentity || promptNeedsLtxNativeAudio(opts.prompt) || opts.quality === 'hq' || opts.quality === 'pro')) {
+        return LTX23_WORKFLOW_MODELS.i2v;
+    }
+    return VIDEO_WORKFLOW_DEFAULT_MODELS[workflow] || null;
+}
+export function dimensionsWithShortSide(width, height, shortSide) {
+    const w = Number(width);
+    const h = Number(height);
+    const s = Number(shortSide);
+    if (!Number.isFinite(w) || !Number.isFinite(h) || !Number.isFinite(s) || w <= 0 || h <= 0 || s <= 0) {
+        return { width, height };
+    }
+    const currentShort = Math.min(w, h);
+    const scale = s / currentShort;
+    return {
+        width: Math.round(w * scale),
+        height: Math.round(h * scale)
+    };
+}
+function hasPortraitResolutionHint(text) {
+    return /\b(portrait|vertical|reels?|tiktok|shorts?|story)\b/i.test(text);
+}
+function hasLandscapeResolutionHint(text) {
+    return /\b(landscape|horizontal|wide(?:screen)?|cinematic|youtube)\b/i.test(text);
+}
+function normalizeRequestedPixelDimension(value) {
+    return Number.isInteger(value) && value > 0 && value <= 10000 ? value : null;
+}
+function makeLandscapeOrPortraitDimensions(landscapeWidth, landscapeHeight, text) {
+    return hasPortraitResolutionHint(text)
+        ? { width: landscapeHeight, height: landscapeWidth }
+        : { width: landscapeWidth, height: landscapeHeight };
+}
+export function inferNamedVideoResolutionShortSideFromText(text) {
+    const compact = text.replace(/,/g, '');
+    if (/\b4\s*k\b|\buhd\b/i.test(compact))
+        return 2160;
+    if (/\b8\s*k\b/i.test(compact))
+        return 4320;
+    const namedResolution = compact.match(/\b(480|720|1080|1440|2160)\s*p\b/i);
+    return namedResolution ? Number(namedResolution[1]) : null;
+}
+export function inferExplicitPixelDimensionsFromText(text) {
+    const compact = text.replace(/,/g, '');
+    const exactPair = compact.match(/\b(\d{1,5})\s*(x|by)\s*(\d{1,5})\s*(px|pixels?)?\b/i);
+    if (exactPair) {
+        const width = normalizeRequestedPixelDimension(Number(exactPair[1]));
+        const height = normalizeRequestedPixelDimension(Number(exactPair[3]));
+        const hasPixelUnit = Boolean(exactPair[4]);
+        if (width && height && (hasPixelUnit || Math.max(width, height) >= 100)) {
+            return { width, height };
+        }
+    }
+    const widthThenHeight = compact.match(/\b(?:width|wide|w)\s*(?:is|=|:)?\s*(\d{1,5})\s*(?:px|pixels?)?\b[\s\S]{0,80}\b(?:height|tall|high|h)\s*(?:is|=|:)?\s*(\d{1,5})\s*(?:px|pixels?)?\b/i);
+    if (widthThenHeight) {
+        const width = normalizeRequestedPixelDimension(Number(widthThenHeight[1]));
+        const height = normalizeRequestedPixelDimension(Number(widthThenHeight[2]));
+        if (width && height)
+            return { width, height };
+    }
+    const heightThenWidth = compact.match(/\b(?:height|tall|high|h)\s*(?:is|=|:)?\s*(\d{1,5})\s*(?:px|pixels?)?\b[\s\S]{0,80}\b(?:width|wide|w)\s*(?:is|=|:)?\s*(\d{1,5})\s*(?:px|pixels?)?\b/i);
+    if (heightThenWidth) {
+        const height = normalizeRequestedPixelDimension(Number(heightThenWidth[1]));
+        const width = normalizeRequestedPixelDimension(Number(heightThenWidth[2]));
+        if (width && height)
+            return { width, height };
+    }
+    if (/\b4\s*k\b|\buhd\b/i.test(compact)) {
+        return hasPortraitResolutionHint(compact) || hasLandscapeResolutionHint(compact)
+            ? makeLandscapeOrPortraitDimensions(3840, 2160, compact)
+            : null;
+    }
+    if (/\b8\s*k\b/i.test(compact)) {
+        return hasPortraitResolutionHint(compact) || hasLandscapeResolutionHint(compact)
+            ? makeLandscapeOrPortraitDimensions(7680, 4320, compact)
+            : null;
+    }
+    const namedResolution = compact.match(/\b(480|720|1080|1440|2160)\s*p\b/i);
+    if (namedResolution) {
+        if (!hasPortraitResolutionHint(compact) && !hasLandscapeResolutionHint(compact)) {
+            return null;
+        }
+        const shortSide = Number(namedResolution[1]);
+        const landscapeByShortSide = {
+            480: { width: 854, height: 480 },
+            720: { width: 1280, height: 720 },
+            1080: { width: 1920, height: 1080 },
+            1440: { width: 2560, height: 1440 },
+            2160: { width: 3840, height: 2160 },
+        };
+        const dimensions = landscapeByShortSide[shortSide];
+        if (dimensions) {
+            return makeLandscapeOrPortraitDimensions(dimensions.width, dimensions.height, compact);
+        }
+    }
+    return null;
+}
+export function inferExplicitAspectRatioFromText(text) {
+    const match = text.match(/\b(\d{1,4}(?:\.\d+)?)\s*:\s*(\d{1,4}(?:\.\d+)?)\b/);
+    if (!match)
+        return null;
+    const width = Number(match[1]);
+    const height = Number(match[2]);
+    if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) {
+        return null;
+    }
+    const index = match.index ?? 0;
+    const context = text.slice(Math.max(0, index - 48), Math.min(text.length, index + match[0].length + 48));
+    if (/\b(?:ratio|aspect|format|portrait|landscape|vertical|horizontal|widescreen|frame|video|output)\b/i.test(context)) {
+        return { width, height, text: match[0] };
+    }
+    return null;
+}
+export function inferRequestedTotalVideoDurationSeconds(text) {
+    const durations = [];
+    for (const match of text.matchAll(/\b(\d{1,3}(?:\.\d+)?)\s*(?:minutes?|mins?)\b/gi)) {
+        const minutes = Number(match[1]);
+        if (Number.isFinite(minutes) && minutes > 0)
+            durations.push(Math.ceil(minutes * 60));
+    }
+    for (const match of text.matchAll(/\b(\d{1,3})\s*(?:s|sec|secs|seconds?)\b/gi)) {
+        const seconds = Number(match[1]);
+        if (Number.isFinite(seconds) && seconds > 0)
+            durations.push(seconds);
+    }
+    return durations.length > 0 ? Math.max(...durations) : null;
+}
+export function textProvidesLiteralVideoPrompt(text) {
+    return /\b(?:full|exact|literal)\s+prompt\b/i.test(text)
+        || /\bdo\s+not\s+(?:modify|change|rewrite|alter|enhance|expand|improve)\s+(?:this\s+|the\s+)?prompt\b/i.test(text)
+        || /\bprompt\s+to\s+use\b/i.test(text)
+        || /\bprompt\s+(?:exactly|verbatim|as[-\s]?is)\b/i.test(text)
+        || /\buse\s+(?:this|the)\s+(?:full|exact|literal)\s+prompt\b/i.test(text)
+        || /\buse\s+(?:this|the)\s+prompt\s+(?:exactly|verbatim|as[-\s]?is)\b/i.test(text);
+}
+function stripPromptWrapper(text) {
+    let prompt = text.trim();
+    const fenced = prompt.match(/^```(?:[\w-]+)?\s*\n?([\s\S]*?)\n?```\s*$/);
+    if (fenced?.[1]?.trim()) {
+        prompt = fenced[1].trim();
+    }
+    const quotePairs = [
+        ['"', '"'],
+        ["'", "'"],
+    ];
+    for (const [open, close] of quotePairs) {
+        if (prompt.startsWith(open) && prompt.endsWith(close)) {
+            const unwrapped = prompt.slice(open.length, -close.length).trim();
+            if (unwrapped)
+                return unwrapped;
+        }
+    }
+    return prompt;
+}
+export function extractLiteralVideoPrompt(text) {
+    const markers = [
+        /\b(?:use|using|with)\s+(?:this|the)\s+(?:full\s+|exact\s+|literal\s+)?prompt\s+(?:exactly|verbatim|as[-\s]?is)\s*:?\s*/gi,
+        /\b(?:use|using|with)\s+(?:this|the)\s+(?:full|exact|literal)\s+prompt\s*:?\s*/gi,
+        /\b(?:full|exact|literal)\s+prompt\s*:?\s*/gi,
+        /\bprompt\s+to\s+use\s*:?\s*/gi,
+    ];
+    let markerEnd = -1;
+    for (const marker of markers) {
+        marker.lastIndex = 0;
+        while (marker.exec(text) !== null) {
+            markerEnd = Math.max(markerEnd, marker.lastIndex);
+        }
+    }
+    if (markerEnd < 0 && /\bdo\s+not\s+(?:modify|change|rewrite|alter|enhance|expand|improve)\s+(?:this\s+|the\s+)?prompt\b/i.test(text)) {
+        const promptLabel = /\bprompt\s*:\s*/gi;
+        while (promptLabel.exec(text) !== null) {
+            markerEnd = Math.max(markerEnd, promptLabel.lastIndex);
+        }
+    }
+    if (markerEnd < 0)
+        return null;
+    const extracted = stripPromptWrapper(text
+        .slice(markerEnd)
+        .replace(/^\s*[:-]\s*/, ''));
+    return extracted.length >= 3 ? extracted : null;
+}
+export function textMentionsStoryboardReference(text) {
+    return /\b(?:story\s*board|storyboard|video\s+sequence|sequence\s+sheet|shot\s+sheet|thumbnail\s+sequence|panel\s+sequence)\b/i.test(text);
+}
+export function textProvidesVideoScriptOrDetailedPrompt(text) {
+    const normalized = text.trim();
+    if (!normalized)
+        return false;
+    if (textProvidesLiteralVideoPrompt(normalized))
+        return true;
+    if (/\[\s*\d{1,2}(?:[:.]\d{2})?\s*(?:-|to)\s*\d{1,2}(?:[:.]\d{2})?\s*\]/i.test(normalized))
+        return true;
+    if (/^\s*(?:style|shot|scene|segment|camera|motion|audio|vo|v\.o\.|voiceover|sfx|fx|music|dialogue)\s*:/im.test(normalized))
+        return true;
+    if (/^\s*(?:scene|shot|segment)\s*\d{1,2}\b/im.test(normalized))
+        return true;
+    if ((normalized.match(/^\s*(?:vo|v\.o\.|sfx|fx|music|camera)\s*:/gim) || []).length >= 2)
+        return true;
+    if ((normalized.match(/\b(?:VO|SFX|camera|style|dialogue|shot|segment)\s*:/g) || []).length >= 3)
+        return true;
+    const quotedPhrases = normalized.match(/"[^"]{8,}"/g) || [];
+    if (quotedPhrases.length >= 2)
+        return true;
+    const commandStripped = normalized
+        .replace(/\b(?:generate|create|make|render|turn|use|using|with|this|the|uploaded|attached|provided|image|photo|picture|reference|seedance|video|seconds?|secs?|s)\b/gi, ' ')
+        .replace(/\b\d{1,2}\b/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+    const wordCount = commandStripped ? commandStripped.split(/\s+/).length : 0;
+    return wordCount >= 55;
+}
+export function seedanceStoryboardFallbackAllowedForText(text) {
+    return !textProvidesVideoScriptOrDetailedPrompt(text);
+}
+function normalizeDurationSeconds(value) {
+    const raw = typeof value === 'string'
+        ? Number(value.trim().match(/^(\d{1,3}(?:\.\d+)?)\s*(?:s|sec|secs|seconds?)?$/i)?.[1])
+        : typeof value === 'number'
+            ? value
+            : NaN;
+    if (!Number.isFinite(raw) || raw <= 0 || raw > 600)
+        return null;
+    return Math.ceil(raw);
+}
+function greatestCommonDivisor(a, b) {
+    let x = Math.abs(Math.trunc(a));
+    let y = Math.abs(Math.trunc(b));
+    while (y > 0) {
+        const next = x % y;
+        x = y;
+        y = next;
+    }
+    return x || 1;
+}
+function formatAspectRatio(width, height) {
+    if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) {
+        return null;
+    }
+    const ratio = width / height;
+    if (ratio < 0.25 || ratio > 4)
+        return null;
+    const divisor = greatestCommonDivisor(width, height);
+    return `${Math.trunc(width) / divisor}:${Math.trunc(height) / divisor}`;
+}
+function normalizeAspectRatio(value) {
+    if (typeof value !== 'string')
+        return null;
+    const normalized = value.trim().replace(/[x/]/gi, ':').toLowerCase();
+    if (!normalized || normalized === 'null' || normalized === 'unknown' || normalized === 'ambiguous') {
+        return null;
+    }
+    if (/^(?:portrait|vertical)$/.test(normalized))
+        return '9:16';
+    if (/^(?:landscape|horizontal|widescreen)$/.test(normalized))
+        return '16:9';
+    if (/^square$/.test(normalized))
+        return '1:1';
+    const match = normalized.match(/(\d{1,5})\s*:\s*(\d{1,5})/);
+    if (!match)
+        return null;
+    return formatAspectRatio(Number(match[1]), Number(match[2]));
+}
+function textExplicitlyRequestsMultipleVideoRenders(text) {
+    return /\b(?:\d{1,2}|multiple|several|many)\s+(?:separate\s+|different\s+|distinct\s+)?(?:videos?|clips?|versions?|variations?)\b/i.test(text);
+}
+function textExplicitlyRequestsGeneratedImageStage(text) {
+    return /\b(?:generate|create|make|render|produce|design|build)\b\s+(?:an?\s+|the\s+)?(?:\d{1,2}\s+)?(?:new|different|distinct|separate|alternate|transformed|scene\s+)*(?:images?|photos?|pictures?|portraits?|keyframes?|frames?|versions?|variations?|variants?)\b/i.test(text);
+}
+function textRequestsAdjacentImageTransitions(text) {
+    const lower = text.toLowerCase();
+    const mentionsTransition = /\b(?:transition|transitions|transitioning|link|links|linking|connect|connecting|morph)\b/.test(lower)
+        || /\bbetween\s+(?:the\s+)?(?:images?|photos?|pictures?|keyframes?|frames?|versions?|variations?|scenes?)\b/.test(lower)
+        || /(?:->)/.test(text);
+    if (!mentionsTransition)
+        return false;
+    const mentionsGeneratedSequence = /\b(?:versions?|variations?|images?|photos?|pictures?|keyframes?|frames?|scenes?)\b/.test(lower)
+        || /(?:->)/.test(text);
+    const mentionsVideoOutput = /\b(?:video|videos|clips?|segments?|stitch|stitched|stitching|montage)\b/.test(lower);
+    return mentionsGeneratedSequence && mentionsVideoOutput;
+}
+export function planSeedanceStoryboardFallback(input) {
+    const userIntentText = input.userIntentText;
+    const providesLiteralPrompt = input.providesLiteralPrompt
+        ?? textProvidesLiteralVideoPrompt(userIntentText);
+    if (providesLiteralPrompt)
+        return null;
+    if (!seedanceStoryboardFallbackAllowedForText(userIntentText))
+        return null;
+    if (input.uploadedImageCount !== 1)
+        return null;
+    if ((input.uploadedVideoCount ?? 0) > 0 || (input.uploadedAudioCount ?? 0) > 0)
+        return null;
+    if (textExplicitlyRequestsMultipleVideoRenders(userIntentText))
+        return null;
+    if (textExplicitlyRequestsGeneratedImageStage(userIntentText))
+        return null;
+    if (textRequestsAdjacentImageTransitions(userIntentText))
+        return null;
+    const reason = textMentionsStoryboardReference(userIntentText)
+        ? 'text_mentions_storyboard'
+        : input.storyboardDetected
+            ? 'vision_detected_storyboard'
+            : null;
+    if (!reason)
+        return null;
+    const requestedDuration = input.requestedDurationSeconds
+        ?? inferRequestedTotalVideoDurationSeconds(userIntentText);
+    const storyboardDuration = normalizeDurationSeconds(input.storyboardDurationSeconds);
+    const storyboardAspectRatio = normalizeAspectRatio(input.storyboardAspectRatio);
+    const defaultDuration = input.defaultDurationSeconds ?? 5;
+    const maxDuration = input.maxDurationSeconds ?? 15;
+    const minDuration = input.minDurationSeconds ?? 4;
+    const intendedDuration = requestedDuration !== null && requestedDuration !== undefined
+        ? requestedDuration
+        : storyboardDuration ?? defaultDuration;
+    return {
+        prompt: SEEDANCE_STORYBOARD_REFERENCE_PROMPT,
+        duration: Math.max(minDuration, Math.min(maxDuration, intendedDuration)),
+        referenceImageIndices: input.referenceImageIndices ?? [-1],
+        skipPromptProcessing: true,
+        expandPrompt: false,
+        reason,
+        ...(storyboardAspectRatio ? { aspectRatio: storyboardAspectRatio } : {}),
+    };
+}
+function valuePresent(value) {
+    return value !== undefined && value !== null && value !== '';
+}
+export function dimensionsForAspectRatio(width, height, aspectRatio) {
+    const normalized = normalizeAspectRatio(aspectRatio);
+    if (!normalized)
+        return null;
+    const [ratioWText, ratioHText] = normalized.split(':');
+    const ratioW = Number(ratioWText);
+    const ratioH = Number(ratioHText);
+    if (!Number.isFinite(ratioW) || !Number.isFinite(ratioH) || ratioW <= 0 || ratioH <= 0) {
+        return null;
+    }
+    const shortSide = Math.min(width, height);
+    if (!Number.isFinite(shortSide) || shortSide <= 0)
+        return null;
+    if (ratioW >= ratioH) {
+        return {
+            width: Math.round(shortSide * ratioW / ratioH),
+            height: Math.round(shortSide),
+        };
+    }
+    return {
+        width: Math.round(shortSide),
+        height: Math.round(shortSide * ratioH / ratioW),
+    };
+}
+export function isSeedanceModelSelection(modelId) {
+    if (!modelId)
+        return false;
+    return (isSeedanceModel(modelId) ||
+        isSeedanceModel(resolveVideoModelAlias(modelId, 't2v')) ||
+        isSeedanceModel(resolveVideoModelAlias(modelId, 'ia2v')) ||
+        isSeedanceModel(resolveVideoModelAlias(modelId, 'v2v')));
+}
+export function planCliVideoBrain(input) {
+    const plan = { warnings: [] };
+    if (!input.video || !input.prompt?.trim())
+        return plan;
+    const cliSet = input.cliSet ?? {};
+    const text = input.prompt;
+    const normalizedWorkflow = normalizeVideoWorkflow(input.workflow);
+    const literalPrompt = extractLiteralVideoPrompt(text);
+    if (literalPrompt) {
+        plan.literalPrompt = true;
+        plan.prompt = literalPrompt;
+    }
+    const inferredDuration = inferRequestedTotalVideoDurationSeconds(text);
+    if (!cliSet.duration && !cliSet.frames && inferredDuration !== null) {
+        plan.duration = inferredDuration;
+    }
+    if (!cliSet.width && !cliSet.height) {
+        const exactDimensions = inferExplicitPixelDimensionsFromText(text);
+        if (exactDimensions) {
+            plan.width = exactDimensions.width;
+            plan.height = exactDimensions.height;
+            plan.dimensionSource = 'exact';
+        }
+        else if (!cliSet.targetResolution) {
+            const shortSide = inferNamedVideoResolutionShortSideFromText(text);
+            if (shortSide !== null) {
+                plan.targetResolution = shortSide;
+            }
+            else {
+                const aspectRatio = inferExplicitAspectRatioFromText(text);
+                if (aspectRatio) {
+                    const dimensions = dimensionsForAspectRatio(input.width ?? 1920, input.height ?? 1088, aspectRatio.text);
+                    if (dimensions) {
+                        plan.width = dimensions.width;
+                        plan.height = dimensions.height;
+                        plan.dimensionSource = 'aspect';
+                    }
+                }
+            }
+        }
+    }
+    const uploadedImageCount = (valuePresent(input.refImage) ? 1 : 0) +
+        (valuePresent(input.refImageEnd) ? 1 : 0);
+    const storyboard = plan.literalPrompt
+        ? null
+        : planSeedanceStoryboardFallback({
+            userIntentText: text,
+            uploadedImageCount,
+            uploadedVideoCount: valuePresent(input.refVideo) ? 1 : 0,
+            uploadedAudioCount: valuePresent(input.refAudio) ? 1 : 0,
+            requestedDurationSeconds: cliSet.duration ? input.duration : plan.duration ?? inferredDuration,
+            defaultDurationSeconds: input.duration ?? 5,
+            storyboardAspectRatio: inferExplicitAspectRatioFromText(text)?.text,
+        });
+    if (storyboard) {
+        const explicitNonSeedanceModel = cliSet.model && input.model && !isSeedanceModelSelection(input.model);
+        const workflowAllowsStoryboard = !normalizedWorkflow || normalizedWorkflow === 't2v';
+        if (!explicitNonSeedanceModel && workflowAllowsStoryboard) {
+            plan.storyboard = storyboard;
+            plan.prompt = storyboard.prompt;
+            if (!cliSet.model)
+                plan.model = SEEDANCE_WORKFLOW_MODELS.t2v;
+            if (!cliSet.workflow)
+                plan.workflow = 't2v';
+            if (!cliSet.duration && !cliSet.frames)
+                plan.duration = storyboard.duration;
+            if (storyboard.aspectRatio && !cliSet.width && !cliSet.height && plan.width === undefined && plan.height === undefined) {
+                const dimensions = dimensionsForAspectRatio(input.width ?? 1920, input.height ?? 1088, storyboard.aspectRatio);
+                if (dimensions) {
+                    plan.width = dimensions.width;
+                    plan.height = dimensions.height;
+                    plan.dimensionSource = 'aspect';
+                }
+            }
+        }
+    }
+    return plan;
+}
+export function inferDefaultVideoSteps(modelId) {
+    const id = (modelId || '').toLowerCase();
+    if (isSeedanceModel(id))
+        return undefined;
+    if (isLtx2Model(id) && id.includes('distilled'))
+        return 8;
+    if (id.includes('lightx2v'))
+        return 4;
+    if (id.includes('lightning') || id.includes('turbo') || id.includes('lcm'))
+        return 4;
+    if (isLtx2Model(id))
+        return 20;
+    return 20;
+}
+export function resolveVideoSteps(modelId, modelDefaults, explicitSteps) {
+    if (typeof explicitSteps === 'number' && Number.isFinite(explicitSteps))
+        return explicitSteps;
+    const defaultSteps = modelDefaults?.steps;
+    if (typeof defaultSteps === 'number' && Number.isFinite(defaultSteps))
+        return defaultSteps;
+    return inferDefaultVideoSteps(modelId);
+}
+const GRID_PATTERNS = [
+    /\b(?:different|various|varying|multiple|several|many|diverse|assorted|all|range of|variety of|array of|series of|set of|collection of)\s+(?:facial\s+)?(?:expressions?|poses?|angles?|versions?|variations?|looks?|smiles?|moods?|emotions?|faces?|views?|shots?|styles?|options?|takes?|scenes?|settings?|environments?|worlds?)\b/gi,
+    /\b\d+\s+(?:completely\s+|totally\s+|very\s+)?(?:different|unique|distinct|varying|varied|separate|individual)?\s*(?:facial\s+)?(?:expressions?|poses?|angles?|versions?|variations?|looks?|smiles?|moods?|emotions?|faces?|views?|shots?|styles?|options?|takes?|images?|photos?|pictures?|portraits?|copies|duplicates|scenes?|settings?|environments?|worlds?)\b/gi,
+    /\b(?:grid|collage|montage|composite|triptych|diptych|side[- ]by[- ]side|side[- ]to[- ]side|split[- ]?screen|photo[- ]?sheet|contact[- ]?sheet|mood[- ]?board|lineup|line[- ]?up|tile[ds]?|tiling|rows?\s+(?:of|and)\s+columns?|columns?\s+(?:of|and)\s+rows?)\b/gi,
+    /\beach\s+(?:with|showing|featuring|displaying|having|in)\s+(?:a\s+)?(?:different|unique|distinct|its own)\b/gi,
+    /\beach\s+(?:one|version|variation|image|copy)\b/gi,
+    /\b(?:show|display|create|generate|make|render|produce)\s+(?:multiple|different|various|several|all)\b/gi,
+    /\b(?:switch(?:ing)?|mix(?:ing)?)\s+up\b/gi,
+    /\b\d+\s+of\s+(?:them|these|those)\b/gi,
+    /\b(?:multiple|several|many)\s+(?:copies|duplicates|instances|repeats)\b/gi,
+    /\b\d+\s+(?:versions?|variations?|renditions?|interpretations?|depictions?|iterations?)\b/gi,
+    /\b(?:repeated|repeating|repeat)\s+\d*\s*(?:times?)?\b/gi,
+    /\b(?:put|place|fit|arrange)\s+(?:them|these|those|it)\s+(?:all\s+)?(?:together|into one|in one)\b/gi,
+    /\ball\s+(?:together|in\s+one\s+(?:image|frame|picture|photo))\b/gi
+];
+const SINGULARIZE_PATTERNS = [
+    [
+        /\b(create|generate|make|render|produce)\s+\d+\s+(?:completely\s+|totally\s+|very\s+)?(?:different|unique|distinct|varying|varied|separate|individual)?\s*(scenes?|settings?|environments?|worlds?)\s+(featuring|with|of)\b/gi,
+        '$1 a single scene $3'
+    ],
+    [
+        /\b(create|generate|make|render|produce)\s+\d+\s+(?:completely\s+|totally\s+|very\s+)?(?:different|unique|distinct|varying|varied|separate|individual)?\s*(images?|photos?|pictures?|portraits?)\s+(featuring|with|of)\b/gi,
+        '$1 a single image $3'
+    ],
+    [
+        /\b(?:in|across)\s+(?:different|various|varying|multiple|several|many|diverse|assorted)\s+(?:scenes?|settings?|environments?|worlds?)\s*:/gi,
+        'in this setting:'
+    ],
+    [
+        /\bfor\s+all\s+(?:scenes?|settings?|environments?|worlds?|images?|photos?|pictures?|portraits?)\b/gi,
+        'for the image'
+    ]
+];
+function countPatternReplacement(match, ...args) {
+    const offset = typeof args[args.length - 2] === 'number' ? args[args.length - 2] : 0;
+    const source = typeof args[args.length - 1] === 'string' ? args[args.length - 1] : '';
+    const before = source.slice(Math.max(0, offset - 8), offset);
+    const after = source.slice(offset + match.length, offset + match.length + 8);
+    const touchesAspectOrDimension = /(?:\d\s*[:/x×]\s*|\bby\s*)$/i.test(before) ||
+        /^\s*(?::|\/|x|×|\bby\b)\s*\d/i.test(after);
+    return touchesAspectOrDimension ? match : '';
+}
+export function sanitizeBatchPrompt(prompt) {
+    const groups = [];
+    const placeholderPrefix = '\x00DP';
+    const placeholder = (i) => placeholderPrefix + i + '\x00';
+    let shielded = prompt.replace(/\{[^{}]+\}/g, (match) => {
+        if (match.includes('|')) {
+            groups.push(match);
+            return placeholder(groups.length - 1);
+        }
+        return match;
+    });
+    for (const [pattern, replacement] of SINGULARIZE_PATTERNS) {
+        pattern.lastIndex = 0;
+        shielded = shielded.replace(pattern, replacement);
+    }
+    for (const pattern of GRID_PATTERNS) {
+        pattern.lastIndex = 0;
+        shielded = shielded.replace(pattern, countPatternReplacement);
+    }
+    shielded = shielded.replace(/\s{2,}/g, ' ').replace(/\s+([.,;!?])/g, '$1').trim();
+    shielded = shielded.replace(/^[,.\s]+/, '').replace(/[,.\s]+$/, '').trim();
+    let result = shielded;
+    for (let i = 0; i < groups.length; i++) {
+        result = result.replace(placeholder(i), groups[i]);
+    }
+    return result;
+}