Move library collections as a group and map v2 identity refs.

Collapsed collection actions now move, rename, delete, and rerun every part so chains stay together. Identity mode follows the v2u3 Ref2VA picture wiring. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-26 22:56:37 -05:00
parent f54e8da857
commit e334cb7a7a
28 changed files with 1125 additions and 293 deletions
@@ -25,12 +25,19 @@ LIBRARY_DIR=/data/library
 # AUTH_USERNAME=
 # AUTH_PASSWORD=
 # COMFY_FILENAME_PREFIX=video/xAIGen
-# Desktop Comfy files are deleted after a successful library save (set false to keep them)
+# Desktop Comfy files are deleted after a successful library save (set false to keep them).
+# Also removes Qwen Edit input/output files from the image sidecar after saveStill.
 # PURGE_COMFY_OUTPUTS=true

-# Second Comfy box (sidecar / Qwen image edit)
+# Second Comfy box (Sidecar / Qwen overflow). Beast uses COMFY_HOST first.
+# Image edits run on Beast when that Comfy is idle, and roll over to Sidecar only when Beast is busy.
 IMAGE_COMFY_HOST=http://192.168.77.101:8188
 IMAGE_COMFY_PORT=8188
+# Optional override if image Comfy on Beast is not the video instance
+# IMAGE_COMFY_PRIMARY_HOST=http://192.168.77.7:8198
+# IMAGE_COMFY_FALLBACK_HOST=http://192.168.77.101:8188
+# Spawned on the sidecar PC (host agent /start and start_comfyui.bat). Listen is 0.0.0.0 so Coolify can reach :8188.
+IMAGE_COMFY_LAUNCH_CMD=C:\ComfyUI-QwenEdit\python\python.exe C:\ComfyUI-QwenEdit\ComfyUI\main.py --listen 0.0.0.0 --port 8188 --disable-auto-launch --lowvram --fp8_e4m3fn-unet --disable-cuda-malloc
 # Optional host agent on the sidecar (scripts/comfy-host-agent.mjs)
 # IMAGE_COMFY_CONTROL_URL=http://192.168.77.101:8199
 # IMAGE_COMFY_CONTROL_TOKEN=
@@ -224,6 +224,7 @@ async function unlock() {
 }

 async function ingest(file: File) {
+  if (/last[\s._-]*frame/i.test(file.name || '')) return
  const body = new FormData()
  body.append('image', file)
  body.append('folderId', current.value?.id || activeFolderId.value)
@@ -31,6 +31,8 @@ export default defineNuxtConfig({
    comfyControlToken: process.env.COMFY_CONTROL_TOKEN || '',
    imageComfyHost: process.env.IMAGE_COMFY_HOST || '',
    imageComfyPort: process.env.IMAGE_COMFY_PORT || '',
+    imageComfyPrimaryHost: process.env.IMAGE_COMFY_PRIMARY_HOST || '',
+    imageComfyFallbackHost: process.env.IMAGE_COMFY_FALLBACK_HOST || '',
    imageComfyLaunchCmd: process.env.IMAGE_COMFY_LAUNCH_CMD || '',
    imageComfyControlUrl: process.env.IMAGE_COMFY_CONTROL_URL || '',
    imageComfyControlToken: process.env.IMAGE_COMFY_CONTROL_TOKEN || '',
@@ -20,7 +20,7 @@
          <span
            class="items-center gap-2 rounded-full border px-3 py-1"
            :class="[studioMode === 'edit' ? 'hidden sm:inline-flex' : 'hidden xl:inline-flex opacity-60', imageComfyBadge.className]"
-            :title="imageComfyHost || 'Image edit sidecar'"
+            :title="imageComfyHost || 'Image edit: Beast, Sidecar overflow'"
          >
            <span class="h-2 w-2 rounded-full" :class="imageComfyBadge.dot" />
            {{ imageComfyBadge.label }}
@@ -57,7 +57,7 @@
          </div>
          <h2 class="font-display text-2xl font-bold">Input</h2>
          <p class="text-sm text-zinc-400">{{ studioMode === 'edit'
-            ? 'Drop a still and describe the edit. This relays to the sidecar Qwen Comfy box once the workflow is mapped.'
+            ? 'Drop a still and describe the edit. Beast handles it when free; Sidecar only if Beast is busy.'
            : 'Drop a still, describe the motion, then relay the job to the local desktop.' }}</p>
        </div>

@@ -88,6 +88,15 @@
        <div>
          <div class="mb-2 flex flex-wrap items-center justify-between gap-2">
            <label class="text-sm font-medium text-zinc-300">{{ studioMode === 'edit' ? 'Edit prompt' : 'Motion & scene prompt' }}</label>
+            <div class="flex flex-wrap items-center gap-3">
+              <button
+                v-if="identityPrompting"
+                type="button"
+                class="text-xs text-amber-200/80 hover:text-amber-100"
+                @click="insertIdentityTemplate"
+              >
+                Insert shot template
+              </button>
              <label v-if="studioMode === 'video'" class="flex cursor-pointer items-center gap-2 text-xs text-zinc-400">
                <span class="relative inline-flex h-5 w-9 shrink-0 items-center">
                  <input v-model="shotScriptMode" type="checkbox" class="peer sr-only" role="switch">
@@ -97,19 +106,24 @@
                Shot script
              </label>
            </div>
+          </div>
          <p v-if="shotScriptMode && studioMode === 'video'" class="mb-2 text-xs text-zinc-500">
-            Paste a block. Text before the first marker is shot 1. Write <span class="font-medium text-zinc-300">shot 2</span>, <span class="font-medium text-zinc-300">shot 3</span>, and so on to queue extensions. Every shot uses the duration slider.
+            Paste a block. Text before the first marker is shot 1. Put <span class="font-medium text-zinc-300">shot 2</span>, <span class="font-medium text-zinc-300">shot 3</span> on their own lines to queue extensions — a line like <span class="font-medium text-zinc-300">Shot Type</span> will not start a new shot. Every shot uses the duration slider.
+            <span v-if="identityPrompting"> Identity boilerplate is prepended to the first shot only.</span>
+          </p>
+          <p v-else-if="identityPrompting" class="mb-2 text-xs text-zinc-500">
+            Write camera, action, and audio. We prepend the <span class="font-medium text-zinc-300">&lt;Picture 1&gt;</span> identity lock automatically.
          </p>
          <textarea
            v-model="prompt"
-            :rows="shotScriptMode ? 12 : 6"
+            :rows="shotScriptMode || identityPrompting ? 12 : 6"
            class="w-full rounded-2xl border border-white/10 bg-zinc-950/70 px-4 py-3 text-sm outline-none ring-amber-300/40 placeholder:text-zinc-600 focus:ring-2"
-            :placeholder="studioMode === 'edit'
-              ? 'Make the lighting warmer. Replace the background with a rainy street at night. Keep the face unchanged.'
-              : (shotScriptMode
-              ? 'A woman walks into the village.\n\nshot 2\nShe crosses the stone bridge at dusk.\n\nshot 3\nShe opens the shop door and steps inside.'
-              : 'Camera slowly pushes in. Soft daylight, fabric ripples, dust motes in the air. Audio: quiet room tone, distant birds.')"
+            :placeholder="promptPlaceholder"
          />
+          <details v-if="identityPrompting && prompt.trim()" class="mt-2 rounded-xl border border-white/10 bg-zinc-950/40 px-3 py-2">
+            <summary class="cursor-pointer text-xs text-zinc-400">Prompt sent to MiniMax</summary>
+            <p class="mt-2 whitespace-pre-wrap text-xs text-zinc-300">{{ composedIdentityPrompt }}</p>
+          </details>
          <div v-if="shotScriptMode && studioMode === 'video'" class="mt-3 space-y-2">
            <p v-if="!parsedShots.length" class="text-xs text-zinc-500">Add a first shot, then <span class="text-zinc-300">shot 2</span> for an extension.</p>
            <div
@@ -289,7 +303,7 @@
                    class="h-24 w-full object-cover"
                  >
                  <span v-else class="flex h-24 items-center justify-center px-2 text-center text-[11px] text-zinc-500">
-                    Ref {{ slot }}
+                    Picture {{ slot + 1 }}
                  </span>
                </button>
                <button
@@ -302,7 +316,7 @@
                </button>
              </div>
            </div>
-            <p v-if="useIdentityRefs" class="text-xs text-zinc-500">Extra stills lock people and objects. The first-frame still above stays the opening frame. Identity refs are not reused on queued extensions.</p>
+            <p v-if="useIdentityRefs" class="text-xs text-zinc-500">Picture 1 is the start still. Extra stills map to Picture 2–5 in MiniMax. Empty slots are omitted. Identity refs are not reused on queued extensions.</p>
          </div>
        </div>

@@ -409,9 +423,13 @@
          <summary class="cursor-pointer text-sm font-medium">Image edit settings</summary>
          <div class="mt-4 space-y-4">
            <p class="text-xs text-zinc-500">
-              Sidecar: <span class="text-zinc-200">{{ imageComfyHost || 'not configured' }}</span>
-              · {{ imageComfyBadge.label }}
-              · Qwen Image Edit Lightning (4-step LoRA)
+              Beast first, Sidecar overflow.
+              <span class="text-zinc-200">{{ imageComfyBadge.label }}</span>
+              · Qwen Image Edit u2 (Lightning)
+            </p>
+            <p class="text-[11px] text-zinc-500">
+              Beast {{ imageBeastHost || 'unset' }}{{ imageBeastOk ? (imageBeastBusy ? ' · busy' : ' · free') : ' · offline' }}
+              · Sidecar {{ imageSidecarHost || 'unset' }}{{ imageSidecarOk ? (imageSidecarBusy ? ' · busy' : ' · ready') : (imageSidecarConfigured ? ' · offline' : ' · unset') }}
            </p>
            <label class="block text-sm">
              <span class="mb-1 block text-zinc-400">Negative prompt</span>
@@ -435,7 +453,7 @@
                <input v-model="seedInput" class="w-full rounded-xl border border-white/10 bg-zinc-950 px-3 py-2 text-sm" placeholder="random">
              </label>
            </div>
-            <p class="text-xs text-zinc-500">Lower denoise keeps more of the original still. Lightning is tuned for 4 steps, CFG 1, denoise around 0.75.</p>
+            <p class="text-xs text-zinc-500">This graph encodes the still in the Qwen prompt. Lightning is tuned for 4 steps, CFG 1, denoise 1.</p>
          </div>
        </details>

@@ -741,23 +759,23 @@
                  <div class="min-w-0 flex-1">
                    <div class="flex items-start gap-2">
                      <input
-                        v-if="renamingId === group.head.id"
+                        v-if="renamingId === group.head.id && renamingFamily"
                        ref="renameInput"
                        v-model="renameDraft"
                        class="min-w-0 flex-1 rounded-lg border border-amber-300/40 bg-zinc-950 px-2 py-1 text-sm outline-none ring-amber-300/40 focus:ring-2"
                        maxlength="80"
-                        @keydown.enter.prevent="saveRename(group.head)"
+                        @keydown.enter.prevent="saveRename(group.head, true)"
                        @keydown.escape.prevent="cancelRename"
-                        @blur="saveRename(group.head)"
+                        @blur="saveRename(group.head, true)"
                      >
-                      <p v-else class="min-w-0 flex-1 truncate text-sm font-medium">{{ group.head.name || group.head.prompt }}</p>
+                      <p v-else class="min-w-0 flex-1 truncate text-sm font-medium">{{ collectionTitle(group) }}</p>
                      <div class="group relative shrink-0">
                        <button
                          type="button"
                          class="flex h-6 w-6 items-center justify-center rounded-full text-zinc-500 hover:text-amber-200"
-                          :aria-label="'Copy prompt for ' + (group.head.name || 'clip')"
+                          :aria-label="'Copy prompt for ' + collectionTitle(group)"
                          title="Copy prompt"
-                          @click.stop="copyPrompt(group.head.prompt)"
+                          @click.stop="copyPrompt(familyScript(group.parts))"
                        >
                          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" class="h-4 w-4">
                            <circle cx="12" cy="12" r="10" />
@@ -765,7 +783,7 @@
                          </svg>
                        </button>
                        <div class="pointer-events-none invisible absolute right-0 top-7 z-20 w-64 whitespace-pre-wrap rounded-xl border border-white/10 bg-zinc-950 p-3 text-xs leading-relaxed text-zinc-300 shadow-2xl group-hover:visible group-focus-within:visible">
-                          {{ group.head.prompt }}
+                          {{ familyScript(group.parts) }}
                        </div>
                      </div>
                    </div>
@@ -776,13 +794,13 @@
                      </button>
                      <button type="button" class="text-xs text-amber-300" @click="openClip(group.head)">Open</button>
                      <button type="button" class="text-xs text-amber-300" @click="openExtend(group.head)">Extend</button>
-                      <button type="button" class="text-xs text-amber-300" @click="startRename(group.head)">Rename</button>
-                      <button type="button" class="text-xs text-amber-300" @click="rerun(group.head)">Rerun</button>
+                      <button type="button" class="text-xs text-amber-300" @click="startRename(group.head, true)">Rename</button>
+                      <button type="button" class="text-xs text-amber-300" @click="rerun(group.head, true)">Rerun</button>
                      <select
                        v-if="folders.length > 1"
                        class="max-w-[9.5rem] rounded-lg border border-white/10 bg-zinc-950 px-1.5 py-0.5 text-xs text-amber-300"
                        :value="''"
-                        @change="onMoveClip(group.head, $event)"
+                        @change="onMoveClip(group.head, $event, true)"
                      >
                        <option disabled value="">Move to…</option>
                        <option
@@ -793,13 +811,13 @@
                          {{ folder.name }}{{ folder.protected && !folder.unlocked ? ' · locked' : '' }}
                        </option>
                      </select>
-                      <button type="button" class="text-xs text-red-300" @click="removeClip(group.head)">Delete</button>
+                      <button type="button" class="text-xs text-red-300" @click="removeClip(group.head, true)">Delete</button>
                    </div>
                  </div>
                </div>
                <ul v-if="expandedFamilies[group.key] && group.parts.length > 1" class="mt-3 space-y-2 border-t border-white/5 pt-3">
                  <li
-                    v-for="item in group.parts.slice(1)"
+                    v-for="item in chronologicalParts(group.parts)"
                    :key="item.id"
                    class="flex gap-3 rounded-xl border border-white/5 bg-black/20 p-2"
                  >
@@ -818,7 +836,7 @@
                    <div class="min-w-0 flex-1">
                      <div class="flex items-start gap-2">
                        <input
-                          v-if="renamingId === item.id"
+                          v-if="renamingId === item.id && !renamingFamily"
                          v-model="renameDraft"
                          class="min-w-0 flex-1 rounded-lg border border-amber-300/40 bg-zinc-950 px-2 py-1 text-sm outline-none ring-amber-300/40 focus:ring-2"
                          maxlength="80"
@@ -834,6 +852,21 @@
                        <button type="button" class="text-xs text-amber-300" @click="openExtend(item)">Extend</button>
                        <button type="button" class="text-xs text-amber-300" @click="startRename(item)">Rename</button>
                        <button type="button" class="text-xs text-amber-300" @click="rerun(item)">Rerun</button>
+                        <select
+                          v-if="folders.length > 1"
+                          class="max-w-[9.5rem] rounded-lg border border-white/10 bg-zinc-950 px-1.5 py-0.5 text-xs text-amber-300"
+                          :value="''"
+                          @change="onMoveClip(item, $event)"
+                        >
+                          <option disabled value="">Move to…</option>
+                          <option
+                            v-for="folder in folders.filter(folder => folder.id !== item.folderId)"
+                            :key="folder.id"
+                            :value="folder.id"
+                          >
+                            {{ folder.name }}{{ folder.protected && !folder.unlocked ? ' · locked' : '' }}
+                          </option>
+                        </select>
                        <button type="button" class="text-xs text-red-300" @click="removeClip(item)">Delete</button>
                      </div>
                    </div>
@@ -930,6 +963,9 @@ interface LibraryClip {
  parentClipId?: string
  chainIndex?: number
  workflow?: 'v1' | 'v2'
+  stillId?: string
+  sound?: boolean
+  hideInput?: boolean
 }

 interface RetryDraft {
@@ -1017,6 +1053,13 @@ const imageComfyOk = ref(false)
 const imageComfyBusy = ref(false)
 const imageComfyConfigured = ref(false)
 const imageComfyHost = ref('')
+const imageBeastOk = ref(false)
+const imageBeastBusy = ref(false)
+const imageBeastHost = ref('')
+const imageSidecarOk = ref(false)
+const imageSidecarBusy = ref(false)
+const imageSidecarConfigured = ref(false)
+const imageSidecarHost = ref('')
 const progress = ref(0)
 const statusMessage = ref('Waiting for a still.')
 const statusBusy = ref(false)
@@ -1042,7 +1085,7 @@ const editAwaitingReveal = ref(false)
 const editLockedSave = ref(false)
 const editSteps = ref(4)
 const editCfg = ref(1)
-const editDenoise = ref(0.75)
+const editDenoise = ref(1)
 const editNegative = ref('blurry, low quality, deformed, bad anatomy, watermark, text, extra fingers')
 const videoJobId = ref('')
 const editJobId = ref('')
@@ -1074,6 +1117,7 @@ const drafts = ref<RetryDraft[]>([])
 const folderId = ref('')
 const browseFolderId = ref('')
 const renamingId = ref('')
+const renamingFamily = ref(false)
 const renameDraft = ref('')
 const renameInput = ref<HTMLInputElement | null>(null)
 const unlockPassword = ref('')
@@ -1136,29 +1180,43 @@ const comfyBadge = computed(() => {
 const imageComfyBadge = computed(() => {
  if (!imageComfyConfigured.value) {
    return {
-      label: 'Edit sidecar unset',
+      label: 'Edit unset',
      className: 'border-white/10 text-zinc-500',
      dot: 'bg-zinc-500'
    }
  }
-  if (!imageComfyOk.value) {
+  if (imageBeastOk.value && !imageBeastBusy.value) {
    return {
-      label: 'Edit Comfy offline',
-      className: 'border-red-400/30 text-red-300',
-      dot: 'bg-red-400'
+      label: 'Beast · edit ready',
+      className: 'border-emerald-400/30 text-emerald-300',
+      dot: 'bg-emerald-400'
+    }
+  }
+  if (imageBeastBusy.value && imageSidecarOk.value && !imageSidecarBusy.value) {
+    return {
+      label: 'Sidecar · overflow ready',
+      className: 'border-amber-400/40 text-amber-200',
+      dot: 'bg-amber-400'
+    }
+  }
+  if (imageSidecarOk.value && !imageSidecarBusy.value) {
+    return {
+      label: 'Sidecar · edit ready',
+      className: 'border-emerald-400/30 text-emerald-300',
+      dot: 'bg-emerald-400'
    }
  }
  if (imageComfyBusy.value) {
    return {
-      label: 'Edit Comfy busy',
+      label: 'Edit boxes busy',
      className: 'border-amber-400/40 text-amber-200',
      dot: 'bg-amber-400'
    }
  }
  return {
-    label: 'Edit Comfy online',
-    className: 'border-emerald-400/30 text-emerald-300',
-    dot: 'bg-emerald-400'
+    label: 'Edit Comfy offline',
+    className: 'border-red-400/30 text-red-300',
+    dot: 'bg-red-400'
  }
 })

@@ -1219,14 +1277,14 @@ const videoGenerateDisabled = computed(() => {
 const editBlocked = computed(() => {
  if (editBusy.value) return true
  if (!file.value || !prompt.value.trim() || !folderId.value) return true
-  if (!imageComfyConfigured.value || !imageComfyOk.value) return true
-  if (imageComfyBusy.value) return true
+  if (!imageComfyConfigured.value) return true
+  if (!imageComfyOk.value && !imageSidecarConfigured.value) return true
  return false
 })
 const editBlockReason = computed(() => {
-  if (!imageComfyConfigured.value) return 'Image edit sidecar is not configured.'
-  if (!imageComfyOk.value) return 'Edit Comfy is offline.'
-  if (imageComfyBusy.value && !editBusy.value) return 'Sidecar is busy with another prompt.'
+  if (!imageComfyConfigured.value) return 'Image edit is not configured. Set COMFY_HOST and IMAGE_COMFY_HOST.'
+  if (!imageComfyOk.value && !imageSidecarConfigured.value) return 'Beast is offline and Sidecar is not configured.'
+  if (!imageComfyOk.value && imageSidecarConfigured.value && !imageSidecarOk.value) return 'Beast and Sidecar are both offline.'
  return ''
 })
 const generateLabel = computed(() => {
@@ -1236,6 +1294,28 @@ const generateLabel = computed(() => {
  return n === 1 ? 'Generate Initial + 1 Extension' : `Generate Initial + ${n} Extensions`
 })
 const parsedShots = computed(() => parseShotScript(prompt.value))
+const identityPrompting = computed(() => studioMode.value === 'video' && videoWorkflow.value === 'v2' && useIdentityRefs.value)
+const extraIdentityPictures = computed(() => identityRefs.value.flatMap((item, index) => item ? [index + 2] : []))
+const composedIdentityPrompt = computed(() => {
+  const action = shotScriptMode.value
+    ? (parsedShots.value[0]?.prompt || prompt.value)
+    : prompt.value
+  return buildIdentityPrompt(action, extraIdentityPictures.value)
+})
+const promptPlaceholder = computed(() => {
+  if (studioMode.value === 'edit') {
+    return 'Make the lighting warmer. Replace the background with a rainy street at night. Keep the face unchanged.'
+  }
+  if (identityPrompting.value) {
+    return shotScriptMode.value
+      ? `${IDENTITY_ACTION_TEMPLATE}\n\nshot 2\nThe subject from <Picture 1> continues along the path as the camera eases past her.`
+      : IDENTITY_ACTION_TEMPLATE
+  }
+  if (shotScriptMode.value) {
+    return 'A woman walks into the village.\n\nshot 2\nShe crosses the stone bridge at dusk.\n\nshot 3\nShe opens the shop door and steps inside.'
+  }
+  return 'Camera slowly pushes in. Soft daylight, fabric ripples, dust motes in the air. Audio: quiet room tone, distant birds.'
+})
 const plannedChain = computed(() => {
  if (shotScriptMode.value) {
    return parsedShots.value.map((shot, index) => ({
@@ -1277,10 +1357,14 @@ function clipsIn(id: string) {
  return clips.value.filter(clip => clip.folderId === id)
 }

+function familyBaseName(name: string) {
+  return String(name || '').trim().replace(/\s+p\d+$/i, '')
+}
+
 function clipFamilyKey(clip: LibraryClip) {
-  const base = String(clip.name || '').trim().replace(/\s+p\d+$/i, '')
-  if (base) return `name:${clip.folderId}:${base.toLowerCase()}`
-  if (clip.familyId) return clip.familyId
+  if (clip.familyId) return `family:${clip.folderId}:${clip.familyId}`
+  const base = familyBaseName(clip.name || '').toLowerCase()
+  if (base) return `name:${clip.folderId}:${base}`
  return `solo:${clip.id}`
 }

@@ -1292,6 +1376,27 @@ function sortClipParts(a: LibraryClip, b: LibraryClip) {
  return a.createdAt - b.createdAt
 }

+function chronologicalParts(parts: LibraryClip[]) {
+  return [...parts].sort((a, b) => {
+    const chain = (a.chainIndex || 0) - (b.chainIndex || 0)
+    if (chain) return chain
+    return a.createdAt - b.createdAt
+  })
+}
+
+function collectionTitle(group: { head: LibraryClip; parts: LibraryClip[] }) {
+  const named = group.parts.map(part => familyBaseName(part.name || '')).find(name => name)
+  return named || group.head.name || group.head.prompt
+}
+
+function familyScript(parts: LibraryClip[]) {
+  const ordered = chronologicalParts(parts)
+  if (ordered.length <= 1) return ordered[0]?.prompt || ''
+  return ordered.map((part, index) => (
+    index === 0 ? part.prompt.trim() : `shot ${index + 1}\n${part.prompt.trim()}`
+  )).join('\n\n')
+}
+
 function formatClipDuration(value?: number) {
  if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) return ''
  const rounded = Math.round(value * 10) / 10
@@ -1365,7 +1470,14 @@ async function loadLibrary() {

 function applyComfyHealth(health: {
  comfy?: { ok?: boolean; busy?: boolean }
-  imageComfy?: { ok?: boolean; busy?: boolean; configured?: boolean; host?: string }
+  imageComfy?: {
+    ok?: boolean
+    busy?: boolean
+    configured?: boolean
+    host?: string
+    beast?: { ok?: boolean; busy?: boolean; host?: string; configured?: boolean }
+    sidecar?: { ok?: boolean; busy?: boolean; host?: string; configured?: boolean }
+  }
 } | null | undefined) {
  comfyOk.value = Boolean(health?.comfy?.ok)
  comfyBusy.value = Boolean(health?.comfy?.ok && health?.comfy?.busy)
@@ -1373,6 +1485,13 @@ function applyComfyHealth(health: {
  imageComfyOk.value = Boolean(health?.imageComfy?.ok)
  imageComfyBusy.value = Boolean(health?.imageComfy?.ok && health?.imageComfy?.busy)
  imageComfyHost.value = String(health?.imageComfy?.host || '')
+  imageBeastOk.value = Boolean(health?.imageComfy?.beast?.ok)
+  imageBeastBusy.value = Boolean(health?.imageComfy?.beast?.busy)
+  imageBeastHost.value = String(health?.imageComfy?.beast?.host || '')
+  imageSidecarOk.value = Boolean(health?.imageComfy?.sidecar?.ok)
+  imageSidecarBusy.value = Boolean(health?.imageComfy?.sidecar?.busy)
+  imageSidecarConfigured.value = Boolean(health?.imageComfy?.sidecar?.configured)
+  imageSidecarHost.value = String(health?.imageComfy?.sidecar?.host || '')
 }

 async function pollComfyHealth() {
@@ -1504,6 +1623,12 @@ function restoreAdvanced(item: { turbo: boolean; aspect?: string; width?: number
  scheduler.value = restoreScheduler(item.scheduler)
 }

+function insertIdentityTemplate() {
+  prompt.value = shotScriptMode.value
+    ? `${IDENTITY_ACTION_TEMPLATE}\n\nshot 2\nThe subject from <Picture 1> continues along the path, turning to take in the wider view.\n\n[AUDIO CUES]\nAmbient forest breeze, soft footsteps, warm cinematic strings.`
+    : IDENTITY_ACTION_TEMPLATE
+}
+
 function toast(message: string) {
  const id = crypto.randomUUID()
  toasts.value.push({ id, message })
@@ -1533,10 +1658,10 @@ function resetImage() {
  imageHeight.value = 0
 }

-function readFile(next: File) {
+function readFile(next: File, opts?: { keepThumbnailPref?: boolean }) {
  file.value = next
  preview.value = URL.createObjectURL(next)
-  applyThumbnailDefault()
+  if (!opts?.keepThumbnailPref) applyThumbnailDefault()
  const img = new Image()
  img.onload = () => {
    imageWidth.value = img.naturalWidth
@@ -1584,6 +1709,7 @@ function onPickedImage(next: File, hidden = false) {
 }

 async function persistDroppedStill(next: File) {
+  if (/last[\s._-]*frame/i.test(next.name || '')) return
  const body = new FormData()
  body.append('image', next)
  body.append('folderId', folderId.value)
@@ -1657,7 +1783,7 @@ async function resumeTrack(kind: 'video' | 'edit', id: string, hidden: boolean,
    if (running && !settled) {
      if (kind === 'edit') {
        editBusy.value = true
-        editStatusMessage.value = snap.message || 'Reconnecting to sidecar ComfyUI...'
+        editStatusMessage.value = snap.message || 'Reconnecting to edit ComfyUI...'
      } else {
        videoBusy.value = true
        statusMessage.value = snap.message || 'Reconnecting to ComfyUI...'
@@ -1747,14 +1873,90 @@ function nextClipPartName(name: string) {
  return `${base.slice(0, Math.max(1, 80 - suffix.length))}${suffix}`
 }

-function rerun(item: LibraryClip) {
-  prompt.value = item.prompt
-  clipName.value = item.name || ''
-  seedInput.value = String(item.seed)
-  restoreAdvanced(item)
-  hideThumbnail.value = showPrivacyToggles.value && item.hideThumbnail
-  folderId.value = item.folderId
-  toast('Settings restored. Choose the same still if it is not already loaded.')
+function clipGenerateDuration(item: LibraryClip) {
+  if (item.parentClipId) {
+    const parent = clips.value.find(clip => clip.id === item.parentClipId)
+    if (parent?.duration && item.duration && item.duration > parent.duration + 0.4) {
+      return clampDuration(item.duration - parent.duration)
+    }
+  }
+  return clampDuration(Number(item.duration) || 5)
+}
+
+function familyPartsFor(item: LibraryClip) {
+  const key = clipFamilyKey(item)
+  const group = libraryGroups.value.find(entry => entry.key === key)
+  return chronologicalParts(group?.parts || [item])
+}
+
+async function loadRerunImage(item: LibraryClip, parts: LibraryClip[]) {
+  const index = Math.max(0, parts.findIndex(part => part.id === item.id))
+  const isExtension = index > 0 || Boolean(item.parentClipId) || (item.chainIndex || 0) > 0
+  if (isExtension) {
+    const previous = index > 0
+      ? parts[index - 1]
+      : clips.value.find(clip => clip.id === item.parentClipId)
+    if (previous) {
+      const blob = await $fetch<Blob>(`/api/library/clips/${previous.id}/last-frame`, { responseType: 'blob' })
+      readFile(new File([blob], 'last_frame.png', { type: blob.type || 'image/png' }), { keepThumbnailPref: true })
+      return true
+    }
+  }
+  const still = (item.stillId && stills.value.find(entry => entry.id === item.stillId))
+    || stills.value.find(entry => entry.folderId === item.folderId && entry.filename === `${item.id}.png`)
+  const stillId = still?.id || item.stillId
+  if (stillId) {
+    const blob = await $fetch<Blob>(`/api/library/stills/${stillId}`, { responseType: 'blob' })
+    if (still?.hideInput && showPrivacyToggles.value) hideInputPreview.value = true
+    readFile(new File([blob], still?.filename || 'still.png', { type: blob.type || 'image/png' }), { keepThumbnailPref: true })
+    return true
+  }
+  const blob = await $fetch<Blob>(`/api/library/clips/${item.id}/thumb`, { responseType: 'blob' })
+  readFile(new File([blob], 'start.jpg', { type: blob.type || 'image/jpeg' }), { keepThumbnailPref: true })
+  return true
+}
+
+async function rerun(item: LibraryClip, collection = false) {
+  studioMode.value = 'video'
+  closeExtend()
+  const parts = familyPartsFor(item)
+  const target = collection ? parts[0] || item : item
+  const restoreAll = collection && parts.length > 1
+  prompt.value = restoreAll ? familyScript(parts) : target.prompt
+  clipName.value = restoreAll
+    ? (familyBaseName(collectionTitle({ head: target, parts })) || target.name || '')
+    : (target.name || '')
+  seedInput.value = String(target.seed)
+  restoreAdvanced(target)
+  duration.value = clipGenerateDuration(target)
+  hideThumbnail.value = showPrivacyToggles.value && target.hideThumbnail
+  if (showPrivacyToggles.value) hideInputPreview.value = target.hideInput === true
+  folderId.value = target.folderId
+  browseFolderId.value = target.folderId
+  videoWorkflow.value = target.workflow === 'v2' ? 'v2' : 'v1'
+  if (typeof target.sound === 'boolean') withSound.value = target.sound
+  shotScriptMode.value = restoreAll
+  useIdentityRefs.value = false
+  identityRefs.value.forEach((_, index) => clearIdentityRef(index))
+  extensionQueue.value = restoreAll
+    ? parts.slice(1).map(part => ({
+      id: crypto.randomUUID(),
+      prompt: part.prompt,
+      duration: clipGenerateDuration(part)
+    }))
+    : []
+  try {
+    await loadRerunImage(target, parts)
+    statusMessage.value = restoreAll
+      ? 'Collection loaded into the form. Generate when you are ready.'
+      : 'Clip loaded into the form. Generate when you are ready.'
+    toast(restoreAll
+      ? 'Shot script and settings restored. Make any changes, then generate.'
+      : 'Inputs restored. Make any changes, then generate.')
+  } catch {
+    statusMessage.value = 'Clip settings loaded. Re-drop the start still if it is missing.'
+    toast('Settings restored, but the start still could not be loaded. Pick it again.')
+  }
 }

 async function loadDraft(draft: RetryDraft) {
@@ -1777,7 +1979,7 @@ async function loadDraft(draft: RetryDraft) {
  try {
    const blob = await $fetch<Blob>(`/api/library/drafts/${draft.id}/still`, { responseType: 'blob' })
    const filename = draft.stillFilename || 'held-still.png'
-    readFile(new File([blob], filename, { type: blob.type || 'image/png' }))
+    readFile(new File([blob], filename, { type: blob.type || 'image/png' }), { keepThumbnailPref: true })
    statusMessage.value = 'Held job restored. Generate when ComfyUI is free.'
  } catch {
    statusMessage.value = 'Held job settings restored. Re-drop the still if the image is missing.'
@@ -1946,10 +2148,15 @@ function openClip(item: LibraryClip) {
  }
 }

-async function removeClip(item: LibraryClip) {
+async function removeClip(item: LibraryClip, family = false) {
+  const watched = family ? familyPartsFor(item) : [item]
  try {
-    await $fetch(`/api/library/clips/${item.id}`, { method: 'DELETE' })
-    if (videoUrl.value.includes(item.id)) {
+    await $fetch(`/api/library/clips/${item.id}`, {
+      method: 'DELETE',
+      query: family ? { family: '1' } : undefined
+    })
+    const ids = new Set(watched.map(part => part.id))
+    if ([...ids].some(id => videoUrl.value.includes(id) || currentClipId.value === id)) {
      videoUrl.value = ''
      awaitingReveal.value = false
      concealOutput.value = false
@@ -1963,7 +2170,7 @@ async function removeClip(item: LibraryClip) {
  }
 }

-async function onMoveClip(item: LibraryClip, event: Event) {
+async function onMoveClip(item: LibraryClip, event: Event, family = false) {
  const select = event.target as HTMLSelectElement
  const destId = select.value
  select.value = ''
@@ -1971,21 +2178,25 @@ async function onMoveClip(item: LibraryClip, event: Event) {
  try {
    applyLibrary(await $fetch(`/api/library/clips/${item.id}`, {
      method: 'PATCH',
-      body: { folderId: destId }
+      body: { folderId: destId, family: family || undefined }
    }))
    const dest = folders.value.find(folder => folder.id === destId)
    if (dest?.unlocked) browseFolderId.value = destId
    statusMessage.value = dest?.unlocked
-      ? `Moved to ${dest.name}`
-      : `Moved to ${dest?.name || 'folder'} (locked)`
+      ? `Moved ${family ? 'collection' : 'clip'} to ${dest.name}`
+      : `Moved ${family ? 'collection' : 'clip'} to ${dest?.name || 'folder'} (locked)`
  } catch (error: any) {
    toast(error?.data?.statusMessage || 'Could not move clip')
  }
 }

-function startRename(item: LibraryClip) {
+function startRename(item: LibraryClip, family = false) {
  renamingId.value = item.id
-  renameDraft.value = (item.name || '').trim() || clipFileName(item.prompt.split(/[.!?\n]/)[0] || 'aigen')
+  renamingFamily.value = family
+  const source = family
+    ? (familyBaseName(item.name || '') || item.name || '')
+    : (item.name || '')
+  renameDraft.value = source.trim() || clipFileName(item.prompt.split(/[.!?\n]/)[0] || 'aigen')
  nextTick(() => {
    renameInput.value?.focus()
    renameInput.value?.select()
@@ -1994,31 +2205,33 @@ function startRename(item: LibraryClip) {

 function cancelRename() {
  renamingId.value = ''
+  renamingFamily.value = false
  renameDraft.value = ''
 }

-async function saveRename(item: LibraryClip) {
-  if (renamingId.value !== item.id) return
+async function saveRename(item: LibraryClip, family = false) {
+  if (renamingId.value !== item.id || renamingFamily.value !== family) return
  const name = renameDraft.value.trim().slice(0, 80)
  if (!name) {
    toast('A name is required')
    nextTick(() => renameInput.value?.focus())
    return
  }
-  if (name === item.name) {
+  const current = family ? familyBaseName(item.name || '') : item.name
+  if (name === current) {
    cancelRename()
    return
  }
  try {
    applyLibrary(await $fetch(`/api/library/clips/${item.id}`, {
      method: 'PATCH',
-      body: { name }
+      body: { name, family: family || undefined }
    }))
    cancelRename()
    if (videoUrl.value.includes(item.id)) {
      videoDownloadName.value = clipFileName(name)
    }
-    statusMessage.value = `Renamed to ${name}`
+    statusMessage.value = family ? `Renamed collection to ${familyBaseName(name) || name}` : `Renamed to ${name}`
  } catch (error: any) {
    toast(error?.data?.statusMessage || 'Could not rename clip')
  }
@@ -2061,7 +2274,7 @@ async function editImage() {
  editResultUrl.value = ''
  editAwaitingReveal.value = false
  editLockedSave.value = false
-  editStatusMessage.value = 'Checking sidecar ComfyUI...'
+  editStatusMessage.value = 'Choosing Beast or Sidecar...'
  editMaxStep.value = editSteps.value
  startTimer('edit')
  try {
@@ -2119,11 +2332,6 @@ async function generate() {
    toast('Choose a library folder before generating.')
    return
  }
-  const identityFiles = identityRefs.value.filter((item): item is File => Boolean(item))
-  if (videoWorkflow.value === 'v2' && useIdentityRefs.value && !identityFiles.length) {
-    toast('Add at least one identity reference still, or turn references off.')
-    return
-  }
  const shots = shotScriptMode.value ? parsedShots.value : null
  const initialPrompt = (shots?.[0]?.prompt || prompt.value).trim()
  const queued = shots
@@ -2173,9 +2381,9 @@ async function generate() {
    body.append('workflow', videoWorkflow.value)
    body.append('useIdentityRefs', String(videoWorkflow.value === 'v2' && useIdentityRefs.value))
    if (videoWorkflow.value === 'v2' && useIdentityRefs.value) {
-      for (const ref of identityFiles) {
-        body.append('refImage', ref)
-      }
+      identityRefs.value.forEach((ref, index) => {
+        if (ref) body.append(`refImage${index}`, ref)
+      })
    }
    if (activeDraftId) body.append('draftId', activeDraftId)
    if (queued.length) {
@@ -2443,7 +2651,7 @@ async function cancelJob() {
    else statusMessage.value = 'Job cancelled. ComfyUI is idle — generate again.'
  } catch (error: any) {
    toast(error?.statusMessage || error?.data?.statusMessage || 'Failed to interrupt ComfyUI')
-    if (kind === 'edit') editStatusMessage.value = 'Cancelled locally. Edit again when the sidecar is free.'
+    if (kind === 'edit') editStatusMessage.value = 'Cancelled locally. Edit again when a box is free.'
    else statusMessage.value = 'Cancelled locally. Generate again when ComfyUI is free.'
  }
  if (kind === 'edit') {
@@ -129,6 +129,8 @@ function inputRoots() {
  const roots = [
    process.env.COMFY_INPUT_DIR || join(local, 'Comfy-Desktop', 'ComfyUI-Shared', 'input')
  ]
+  const cwd = process.env.COMFY_LAUNCH_CWD
+  if (cwd) roots.push(join(cwd, 'input'))
  const installs = join(local, 'Comfy-Desktop', 'ComfyUI-Installs')
  try {
    for (const dir of readdirSync(installs, { withFileTypes: true })) {
@@ -136,7 +138,14 @@ function inputRoots() {
      roots.push(join(installs, dir.name, 'ComfyUI', 'input'))
    }
  } catch { /* ignore */ }
-  return roots
+  return [...new Set(roots)]
+}
+
+function outputRoots() {
+  const roots = [sharedRoots().output]
+  const cwd = process.env.COMFY_LAUNCH_CWD
+  if (cwd) roots.push(join(cwd, 'output'))
+  return [...new Set(roots)]
 }

 function safeFile(root, subfolder, filename) {
@@ -171,7 +180,6 @@ function readJson(req) {
 }

 function purgeDesktopFiles(body) {
-  const roots = sharedRoots()
  const deleted = []
  const imageName = String(body?.imageName || body?.filename || '')
  const imageSub = String(body?.imageSubfolder || '')
@@ -189,8 +197,28 @@ function purgeDesktopFiles(body) {
  const video = body?.video || null
  const videoName = String(video?.filename || '')
  if (videoName) {
-    const outputPath = safeFile(roots.output, video.subfolder || 'video', videoName)
-    if (removeFile(outputPath)) deleted.push(outputPath)
+    for (const root of outputRoots()) {
+      const nested = safeFile(root, video.subfolder || 'video', videoName)
+      if (removeFile(nested)) deleted.push(nested)
+      const flat = safeFile(root, '', videoName)
+      if (removeFile(flat)) deleted.push(flat)
+    }
+  }
+  const output = body?.output || null
+  const outputName = String(output?.filename || '')
+  if (outputName) {
+    const type = String(output?.type || 'output')
+    const sub = String(output?.subfolder || '')
+    const rootsForType = type === 'input' ? inputRoots() : outputRoots()
+    for (const root of rootsForType) {
+      if (!existsSync(root)) continue
+      const nested = safeFile(root, sub, outputName)
+      if (removeFile(nested)) deleted.push(nested)
+      if (sub) {
+        const flat = safeFile(root, '', outputName)
+        if (removeFile(flat)) deleted.push(flat)
+      }
+    }
  }
  console.log(JSON.stringify({ src: 'comfy-host-agent', event: 'purge', deleted: deleted.length, files: deleted.map((path) => basename(path)), imageName }))
  return { ok: true, deleted }
@@ -71,7 +71,9 @@ def main():
        "set COMFY_HOST=http://127.0.0.1:8188",
        f"set COMFY_CONTROL_TOKEN={token}",
        r"set COMFY_LAUNCH_CWD=C:\ComfyUI-QwenEdit\ComfyUI",
-        r"set COMFY_LAUNCH_CMD=C:\ComfyUI-QwenEdit\python\python.exe C:\ComfyUI-QwenEdit\ComfyUI\main.py --listen 0.0.0.0 --port 8188",
+        r"set COMFY_INPUT_DIR=C:\ComfyUI-QwenEdit\ComfyUI\input",
+        r"set COMFY_OUTPUT_DIR=C:\ComfyUI-QwenEdit\ComfyUI\output",
+        r"set COMFY_LAUNCH_CMD=C:\ComfyUI-QwenEdit\python\python.exe C:\ComfyUI-QwenEdit\ComfyUI\main.py --listen 0.0.0.0 --port 8188 --disable-auto-launch --lowvram --fp8_e4m3fn-unet --disable-cuda-malloc",
        r'"C:\Users\comfyapi\aigen-agent\node.exe" comfy-host-agent.mjs',
        "",
    ])
@@ -1,5 +1,5 @@
-import { imageComfyConfigured, uploadImageEdit, queueImagePrompt, waitForImageEdit, downloadEditedImage } from '~/server/utils/imageComfy'
-import { ensureImageComfyReady } from '~/server/utils/imageComfyLifecycle'
+import { imageComfyConfigured, uploadImageEdit, queueImagePrompt, waitForImageEdit, downloadEditedImage, purgeImageComfyArtifacts, withImageComfyHost } from '~/server/utils/imageComfy'
+import { pickImageEditHost } from '~/server/utils/imageComfyLifecycle'
 import { buildEditWorkflow } from '~/server/utils/imageWorkflow'
 import { imageDimensions } from '~/server/utils/resolution'

@@ -43,7 +43,7 @@ export default defineEventHandler(async (event) => {
  if (!imageComfyConfigured()) {
    throw createError({
      statusCode: 503,
-      statusMessage: 'Image edit ComfyUI is not configured yet. Set IMAGE_COMFY_HOST on this instance.'
+      statusMessage: 'Image edit ComfyUI is not configured yet. Set COMFY_HOST for Beast and IMAGE_COMFY_HOST for Sidecar overflow.'
    })
  }

@@ -88,7 +88,7 @@ export default defineEventHandler(async (event) => {
    seed,
    cfg
  }
-  emitJob(job, { type: 'status', message: 'Checking sidecar ComfyUI...', progress: 2 })
+  emitJob(job, { type: 'status', message: 'Choosing Beast or Sidecar...', progress: 2 })

  void runEdit(job, {
    image,
@@ -127,7 +127,7 @@ async function runEdit(
    denoise: number
  }
 ) {
-  await ensureImageComfyReady((status) => {
+  const target = await pickImageEditHost((status) => {
    emitJob(job, {
      type: status.state === 'busy' ? 'busy' : 'status',
      message: status.message,
@@ -135,13 +135,23 @@ async function runEdit(
      busy: status.state === 'busy'
    })
  })
+  job.imageComfyHost = target.host
  if (job.status === 'cancelled') throw new Error('Job interrupted.')

-  emitJob(job, { type: 'status', message: 'Uploading still to Qwen Edit...', progress: 8 })
+  await withImageComfyHost(target.host, async () => {
+    emitJob(job, {
+      type: 'status',
+      message: `Uploading still to ${target.label}...`,
+      progress: 8
+    })
    const uploaded = await uploadImageEdit(params.image, job.id)
    if (job.status === 'cancelled') throw new Error('Job interrupted.')

-  emitJob(job, { type: 'status', message: 'Queueing Qwen Image Edit Lightning...', progress: 12 })
+    emitJob(job, {
+      type: 'status',
+      message: `Queueing Qwen Image Edit on ${target.label}...`,
+      progress: 12
+    })
    const graph = buildEditWorkflow({
      prompt: params.prompt,
      negative: params.negative,
@@ -155,7 +165,7 @@ async function runEdit(
    const queued = await queueImagePrompt(graph, job.clientId)
    job.promptId = queued.prompt_id
    job.status = 'running'
-  emitJob(job, { type: 'status', message: 'Editing still...', progress: 18, maxStep: params.steps })
+    emitJob(job, { type: 'status', message: `Editing still on ${target.label}...`, progress: 18, maxStep: params.steps })

    const output = await waitForImageEdit({
      promptId: queued.prompt_id,
@@ -185,17 +195,24 @@ async function runEdit(
      height: size?.height || 0,
      hideInput: job.library?.hideInput
    })
-  job.stillId = still.id
+    job.stillId = still?.id
+    await purgeImageComfyArtifacts({
+      output,
+      inputName: uploaded.name,
+      inputSubfolder: uploaded.subfolder,
+      promptId: job.promptId
+    })
    job.status = 'complete'
    emitJob(job, {
      type: 'complete',
-    message: 'Edit finished',
+      message: `Edit finished on ${target.label}`,
      progress: 100,
-    stillId: still.id,
+      stillId: still?.id,
      filename: output.filename,
      subfolder: output.subfolder,
      mediaType: 'image',
      hideThumbnail: job.hideThumbnail,
      folderLocked: job.library?.folderLocked
    })
+  })
 }
@@ -165,6 +165,7 @@ async function runExtend(
  copyFileSync(params.sourcePath, params.part1Path)
  await extractLastFrame(params.part1Path, params.framePath)
  const frame = readFileSync(params.framePath)
+  if (job.library) job.library.thumb = undefined
  const sound = await probeHasAudio(params.part1Path)

  await ensureComfyReady((status) => {
@@ -83,13 +83,20 @@ export default defineEventHandler(async (event) => {

  const fields: Record<string, string> = {}
  let image: { filename: string; data: Buffer; type?: string } | null = null
-  const referenceImages: { filename: string; data: Buffer; type?: string }[] = []
+  const referenceImages: Array<{ filename: string; data: Buffer; type?: string } | null> = [null, null, null, null]
+  let compactRefSlot = 0
  for (const part of form) {
    if (part.name === 'image' && part.filename && part.data?.length) {
      image = { filename: part.filename, data: part.data, type: part.type }
+    } else if (part.name && /^refImage(\d)$/.test(part.name) && part.filename && part.data?.length) {
+      const slot = Number(part.name.replace('refImage', ''))
+      if (slot >= 0 && slot < 4) {
+        referenceImages[slot] = { filename: part.filename, data: part.data, type: part.type }
+      }
    } else if (part.name === 'refImage' && part.filename && part.data?.length) {
-      if (referenceImages.length < 4) {
-        referenceImages.push({ filename: part.filename, data: part.data, type: part.type })
+      if (compactRefSlot < 4) {
+        referenceImages[compactRefSlot] = { filename: part.filename, data: part.data, type: part.type }
+        compactRefSlot += 1
      }
    } else if (part.name && part.data) {
      fields[part.name] = part.data.toString('utf8')
@@ -105,7 +112,7 @@ export default defineEventHandler(async (event) => {
  }
  const extensions = parseExtensions(fields.extensions)
  const workflow = parseVideoWorkflow(fields.workflow)
-  const useIdentityRefs = workflow === 'v2' && fields.useIdentityRefs === 'true' && referenceImages.length > 0
+  const useIdentityRefs = workflow === 'v2' && fields.useIdentityRefs === 'true'

  const { width, height } = resolveOutputSize(fields.aspect, image.data, Number(fields.width), Number(fields.height))
  const turbo = fields.turbo !== 'false'
@@ -134,7 +141,9 @@ export default defineEventHandler(async (event) => {
  const destFolder = library.folders.find(folder => folder.id === folderId)
  const folderLocked = Boolean(destFolder?.protected && !destFolder.unlocked)
  assertFolderExists(event, folderId)
-  const still = await saveStill({
+  const still = isPipelineFrameFilename(image.filename)
+    ? null
+    : await saveStill({
      ownerKey,
      folderId,
      filename: image.filename,
@@ -167,9 +176,9 @@ export default defineEventHandler(async (event) => {
    fps,
    samplerName,
    scheduler,
-    thumb: image.data,
-    stillId: still.id,
-    stillFilename: still.filename,
+    thumb: isPipelineFrameFilename(image.filename) ? undefined : image.data,
+    stillId: still?.id,
+    stillFilename: still?.filename,
    duration: durationSeconds,
    sound,
    draftId: (fields.draftId || '').trim() || undefined,
@@ -285,7 +294,7 @@ type GenerateParams = {
  workflow: 'v1' | 'v2'
  duration: number
  useIdentityRefs: boolean
-  referenceImages: { filename: string; data: Buffer; type?: string }[]
+  referenceImages: Array<{ filename: string; data: Buffer; type?: string } | null>
 }

 async function queueMiniMax(
@@ -308,15 +317,16 @@ async function queueMiniMax(
    : 'Queueing MiniMax H3 job...'
  emitChainJob(job, { type: 'status', message: uploading, progress: 4 })
  const uploaded = await uploadImage(params.image, job.id)
-  const referenceNames: string[] = []
+  const referenceNames: string[] = ['', '', '', '']
  const chainIndex = job.library?.chainIndex || 0
  if (chainIndex === 0) {
    for (const [index, ref] of (params.referenceImages || []).entries()) {
+      if (!ref?.data?.length) continue
      const next = await uploadImage({
        ...ref,
        filename: `ref${index + 1}_${ref.filename || 'identity.png'}`
      }, job.id)
-      referenceNames.push(next.name)
+      referenceNames[index] = next.name
    }
  }
  if (job.library) {
@@ -378,7 +388,9 @@ async function queueMiniMax(
      extendPart1Path: job.library.extendPart1Path,
      familyId: job.library.familyId,
      parentClipId: job.library.parentClipId,
-      chainIndex: job.library.chainIndex
+      chainIndex: job.library.chainIndex,
+      stillId: job.library.stillId,
+      sound: job.library.sound
    })
  }
  emitChainJob(job, { type: 'status', message: 'Job queued on ComfyUI', progress: 8 })
@@ -430,6 +442,7 @@ async function runGeneration(
    job.library.chainStep = i + 2
    job.library.chainLabel = `Extension ${i + 1}`
    job.library.extendPart1Path = undefined
+    job.library.thumb = undefined

    emitChainJob(job, { type: 'status', message: 'Waiting 3s buffer...', progress: 1 })
    await sleep(3000)
@@ -1,23 +1,36 @@
 import { checkComfyHttp, fetchQueue } from '~/server/utils/comfyLifecycle'
 import { comfyConfigured } from '~/server/utils/comfy'
-import { imageComfyConfigured } from '~/server/utils/imageComfy'
-import { checkImageComfyHttp, fetchImageQueue } from '~/server/utils/imageComfyLifecycle'
+import { imageComfyConfigured, getBeastImageHost, getSidecarImageHost, sameImageHost } from '~/server/utils/imageComfy'
+import { checkImageComfyHttp, fetchQueueAt } from '~/server/utils/imageComfyLifecycle'

 export default defineEventHandler(async () => {
  const videoConfigured = comfyConfigured()
  const imageConfigured = imageComfyConfigured()
-  const [comfy, queue, imageComfy, imageQueue] = await Promise.all([
+  const beastHost = getBeastImageHost()
+  const sidecarHost = getSidecarImageHost()
+  const [comfy, queue, beast, beastQueue, sidecar, sidecarQueue] = await Promise.all([
    videoConfigured
      ? checkComfyHttp().catch(() => ({ ok: false, host: '', stats: null }))
      : Promise.resolve({ ok: false, host: '', stats: null }),
    videoConfigured ? fetchQueue() : Promise.resolve({ running: 0, pending: 0 }),
-    imageConfigured
-      ? checkImageComfyHttp().catch(() => ({ ok: false, host: '', stats: null }))
-      : Promise.resolve({ ok: false, host: '', stats: null }),
-    imageConfigured ? fetchImageQueue() : Promise.resolve({ running: 0, pending: 0 })
+    beastHost
+      ? checkImageComfyHttp(2500, beastHost).catch(() => ({ ok: false, host: beastHost, stats: null }))
+      : Promise.resolve({ ok: false, host: beastHost, stats: null }),
+    beastHost ? fetchQueueAt(beastHost) : Promise.resolve({ running: 0, pending: 0 }),
+    sidecarHost && (!beastHost || !sameImageHost(beastHost, sidecarHost))
+      ? checkImageComfyHttp(2500, sidecarHost).catch(() => ({ ok: false, host: sidecarHost, stats: null }))
+      : Promise.resolve({ ok: false, host: sidecarHost, stats: null }),
+    sidecarHost && (!beastHost || !sameImageHost(beastHost, sidecarHost))
+      ? fetchQueueAt(sidecarHost)
+      : Promise.resolve({ running: 0, pending: 0 })
  ])
  const busy = Boolean(comfy.ok && queue.running > 0)
-  const imageBusy = Boolean(imageComfy.ok && imageQueue.running > 0)
+  const beastBusy = Boolean(beast.ok && beastQueue.running > 0)
+  const sidecarBusy = Boolean(sidecar.ok && sidecarQueue.running > 0)
+  const sidecarConfigured = Boolean(sidecarHost && (!beastHost || !sameImageHost(beastHost, sidecarHost)))
+  const imageOk = Boolean(beast.ok || sidecar.ok)
+  const imageBusy = Boolean(imageConfigured && ((beastBusy && (!sidecarConfigured || sidecarBusy || !sidecar.ok)) || (!beast.ok && sidecarBusy)))
+  const preferredHost = beast.ok && !beastBusy ? beastHost : (sidecar.ok ? sidecarHost : beastHost)
  return {
    ok: true,
    service: useRuntimeConfig().public.instanceName || 'aigen',
@@ -31,11 +44,26 @@ export default defineEventHandler(async () => {
    },
    imageComfy: {
      configured: imageConfigured,
-      ok: imageComfy.ok,
+      ok: imageOk,
      busy: imageBusy,
-      host: imageComfy.host || '',
-      queueRunning: imageQueue.running,
-      queuePending: imageQueue.pending
+      host: preferredHost || '',
+      box: beast.ok && !beastBusy ? 'beast' : (sidecar.ok ? 'sidecar' : (beast.ok ? 'beast' : '')),
+      queueRunning: (beast.ok && !beastBusy ? beastQueue.running : sidecarQueue.running) || 0,
+      queuePending: (beast.ok && !beastBusy ? beastQueue.pending : sidecarQueue.pending) || 0,
+      beast: {
+        label: 'Beast',
+        configured: Boolean(beastHost),
+        ok: Boolean(beast.ok),
+        busy: beastBusy,
+        host: beastHost || ''
+      },
+      sidecar: {
+        label: 'Sidecar',
+        configured: sidecarConfigured,
+        ok: Boolean(sidecar.ok),
+        busy: sidecarBusy,
+        host: sidecarHost || ''
+      }
    }
  }
 })
@@ -10,7 +10,7 @@ export default defineEventHandler(async (event) => {
  if (jobId) deletePendingJob(jobId)
  const kind = job?.kind || (body?.kind === 'edit' ? 'edit' : 'video')
  const ok = kind === 'edit'
-    ? await interruptImageComfy()
+    ? await interruptImageComfy(job?.imageComfyHost)
    : await interruptComfy()
  if (job) {
    emitJob(job, { type: 'error', error: 'Job interrupted.', message: 'Job interrupted.' })
@@ -3,6 +3,8 @@ export default defineEventHandler(async (event) => {
  const id = String(getRouterParam(event, 'id') || '')
  const clip = getClip(owner, id)
  assertFolderAccess(event, clip.folderId)
-  await deleteClip(owner, id)
+  const family = ['1', 'true'].includes(String(getQuery(event).family || '').toLowerCase())
+  if (family) await deleteClipFamily(owner, id)
+  else await deleteClip(owner, id)
  return { ok: true }
 })
@@ -1,9 +1,10 @@
 export default defineEventHandler(async (event) => {
  const { owner } = assertLibraryOwner(event)
  const id = String(getRouterParam(event, 'id') || '')
-  const body = await readBody<{ folderId?: string; name?: string }>(event).catch(() => ({} as { folderId?: string; name?: string }))
+  const body = await readBody<{ folderId?: string; name?: string; family?: boolean }>(event).catch(() => ({} as { folderId?: string; name?: string; family?: boolean }))
  const folderId = String(body?.folderId || '')
  const hasName = typeof body?.name === 'string'
+  const family = body?.family === true
  if (!folderId && !hasName) {
    throw createError({ statusCode: 400, statusMessage: 'Choose a library folder or a new name' })
  }
@@ -11,8 +12,12 @@ export default defineEventHandler(async (event) => {
  assertFolderAccess(event, clip.folderId)
  if (folderId) {
    assertFolderExists(event, folderId)
-    await moveClip(owner, id, folderId)
+    if (family) await moveClipFamily(owner, id, folderId)
+    else await moveClip(owner, id, folderId)
+  }
+  if (hasName) {
+    if (family) await renameClipFamily(owner, id, body.name || '')
+    else await renameClip(owner, id, body.name || '')
  }
-  if (hasName) await renameClip(owner, id, body.name || '')
  return publicLibrary(event)
 })
@@ -5,6 +5,7 @@ export default defineEventHandler(async (event) => {
    const folderId = library.folders.find(folder => folder.unlocked)?.id
    if (folderId) await importMissingComfyVideos(owner, folderId)
    await ensureClipThumbnails(owner)
+    await sweepOwnerExtensionStills(owner)
  } catch {
    return publicLibrary(event)
  }
@@ -33,5 +33,5 @@ export default defineEventHandler(async (event) => {
    height: Number(fields.height || 0),
    hideInput: fields.hideInput === 'true'
  })
-  return { still, ...publicLibrary(event) }
+  return { still: still || undefined, ...publicLibrary(event) }
 })
@@ -62,7 +62,7 @@
  },
  "141": {
    "inputs": {
-      "image": ""
+      "image": "Mokker (1).jpeg"
    },
    "class_type": "LoadImage",
    "_meta": {
@@ -71,7 +71,7 @@
  },
  "142": {
    "inputs": {
-      "image": ""
+      "image": "Mokker (1).jpeg"
    },
    "class_type": "LoadImage",
    "_meta": {
@@ -80,7 +80,7 @@
  },
  "143": {
    "inputs": {
-      "image": ""
+      "image": "Mokker (1).jpeg"
    },
    "class_type": "LoadImage",
    "_meta": {
@@ -107,7 +107,10 @@
        "127",
        1
      ],
-      "length": 241,
+      "length": [
+        "174",
+        1
+      ],
      "ref_image_size": "match",
      "clip": [
        "170",
@@ -1,7 +1,7 @@
 {
  "1": {
    "inputs": {
-      "unet_name": "qwen_image_edit_2509_fp8_e4m3fn.safetensors",
+      "unet_name": "split_files\\diffusion_models\\qwen_image_edit_2509_fp8_e4m3fn.safetensors",
      "weight_dtype": "default"
    },
    "class_type": "UNETLoader",
@@ -39,21 +39,22 @@
    "class_type": "LoadImage",
    "_meta": { "title": "Load input still" }
  },
-  "5": {
+  "17": {
    "inputs": {
-      "text": "",
-      "clip": ["2", 0]
+      "prompt": "",
+      "clip": ["2", 0],
+      "vae": ["3", 0],
+      "image": ["4", 0]
    },
-    "class_type": "CLIPTextEncode",
-    "_meta": { "title": "Positive prompt" }
+    "class_type": "TextEncodeQwenImageEdit",
+    "_meta": { "title": "Qwen Image Edit prompt" }
  },
-  "6": {
+  "19": {
    "inputs": {
-      "text": "blurry, low quality, deformed, bad anatomy, watermark, text, extra fingers",
-      "clip": ["2", 0]
+      "conditioning": ["17", 0]
    },
-    "class_type": "CLIPTextEncode",
-    "_meta": { "title": "Negative prompt" }
+    "class_type": "ConditioningZeroOut",
+    "_meta": { "title": "Zero negative" }
  },
  "7": {
    "inputs": {
@@ -70,10 +71,10 @@
      "cfg": 1,
      "sampler_name": "euler",
      "scheduler": "simple",
-      "denoise": 0.75,
+      "denoise": 1,
      "model": ["11", 0],
-      "positive": ["5", 0],
-      "negative": ["6", 0],
+      "positive": ["17", 0],
+      "negative": ["19", 0],
      "latent_image": ["7", 0]
    },
    "class_type": "KSampler",
@@ -0,0 +1,22 @@
+import { sweepAllExtensionStills } from '../utils/library'
+
+export default defineNitroPlugin(() => {
+  try {
+    const result = sweepAllExtensionStills()
+    if (result.deleted) {
+      console.log(JSON.stringify({
+        src: 'library',
+        event: 'purge-extension-stills',
+        owners: result.owners,
+        deleted: result.deleted,
+        filenames: result.filenames.slice(0, 40)
+      }))
+    }
+  } catch (error) {
+    console.log(JSON.stringify({
+      src: 'library',
+      event: 'purge-extension-stills-error',
+      error: error instanceof Error ? error.message : String(error)
+    }))
+  }
+})
@@ -1,17 +1,22 @@
+import { AsyncLocalStorage } from 'node:async_hooks'
+import { getComfyHost } from '~/server/utils/comfy'
+
+const imageHostAls = new AsyncLocalStorage<string>()
 let imageComfyHostOverride = ''

+export type ImageEditBox = 'beast' | 'sidecar'
+
+export function withImageComfyHost<T>(host: string, fn: () => Promise<T>) {
+  return imageHostAls.run(String(host || '').replace(/\/$/, ''), fn)
+}
+
 export function setImageComfyHostOverride(url: string) {
  imageComfyHostOverride = String(url || '').replace(/\/$/, '')
 }

-export function getImageComfyHost() {
-  if (imageComfyHostOverride) return imageComfyHostOverride
-  const config = useRuntimeConfig()
-  let host = String(config.imageComfyHost || process.env.IMAGE_COMFY_HOST || '').trim().replace(/\/$/, '')
-  const port = String(config.imageComfyPort || process.env.IMAGE_COMFY_PORT || '').trim()
-  if (!host) {
-    throw createError({ statusCode: 500, statusMessage: 'IMAGE_COMFY_HOST is not configured' })
-  }
+function normalizeHost(raw: string, port = '') {
+  let host = String(raw || '').trim().replace(/\/$/, '')
+  if (!host) return ''
  if (!/^https?:\/\//i.test(host)) host = `http://${host}`
  try {
    const url = new URL(host)
@@ -22,13 +27,46 @@ export function getImageComfyHost() {
  }
 }

-export function imageComfyConfigured() {
+export function getBeastImageHost() {
  const config = useRuntimeConfig()
-  return Boolean(String(config.imageComfyHost || process.env.IMAGE_COMFY_HOST || '').trim())
+  const explicit = String(config.imageComfyPrimaryHost || process.env.IMAGE_COMFY_PRIMARY_HOST || '').trim()
+  if (explicit) return normalizeHost(explicit)
+  try {
+    return getComfyHost()
+  } catch {
+    return ''
+  }
+}
+
+export function getSidecarImageHost() {
+  const config = useRuntimeConfig()
+  const fallback = String(config.imageComfyFallbackHost || process.env.IMAGE_COMFY_FALLBACK_HOST || '').trim()
+  if (fallback) return normalizeHost(fallback)
+  const legacy = String(config.imageComfyHost || process.env.IMAGE_COMFY_HOST || '').trim()
+  const port = String(config.imageComfyPort || process.env.IMAGE_COMFY_PORT || '').trim()
+  return normalizeHost(legacy, port)
+}
+
+export function getImageComfyHost() {
+  const fromAls = imageHostAls.getStore()
+  if (fromAls) return fromAls
+  if (imageComfyHostOverride) return imageComfyHostOverride
+  return getBeastImageHost() || getSidecarImageHost()
+}
+
+export function imageComfyConfigured() {
+  return Boolean(getBeastImageHost() || getSidecarImageHost())
+}
+
+export function sameImageHost(a: string, b: string) {
+  return Boolean(a && b && a.replace(/\/$/, '') === b.replace(/\/$/, ''))
 }

 export async function imageComfyFetch(path: string, init?: RequestInit) {
  const host = getImageComfyHost()
+  if (!host) {
+    throw createError({ statusCode: 500, statusMessage: 'No image ComfyUI host is configured' })
+  }
  try {
    return await fetch(`${host}${path}`, init)
  } catch (error) {
@@ -88,10 +126,14 @@ export async function queueImagePrompt(graph: unknown, clientId: string) {
  return payload as { prompt_id: string; number?: number }
 }

-export async function interruptImageComfy() {
-  if (!imageComfyConfigured()) return false
+export async function interruptImageComfy(host?: string) {
+  if (!imageComfyConfigured() && !host) return false
+  const run = async () => {
    const res = await imageComfyFetch('/interrupt', { method: 'POST' })
    return res.ok
+  }
+  if (host) return withImageComfyHost(host, run)
+  return run()
 }

 export async function fetchImageHistory(promptId: string) {
@@ -253,3 +295,113 @@ export async function waitForImageEdit(opts: {
  })
 }

+function purgeImageEnabled() {
+  return useRuntimeConfig().purgeComfyOutputs !== false
+}
+
+async function deleteSidecarFile(file: { filename: string; subfolder?: string; type?: string }) {
+  const payload = {
+    filename: file.filename,
+    subfolder: file.subfolder || '',
+    type: file.type || 'output'
+  }
+  for (const path of ['/delete', '/aigen/purge']) {
+    try {
+      const res = await imageComfyFetch(path, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+        signal: AbortSignal.timeout(4000)
+      })
+      if (res.ok) return true
+    } catch {
+      /* Comfy may not expose this route */
+    }
+  }
+  return false
+}
+
+async function purgeImageOnDesktop(opts: {
+  inputName?: string
+  inputSubfolder?: string
+  output?: { filename: string; subfolder: string; type: string }
+}) {
+  const config = useRuntimeConfig()
+  const host = getImageComfyHost()
+  const sidecar = getSidecarImageHost()
+  const useSidecarAgent = sidecar && sameImageHost(host, sidecar)
+  const controlUrl = String(
+    useSidecarAgent
+      ? (config.imageComfyControlUrl || process.env.IMAGE_COMFY_CONTROL_URL || '')
+      : (config.comfyControlUrl || process.env.COMFY_CONTROL_URL || '')
+  ).replace(/\/$/, '')
+  const token = String(
+    useSidecarAgent
+      ? (config.imageComfyControlToken || process.env.IMAGE_COMFY_CONTROL_TOKEN || '')
+      : (config.comfyControlToken || process.env.COMFY_CONTROL_TOKEN || '')
+  )
+  if (!controlUrl) return
+  try {
+    await fetch(`${controlUrl}/purge`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        Accept: 'application/json',
+        ...(token ? { Authorization: `Bearer ${token}` } : {})
+      },
+      body: JSON.stringify({
+        imageName: opts.inputName || '',
+        imageSubfolder: opts.inputSubfolder || '',
+        output: opts.output || null
+      }),
+      signal: AbortSignal.timeout(4000)
+    })
+  } catch {
+    /* Sidecar host agent is optional; Comfy HTTP delete is the primary path. */
+  }
+}
+
+export async function purgeImageComfyArtifacts(opts: {
+  output?: { filename: string; subfolder: string; type: string }
+  inputName?: string
+  inputSubfolder?: string
+  promptId?: string
+}) {
+  if (!purgeImageEnabled()) return
+  const files: { filename: string; subfolder: string; type: string }[] = []
+  if (opts.output?.filename) {
+    files.push({
+      filename: opts.output.filename,
+      subfolder: opts.output.subfolder || '',
+      type: opts.output.type || 'output'
+    })
+  }
+  if (opts.inputName) {
+    files.push({
+      filename: opts.inputName,
+      subfolder: opts.inputSubfolder || '',
+      type: 'input'
+    })
+  }
+  for (const file of files) {
+    await deleteSidecarFile(file)
+  }
+  await purgeImageOnDesktop({
+    inputName: opts.inputName,
+    inputSubfolder: opts.inputSubfolder,
+    output: opts.output
+  })
+  if (opts.promptId) {
+    try {
+      await imageComfyFetch('/history', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ delete: [opts.promptId] }),
+        signal: AbortSignal.timeout(4000)
+      })
+    } catch {
+      /* ignore */
+    }
+  }
+}
+
@@ -1,4 +1,4 @@
-import { getImageComfyHost, setImageComfyHostOverride, imageComfyConfigured } from '~/server/utils/imageComfy'
+import { getImageComfyHost, setImageComfyHostOverride, imageComfyConfigured, getBeastImageHost, getSidecarImageHost, sameImageHost, withImageComfyHost, type ImageEditBox } from '~/server/utils/imageComfy'

 export type ImageComfyState = 'online' | 'booting' | 'busy' | 'starting' | 'offline'

@@ -6,11 +6,18 @@ export interface ImageComfyStatus {
  state: ImageComfyState
  message: string
  host: string
+  box?: ImageEditBox
  processRunning?: boolean
  queueRunning?: number
  queuePending?: number
 }

+export interface ImageEditTarget {
+  host: string
+  box: ImageEditBox
+  label: string
+}
+
 type StatusFn = (status: ImageComfyStatus) => void

 let gate: Promise<unknown> = Promise.resolve()
@@ -51,6 +58,7 @@ export async function checkImageComfyHttp(timeoutMs = 2500, host?: string) {
      if (!imageComfyConfigured()) return { ok: false as const, host: '', status: 0, stats: null }
      resolved = getImageComfyHost()
    }
+    if (!resolved) return { ok: false as const, host: '', status: 0, stats: null }
    const res = await fetch(`${resolved}/system_stats`, { signal: AbortSignal.timeout(timeoutMs) })
    if (!res.ok) return { ok: false as const, host: resolved, status: res.status, stats: null }
    const stats = await res.json().catch(() => null)
@@ -60,9 +68,9 @@ export async function checkImageComfyHttp(timeoutMs = 2500, host?: string) {
  }
 }

-export async function fetchImageQueue() {
+export async function fetchQueueAt(host: string) {
+  if (!host) return { running: 0, pending: 0 }
  try {
-    const host = getImageComfyHost()
    const res = await fetch(`${host}/queue`, { signal: AbortSignal.timeout(2500) })
    if (!res.ok) return { running: 0, pending: 0 }
    const payload = await res.json() as { queue_running?: unknown[]; queue_pending?: unknown[] }
@@ -75,6 +83,10 @@ export async function fetchImageQueue() {
  }
 }

+export async function fetchImageQueue() {
+  return fetchQueueAt(getImageComfyHost())
+}
+
 async function controlRequest(path: string, method = 'GET') {
  const { controlUrl, controlToken } = settings()
  if (!controlUrl) return null
@@ -216,3 +228,70 @@ export function ensureImageComfyReady(onStatus: StatusFn = () => undefined) {
  gate = run.then(() => undefined, () => undefined)
  return run
 }
+
+export async function pickImageEditHost(onStatus: StatusFn = () => undefined): Promise<ImageEditTarget> {
+  const beast = getBeastImageHost()
+  const sidecar = getSidecarImageHost()
+  if (!beast && !sidecar) {
+    throw createError({
+      statusCode: 503,
+      statusMessage: 'No image ComfyUI host is configured. Set COMFY_HOST (Beast) and/or IMAGE_COMFY_HOST (Sidecar).'
+    })
+  }
+
+  if (beast) {
+    const health = await checkImageComfyHttp(2500, beast)
+    if (health.ok) {
+      const queue = await fetchQueueAt(beast)
+      if (queue.running === 0) {
+        onStatus({
+          state: 'online',
+          message: 'Beast is free. Editing on this machine.',
+          host: beast,
+          box: 'beast',
+          queueRunning: 0,
+          queuePending: queue.pending
+        })
+        return { host: beast, box: 'beast', label: 'Beast' }
+      }
+      const canOverflow = Boolean(sidecar && !sameImageHost(beast, sidecar))
+      onStatus({
+        state: 'busy',
+        message: canOverflow
+          ? 'Beast is busy. Rolling over to Sidecar...'
+          : `Beast is busy (${queue.running} running). Waiting for a free slot...`,
+        host: beast,
+        box: 'beast',
+        queueRunning: queue.running,
+        queuePending: queue.pending
+      })
+      if (!canOverflow) {
+        await withImageComfyHost(beast, () => waitWhileBusy(onStatus))
+        return { host: beast, box: 'beast', label: 'Beast' }
+      }
+    } else if (sidecar && !sameImageHost(beast, sidecar)) {
+      onStatus({
+        state: 'offline',
+        message: 'Beast is offline. Trying Sidecar...',
+        host: beast,
+        box: 'beast'
+      })
+    }
+  }
+
+  if (sidecar && (!beast || !sameImageHost(beast, sidecar))) {
+    onStatus({
+      state: 'starting',
+      message: 'Checking Sidecar for this edit...',
+      host: sidecar,
+      box: 'sidecar'
+    })
+    await withImageComfyHost(sidecar, () => ensureImageComfyReady(onStatus))
+    return { host: sidecar, box: 'sidecar', label: 'Sidecar' }
+  }
+
+  throw createError({
+    statusCode: 503,
+    statusMessage: 'Beast is unavailable and Sidecar is not configured.'
+  })
+}
@@ -20,31 +20,40 @@ export interface EditParams {

 export function buildEditWorkflow(params: EditParams) {
  const graph = structuredClone(template) as WorkflowGraph
-  if (graph['4']) graph['4'].inputs.image = params.imageName
-  if (graph['5']) graph['5'].inputs.text = params.prompt
-  if (graph['6']) graph['6'].inputs.text = (params.negative || DEFAULT_EDIT_NEGATIVE).trim() || DEFAULT_EDIT_NEGATIVE
-  if (graph['8']) {
-    graph['8'].inputs.seed = params.seed
-    graph['8'].inputs.steps = params.steps
-    graph['8'].inputs.cfg = params.cfg
-    graph['8'].inputs.denoise = params.denoise
-    graph['8'].inputs.sampler_name = params.samplerName || 'euler'
-    graph['8'].inputs.scheduler = params.scheduler || 'simple'
+  const loadImage = nodeByClass(graph, 'LoadImage') || graph['4']
+  const qwenPrompt = nodeByClass(graph, 'TextEncodeQwenImageEdit') || graph['17']
+  const sampler = nodeByClass(graph, 'KSampler') || graph['8']
+  const save = nodeByClass(graph, 'SaveImage') || graph['10']
+  if (loadImage) loadImage.inputs.image = params.imageName
+  if (qwenPrompt) {
+    if ('prompt' in qwenPrompt.inputs) qwenPrompt.inputs.prompt = params.prompt
+    if ('text' in qwenPrompt.inputs) qwenPrompt.inputs.text = params.prompt
  }
-  if (graph['10'] && params.filenamePrefix) {
-    graph['10'].inputs.filename_prefix = params.filenamePrefix
+  if (sampler) {
+    sampler.inputs.seed = params.seed
+    sampler.inputs.steps = params.steps
+    sampler.inputs.cfg = params.cfg
+    sampler.inputs.denoise = params.denoise
+    sampler.inputs.sampler_name = params.samplerName || 'euler'
+    sampler.inputs.scheduler = params.scheduler || 'simple'
  }
+  if (save && params.filenamePrefix) save.inputs.filename_prefix = params.filenamePrefix
  return graph
 }

+function nodeByClass(graph: WorkflowGraph, classType: string, index = 0) {
+  const matches = Object.values(graph).filter(node => node?.class_type === classType)
+  return matches[index]
+}
+
 export const EDIT_NODE_LABELS: Record<string, string> = {
  '1': 'Loading Qwen Edit UNET',
  '11': 'Applying Lightning LoRA',
  '2': 'Loading Qwen CLIP',
  '3': 'Loading Qwen VAE',
  '4': 'Loading input still',
-  '5': 'Encoding prompt',
-  '6': 'Encoding negative',
+  '17': 'Encoding Qwen edit prompt',
+  '19': 'Preparing negative',
  '7': 'Encoding still',
  '8': 'Sampling edit',
  '9': 'Decoding still',
@@ -42,6 +42,7 @@ export interface Job {
  clipId?: string
  stillId?: string
  hideThumbnail?: boolean
+  imageComfyHost?: string
  library?: {
    ownerKey: string
    folderId: string
@@ -1,5 +1,5 @@
 import { createHash } from 'node:crypto'
-import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { spawn } from 'node:child_process'
 import { randomBytes, scrypt, timingSafeEqual } from 'node:crypto'
@@ -39,6 +39,9 @@ export interface LibraryClip {
  parentClipId?: string
  chainIndex?: number
  workflow?: 'v1' | 'v2'
+  stillId?: string
+  sound?: boolean
+  hideInput?: boolean
 }

 export interface LibraryStill {
@@ -211,16 +214,19 @@ function ensureOwner(owner: string) {
 function readCatalog(owner: string): Catalog {
  ensureOwner(owner)
  const path = catalogPath(owner)
+  let catalog: Catalog
  try {
-    return normalizeCatalog(JSON.parse(readFileSync(path, 'utf8')))
+    catalog = normalizeCatalog(JSON.parse(readFileSync(path, 'utf8')))
  } catch {
    if (existsSync(path)) {
      throw createError({ statusCode: 500, statusMessage: 'Library catalog could not be read' })
    }
-    const created = emptyCatalog()
-    writeFileSync(path, JSON.stringify(created, null, 2))
-    return created
+    catalog = emptyCatalog()
+    writeFileSync(path, JSON.stringify(catalog, null, 2))
+    return catalog
  }
+  if (purgeStrayExtensionStills(owner, catalog).count) writeCatalog(owner, catalog)
+  return catalog
 }

 function writeCatalog(owner: string, catalog: Catalog) {
@@ -249,6 +255,10 @@ export function clipTitle(clip: Pick<LibraryClip, 'name' | 'prompt'>) {
  return fromPrompt || 'Untitled clip'
 }

+export function familyBaseName(name: string) {
+  return String(name || '').trim().replace(/\s+p\d+$/i, '')
+}
+
 export function nextClipPartName(name: string) {
  const trimmed = (name || '').trim()
  if (!trimmed) return ''
@@ -259,6 +269,30 @@ export function nextClipPartName(name: string) {
  return `${base.slice(0, Math.max(1, 80 - suffix.length))}${suffix}`
 }

+export function sortFamilyParts(a: LibraryClip, b: LibraryClip) {
+  const chain = (a.chainIndex || 0) - (b.chainIndex || 0)
+  if (chain) return chain
+  return a.createdAt - b.createdAt
+}
+
+export function clipsInSameFamily(catalog: Catalog, clip: LibraryClip) {
+  const folderClips = catalog.clips.filter(item => item.folderId === clip.folderId)
+  const base = familyBaseName(clip.name || '').toLowerCase()
+  const ids = new Set<string>([clip.id])
+  if (clip.familyId) {
+    for (const item of folderClips) {
+      if (item.familyId === clip.familyId) ids.add(item.id)
+    }
+  }
+  if (base) {
+    for (const item of folderClips) {
+      if (item.familyId && item.familyId !== clip.familyId) continue
+      if (familyBaseName(item.name || '').toLowerCase() === base) ids.add(item.id)
+    }
+  }
+  return folderClips.filter(item => ids.has(item.id))
+}
+
 export function safeDownloadName(name: string) {
  const cleaned = name.replace(/[<>:"/\\|?*'`\u0000-\u001f]/g, '-').replace(/\s+/g, ' ').trim()
  return cleaned.slice(0, 80) || 'aigen'
@@ -322,7 +356,7 @@ export function publicLibrary(event: H3Event) {
      hasThumbnail: !clip.hideThumbnail && existsSync(clipThumbPath(owner, clip.id)),
      hasVideo: existsSync(clipVideoPath(owner, clip.id))
    })),
-    stills: catalog.stills.filter(still => unlockedIds.has(still.folderId)),
+    stills: catalog.stills.filter(still => unlockedIds.has(still.folderId) && !isStrayExtensionStill(catalog, still)),
    drafts: catalog.drafts
  }
 }
@@ -652,6 +686,123 @@ function bytesHash(data: Buffer) {
  return createHash('sha256').update(data).digest('hex')
 }

+function fileBytesHash(path: string) {
+  if (!existsSync(path)) return ''
+  try {
+    return bytesHash(readFileSync(path))
+  } catch {
+    return ''
+  }
+}
+
+function isExtensionClip(clip: LibraryClip) {
+  return Boolean(clip.parentClipId) || (clip.chainIndex || 0) > 0
+}
+
+function lastFrameStillName(name: string) {
+  return /last[\s._-]*frame/i.test(String(name || '').trim())
+}
+
+export function isPipelineFrameFilename(name: string) {
+  return lastFrameStillName(name)
+}
+
+function clipIdFromStillFilename(name: string) {
+  const match = String(name || '').trim().match(/^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})(?:\.[a-z0-9]+)?$/i)
+  return match ? match[1].toLowerCase() : ''
+}
+
+function isStrayExtensionStill(catalog: Catalog, still: LibraryStill) {
+  if (lastFrameStillName(still.filename)) return true
+  const clipId = clipIdFromStillFilename(still.filename)
+  if (!clipId) return false
+  return catalog.clips.some(clip => clip.id.toLowerCase() === clipId && isExtensionClip(clip))
+}
+
+function originalInputHashes(owner: string, catalog: Catalog) {
+  const hashes = new Set<string>()
+  for (const clip of catalog.clips) {
+    if (isExtensionClip(clip)) continue
+    const hash = fileBytesHash(clipThumbPath(owner, clip.id))
+    if (hash) hashes.add(hash)
+  }
+  return hashes
+}
+
+function extensionFrameHashes(owner: string, catalog: Catalog) {
+  const hashes = new Set<string>()
+  for (const clip of catalog.clips) {
+    if (!isExtensionClip(clip)) continue
+    const last = fileBytesHash(clipLastFramePath(owner, clip.id))
+    if (last) hashes.add(last)
+    const rawThumb = fileBytesHash(join(clipDir(owner, clip.id), 'thumb'))
+    if (rawThumb) hashes.add(rawThumb)
+  }
+  return hashes
+}
+
+function allLastFrameHashes(owner: string, catalog: Catalog) {
+  const hashes = new Set<string>()
+  for (const clip of catalog.clips) {
+    const last = fileBytesHash(clipLastFramePath(owner, clip.id))
+    if (last) hashes.add(last)
+  }
+  return hashes
+}
+
+function purgeStrayExtensionStills(owner: string, catalog: Catalog) {
+  const protectedIds = new Set((catalog.drafts || []).map(draft => draft.stillId).filter(Boolean) as string[])
+  const originalHashes = originalInputHashes(owner, catalog)
+  const extIds = new Set(catalog.clips.filter(isExtensionClip).map(clip => clip.id.toLowerCase()))
+  const extHashes = extensionFrameHashes(owner, catalog)
+  const lastHashes = allLastFrameHashes(owner, catalog)
+  const keep: LibraryStill[] = []
+  const drop: LibraryStill[] = []
+  for (const still of catalog.stills) {
+    const clipId = clipIdFromStillFilename(still.filename)
+    const namedLastFrame = lastFrameStillName(still.filename)
+    const namedExtClip = Boolean(clipId && extIds.has(clipId))
+    const matchesPipelineFrame = Boolean(still.hash && (lastHashes.has(still.hash) || extHashes.has(still.hash)))
+    const isOriginal = Boolean(still.hash && originalHashes.has(still.hash))
+    const dropThis = !protectedIds.has(still.id)
+      && (namedLastFrame || namedExtClip || (matchesPipelineFrame && !isOriginal))
+    if (dropThis) drop.push(still)
+    else keep.push(still)
+  }
+  if (!drop.length) return { count: 0, filenames: [] as string[] }
+  catalog.stills = keep
+  for (const still of drop) {
+    rmSync(stillPath(owner, still.id), { force: true })
+  }
+  return { count: drop.length, filenames: drop.map(still => still.filename) }
+}
+
+export function sweepOwnerExtensionStills(owner: string) {
+  return mutate(owner, (catalog) => purgeStrayExtensionStills(owner, catalog))
+}
+
+export function sweepAllExtensionStills() {
+  const users = join(libraryRoot(), 'users')
+  let owners = 0
+  const filenames: string[] = []
+  if (!existsSync(users)) return { owners, deleted: 0, filenames }
+  for (const entry of readdirSync(users, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue
+    owners += 1
+    const path = catalogPath(entry.name)
+    if (!existsSync(path)) continue
+    try {
+      const catalog = normalizeCatalog(JSON.parse(readFileSync(path, 'utf8')))
+      const removed = purgeStrayExtensionStills(entry.name, catalog)
+      if (removed.count) writeCatalog(entry.name, catalog)
+      filenames.push(...removed.filenames)
+    } catch {
+      /* leave a bad catalog for the next authenticated read */
+    }
+  }
+  return { owners, deleted: filenames.length, filenames }
+}
+
 export async function saveStill(params: {
  ownerKey: string
  folderId: string
@@ -660,13 +811,15 @@ export async function saveStill(params: {
  width?: number
  height?: number
  hideInput?: boolean
-}) {
+}): Promise<LibraryStill | null> {
+  if (lastFrameStillName(params.filename)) return null
  const catalog = readCatalog(params.ownerKey)
  const folder = catalog.folders.find(item => item.id === params.folderId) || catalog.folders[0]
  if (!folder) throw createError({ statusCode: 400, statusMessage: 'No library folder available' })
  const hash = bytesHash(params.data)
  const existing = catalog.stills.find(item => item.folderId === folder.id && item.hash === hash)
  if (existing) {
+    if (lastFrameStillName(existing.filename)) return null
    if (typeof params.hideInput === 'boolean' && existing.hideInput !== params.hideInput) {
      await mutate(params.ownerKey, (next) => {
        const item = next.stills.find(still => still.id === existing.id)
@@ -676,6 +829,9 @@ export async function saveStill(params: {
    }
    return existing
  }
+  if (allLastFrameHashes(params.ownerKey, catalog).has(hash) || extensionFrameHashes(params.ownerKey, catalog).has(hash)) {
+    return null
+  }
  const still: LibraryStill = {
    id: crypto.randomUUID(),
    folderId: folder.id,
@@ -814,6 +970,8 @@ export async function saveClip(params: {
  parentClipId?: string
  chainIndex?: number
  workflow?: 'v1' | 'v2'
+  stillId?: string
+  sound?: boolean
 }) {
  const catalog = readCatalog(params.ownerKey)
  const folder = catalog.folders.find(item => item.id === params.folderId) || catalog.folders[0]
@@ -839,7 +997,10 @@ export async function saveClip(params: {
    familyId: params.familyId,
    parentClipId: params.parentClipId,
    chainIndex: params.chainIndex,
-    workflow: params.workflow
+    workflow: params.workflow,
+    stillId: params.stillId,
+    sound: params.sound,
+    hideInput: params.hideInput === true
  }
  mkdirSync(clipDir(params.ownerKey, clip.id), { recursive: true })
  const videoPath = clipVideoPath(params.ownerKey, clip.id)
@@ -858,18 +1019,8 @@ export async function saveClip(params: {
  } else {
    await extractVideoThumb(clipVideoPath(params.ownerKey, clip.id), join(clipDir(params.ownerKey, clip.id), 'thumb.jpg'))
  }
-  const saveInputStill = Boolean(params.thumb?.length) && !params.parentClipId && !(params.chainIndex || 0)
-  if (saveInputStill) {
-    await saveStill({
-      ownerKey: params.ownerKey,
-      folderId: folder.id,
-      filename: `${clip.id}.png`,
-      data: params.thumb!,
-      width: params.width,
-      height: params.height,
-      hideInput: params.hideInput
-    })
-  }
+  const isInitial = !params.parentClipId && !(params.chainIndex || 0)
+  if (!isInitial) clip.stillId = undefined
  await mutate(params.ownerKey, (next) => {
    next.clips.unshift(clip)
  })
@@ -882,6 +1033,12 @@ export function getClip(owner: string, id: string) {
  return clip
 }

+function stampFamilyId(family: LibraryClip[], fallback?: string) {
+  const familyId = family.find(item => item.familyId)?.familyId || fallback || crypto.randomUUID()
+  for (const item of family) item.familyId = familyId
+  return familyId
+}
+
 export function deleteClip(owner: string, id: string) {
  return mutate(owner, (catalog) => {
    const clip = catalog.clips.find(item => item.id === id)
@@ -892,6 +1049,20 @@ export function deleteClip(owner: string, id: string) {
  })
 }

+export function deleteClipFamily(owner: string, id: string) {
+  return mutate(owner, (catalog) => {
+    const clip = catalog.clips.find(item => item.id === id)
+    if (!clip) throw createError({ statusCode: 404, statusMessage: 'Clip not found' })
+    const family = clipsInSameFamily(catalog, clip)
+    const ids = new Set(family.map(item => item.id))
+    catalog.clips = catalog.clips.filter(item => !ids.has(item.id))
+    for (const item of family) {
+      rmSync(clipDir(owner, item.id), { recursive: true, force: true })
+    }
+    return family
+  })
+}
+
 export function moveClip(owner: string, id: string, folderId: string) {
  return mutate(owner, (catalog) => {
    const clip = catalog.clips.find(item => item.id === id)
@@ -903,6 +1074,19 @@ export function moveClip(owner: string, id: string, folderId: string) {
  })
 }

+export function moveClipFamily(owner: string, id: string, folderId: string) {
+  return mutate(owner, (catalog) => {
+    const clip = catalog.clips.find(item => item.id === id)
+    if (!clip) throw createError({ statusCode: 404, statusMessage: 'Clip not found' })
+    const folder = catalog.folders.find(item => item.id === folderId)
+    if (!folder) throw createError({ statusCode: 404, statusMessage: 'Folder not found' })
+    const family = clipsInSameFamily(catalog, clip)
+    stampFamilyId(family, clip.familyId)
+    for (const item of family) item.folderId = folder.id
+    return family
+  })
+}
+
 export function renameClip(owner: string, id: string, name: string) {
  const trimmed = name.trim().slice(0, 80)
  if (!trimmed) throw createError({ statusCode: 400, statusMessage: 'A name is required' })
@@ -914,6 +1098,23 @@ export function renameClip(owner: string, id: string, name: string) {
  })
 }

+export function renameClipFamily(owner: string, id: string, name: string) {
+  const trimmed = name.trim().slice(0, 80)
+  if (!trimmed) throw createError({ statusCode: 400, statusMessage: 'A name is required' })
+  return mutate(owner, (catalog) => {
+    const clip = catalog.clips.find(item => item.id === id)
+    if (!clip) throw createError({ statusCode: 404, statusMessage: 'Clip not found' })
+    const family = [...clipsInSameFamily(catalog, clip)].sort(sortFamilyParts)
+    const base = familyBaseName(trimmed) || trimmed
+    stampFamilyId(family, clip.familyId)
+    family.forEach((item, index) => {
+      const suffix = index === 0 ? '' : ` p${index + 1}`
+      item.name = `${base.slice(0, Math.max(1, 80 - suffix.length))}${suffix}`
+    })
+    return family
+  })
+}
+
 export async function downloadComfyVideo(video: { filename: string; subfolder: string; type: string }) {
  const subfolders = [...new Set([video.subfolder, 'video', ''])]
  let lastStatus = 0
@@ -25,6 +25,8 @@ export interface PendingJob {
  familyId?: string
  parentClipId?: string
  chainIndex?: number
+  stillId?: string
+  sound?: boolean
 }

 function pendingRoot() {
@@ -142,7 +144,9 @@ export async function completePendingIfReady(pending: PendingJob) {
    comfyFilename: video.filename,
    familyId: pending.familyId,
    parentClipId: pending.parentClipId,
-    chainIndex: pending.chainIndex
+    chainIndex: pending.chainIndex,
+    stillId: pending.stillId,
+    sound: pending.sound
  })
  await purgeComfyArtifacts({ video, imageName: pending.imageName, imageSubfolder: pending.imageSubfolder, promptId: pending.promptId })
  deletePendingJob(pending.jobId)
@@ -183,7 +183,9 @@ export function watchComfyJob(job: Job, options: { persist?: boolean } = {}): Pr
              hideThumbnail: job.library.hideThumbnail,
              hideInput: job.library.hideInput,
              video: buffer,
-              thumb: job.library.thumb,
+              thumb: (job.library.parentClipId || (job.library.chainIndex || 0) > 0 || /last[\s._-]*frame/i.test(job.library.imageName || ''))
+                ? undefined
+                : job.library.thumb,
              comfyFilename: video.filename,
              cfg: job.library.cfg,
              fps: job.library.fps,
@@ -192,7 +194,9 @@ export function watchComfyJob(job: Job, options: { persist?: boolean } = {}): Pr
              familyId: job.library.familyId || (job.library.familyId = crypto.randomUUID()),
              parentClipId: job.library.parentClipId,
              chainIndex: job.library.chainIndex,
-              workflow: job.library.workflow
+              workflow: job.library.workflow,
+              stillId: job.library.stillId,
+              sound: job.library.sound
            })
            job.clipId = clip.id
            job.savedPromptId = job.promptId
@@ -1,6 +1,7 @@
 // Nitro bundles these JSON graphs into the production server output.
 import workflowV1 from '../assets/workflow_minimax_video.json'
 import workflowV2 from '../assets/workflow_minimax_video_v2.json'
+import { buildIdentityPrompt } from '~/utils/identityPrompt'

 export type VideoWorkflowId = 'v1' | 'v2'

@@ -69,8 +70,10 @@ export function buildWorkflow(params: GenerateParams) {
  const graph = structuredClone(templateFor(version))
  const width = snap32(params.width)
  const height = snap32(params.height)
-  const refs = (params.referenceImageNames || []).map(name => String(name || '').trim()).filter(Boolean).slice(0, 4)
-  const useRefs = version === 'v2' && params.useIdentityRefs === true && refs.length > 0
+  const refs = Array.from({ length: 4 }, (_, index) => String(params.referenceImageNames?.[index] || '').trim())
+  const extraPictures = refs.flatMap((name, index) => name ? [index + 2] : [])
+  const useRefs = version === 'v2' && params.useIdentityRefs === true
+  const graphPrompt = useRefs ? buildIdentityPrompt(params.prompt, extraPictures) : params.prompt

  for (const [id, node] of Object.entries(graph)) {
    if (IMAGE_CLASSES.has(node.class_type) && 'image' in node.inputs && id === '114') {
@@ -78,19 +81,19 @@ export function buildWorkflow(params: GenerateParams) {
    }

    if (PROMPT_CLASSES.has(node.class_type) || node.class_type.includes('Qwen3')) {
-      if ('prompt' in node.inputs) node.inputs.prompt = params.prompt
-      if ('text' in node.inputs) node.inputs.text = params.prompt
+      if ('prompt' in node.inputs) node.inputs.prompt = graphPrompt
+      if ('text' in node.inputs) node.inputs.text = graphPrompt
    }

    if (node.class_type === 'MiniMaxH3ImageToVideo') {
-      node.inputs.prompt = params.prompt
+      node.inputs.prompt = graphPrompt
      if (typeof node.inputs.width === 'number') node.inputs.width = width
      if (typeof node.inputs.height === 'number') node.inputs.height = height
      if (typeof node.inputs.length === 'number') node.inputs.length = params.length
    }

    if (node.class_type === 'MiniMaxH3ReferenceToVideo') {
-      node.inputs.prompt = params.prompt
+      node.inputs.prompt = graphPrompt
      if (!Array.isArray(node.inputs.length)) node.inputs.length = ['174', 1]
    }

@@ -190,7 +193,7 @@ export function buildWorkflow(params: GenerateParams) {
    }
  }

-  if (version === 'v2') applyV2IdentityPath(graph, params, useRefs, refs)
+  if (version === 'v2') applyV2IdentityPath(graph, params, useRefs, refs, graphPrompt)

  if (params.sound === false) {
    delete graph['105:23']
@@ -207,33 +210,31 @@ function applyV2IdentityPath(
  graph: WorkflowGraph,
  params: GenerateParams,
  useRefs: boolean,
-  refs: string[]
+  refs: string[],
+  graphPrompt: string
 ) {
  if (useRefs && graph['155'] && graph['167'] && graph['168']) {
    graph['167'].inputs.latent_image = ['155', 1]
    graph['168'].inputs.conditioning = ['155', 0]
-    graph['155'].inputs.prompt = params.prompt
+    graph['155'].inputs.prompt = graphPrompt
    graph['155'].inputs.length = ['174', 1]
    delete graph['173']
+    if (graph['169']?.inputs) {
+      graph['169'].inputs.unet_name = 'minimax_h3_ref2va_pruned_int8_convrot.safetensors'
+    }
+    if (params.turbo && graph['176']?.inputs) {
+      graph['176'].inputs.lora_name = 'minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors'
+    }
    V2_REF_LOADERS.forEach((id, index) => {
      const name = refs[index]
-      const inputKey = `ref_images.ref_image_${index + 1}`
      if (name && graph[id]) {
        graph[id].inputs.image = name
-      } else {
+        return
+      }
      delete graph[id]
-        if (graph['155']?.inputs) delete graph['155'].inputs[inputKey]
-      }
+      if (graph['155']?.inputs) delete graph['155'].inputs[`ref_images.ref_image_${index + 1}`]
    })
-    graph['v2:cfg'] = {
-      class_type: 'FluxGuidance',
-      inputs: {
-        guidance: params.cfg,
-        conditioning: ['155', 0]
-      },
-      _meta: { title: 'Guidance scale' }
-    }
-    graph['168'].inputs.conditioning = ['v2:cfg', 0]
+    if (graph['150']?.inputs) graph['150'].inputs.value = true
    return
  }

@@ -0,0 +1,40 @@
+function extraPictureNumbers(extraRefs: number | number[]) {
+  if (Array.isArray(extraRefs)) {
+    return [...new Set(extraRefs.map(Number).filter(n => n >= 2 && n <= 5))].sort((a, b) => a - b)
+  }
+  const extras = Math.max(0, Math.min(4, extraRefs))
+  return Array.from({ length: extras }, (_, i) => i + 2)
+}
+
+export function identityBoilerplate(extraRefs: number | number[] = 0) {
+  const extras = extraPictureNumbers(extraRefs)
+  const secondary = extras.length === 0
+    ? ''
+    : extras.length === 1
+      ? ` <Picture ${extras[0]}> is a secondary reference angle for profile details.`
+      : ` ${extras.map(n => `<Picture ${n}>`).join(' and ')} are secondary reference angles for profile features only.`
+  return `<Picture 1> is the exact facial identity, hairstyle, body proportions and clothing of the main character. Preserve this identity with high fidelity even when the subject temporarily leaves the frame and returns.${secondary}`
+}
+
+export function looksLikeIdentityPrompt(text: string) {
+  return /primary identity anchor|exact facial identity/i.test(String(text || ''))
+}
+
+export function buildIdentityPrompt(actionPrompt: string, extraRefs: number | number[] = 0) {
+  const action = String(actionPrompt || '').trim()
+  if (looksLikeIdentityPrompt(action)) return action
+  const boilerplate = identityBoilerplate(extraRefs)
+  return action ? `${boilerplate}\n\n${action}` : boilerplate
+}
+
+export const IDENTITY_ACTION_TEMPLATE = `[SHOT CONFIGURATION]
+- Shot Type: Medium close-up, 50mm lens, eye-level
+- Camera Movement: Slow tracking dolly-in following the subject
+- Lighting: Warm golden-hour rim lighting with soft directional fill from screen left
+- Environment/Scenery: Dense pine forest, soft ambient ground mist
+
+[SUBJECT DIRECTION & ACTION]
+The subject from <Picture 1> walks slowly through the path, glancing toward camera-left in awe. She turns slightly, speaking softly: "Look at the way the light hits the trees."
+
+[AUDIO CUES]
+Ambient forest breeze, soft footsteps on twigs, warm cinematic background strings.`
@@ -6,7 +6,7 @@ export interface ParsedShot {

 export function parseShotScript(text: string): ParsedShot[] {
  const src = String(text || '').replace(/\r\n/g, '\n')
-  const marker = /shot\s+(\d+)\b/gi
+  const marker = /^[ \t]*shot\s+(\d+)\b/gim
  const markers: { n: number; start: number; end: number }[] = []
  for (const match of src.matchAll(marker)) {
    markers.push({