kingkont 0.7.39 → 0.7.41

package/renderer/generate.js

@@ -0,0 +1,1727 @@
+// renderer/generate.js — Add-menu (ПКМ), generate (image/video/text/audio), preferences modal, SFX, music, tones
+//
+// Этот модуль был выделен из index.html (раньше всё было в одном <script>
+// блоке на 9123 строки). Все модули загружаются как plain <script>
+// в одном глобальном scope — поэтому функции/переменные между файлами
+// видят друг друга по именам, без import/export. Порядок загрузки
+// важен: см. <script> теги внизу index.html.
+
+// =================== Add-menu (dblclick / ПКМ по пустому холсту) ===================
+canvasWrap.addEventListener('dblclick', e => {
+  if (!state.currentBoard) return;
+  if (e.target.closest('.node, .conn, .resize-handle, .anchor')) return;
+  if (e.target.closest('#addMenu, .modal')) return;
+  showAddMenu(e.clientX, e.clientY);
+});
+canvasWrap.addEventListener('contextmenu', e => {
+  if (!state.currentBoard) return;
+  if (e.target.closest('.node, .conn, .resize-handle, .anchor, button, input, textarea, select')) return;
+  if (e.target.closest('#addMenu, .modal')) return;
+  e.preventDefault();
+  showAddMenu(e.clientX, e.clientY);
+});
+
+// Rubber-band селектор + сброс выделения по клику в пустое место
+canvasWrap.addEventListener('mousedown', e => {
+  if (!state.currentBoard) return;
+  if (e.button !== 0) return;
+  if (e.target.closest('.node, .conn, .anchor, .resize-handle, button, input, textarea, select, .modal, #addMenu, #nodeMenu')) return;
+  // Если без модификатора — сбрасываем старое выделение
+  const additive = e.metaKey || e.ctrlKey || e.shiftKey;
+  if (!additive && state.selectedNodeIds.size) {
+    clearSelection();
+    renderSelection();
+  }
+  // Старт rubber-band
+  startRubberBand(e, additive);
+});
+
+function startRubberBand(e, additive) {
+  const rectStart = canvas.getBoundingClientRect();
+  const startC = { x: (e.clientX - rectStart.left) / state.zoom, y: (e.clientY - rectStart.top) / state.zoom };
+  const overlay = document.createElement('div');
+  overlay.style.cssText = 'position:fixed; pointer-events:none; border:1px dashed #6a8aaa; background:rgba(106,138,170,0.1); z-index:1000;';
+  document.body.appendChild(overlay);
+  let moved = false;
+  const onMove = ev => {
+    moved = true;
+    const x = Math.min(ev.clientX, e.clientX);
+    const y = Math.min(ev.clientY, e.clientY);
+    overlay.style.left = x + 'px';
+    overlay.style.top  = y + 'px';
+    overlay.style.width = Math.abs(ev.clientX - e.clientX) + 'px';
+    overlay.style.height = Math.abs(ev.clientY - e.clientY) + 'px';
+  };
+  const onUp = ev => {
+    document.removeEventListener('mousemove', onMove);
+    document.removeEventListener('mouseup', onUp);
+    overlay.remove();
+    if (!moved) return;
+    const rect = canvas.getBoundingClientRect();
+    const endC = { x: (ev.clientX - rect.left) / state.zoom, y: (ev.clientY - rect.top) / state.zoom };
+    const x1 = Math.min(startC.x, endC.x), y1 = Math.min(startC.y, endC.y);
+    const x2 = Math.max(startC.x, endC.x), y2 = Math.max(startC.y, endC.y);
+    if (!additive) state.selectedNodeIds.clear();
+    for (const n of state.currentBoard.metadata.nodes) {
+      const w = +n.width || 280;
+      const el = canvas.querySelector(`.node[data-id="${n.id}"]`);
+      const h = el ? el.offsetHeight : (+n.height || 200);
+      if (n.x < x2 && n.x + w > x1 && n.y < y2 && n.y + h > y1) {
+        state.selectedNodeIds.add(n.id);
+      }
+    }
+    renderSelection();
+  };
+  document.addEventListener('mousemove', onMove);
+  document.addEventListener('mouseup', onUp);
+}
+
+function showAddMenu(clientX, clientY) {
+  state.addMenuPos = { clientX, clientY };
+  const menu = $('addMenu');
+  // Удаляем динамические пункты-фразы и пересобираем их
+  menu.querySelectorAll('.dyn-phrase').forEach(b => b.remove());
+  for (const c of state.charactersInfo) {
+    if (!c.voice) continue; // без голоса нечем озвучивать
+    const btn = document.createElement('button');
+    btn.className = 'dyn-phrase';
+    btn.dataset.charName = c.name;
+    btn.textContent = `💬 Фраза + ${c.name}`;
+    btn.addEventListener('click', () => {
+      $('addMenu').classList.add('hidden');
+      openPhraseFor(c);
+    });
+    menu.appendChild(btn);
+  }
+  positionFloatingMenu(menu, clientX, clientY);
+  setTimeout(() => document.addEventListener('mousedown', closeAddMenu, { once: true }), 0);
+}
+
+function openPhraseFor(charInfo) {
+  state.genKind = 'audio';
+  document.querySelectorAll('#genModal [data-kind]').forEach(b =>
+    b.classList.toggle('active', b.dataset.kind === 'audio'));
+  $('imageModelRow').style.display = 'none';
+
+  $('imageOptionsRow').style.display = 'none';
+  $('videoOptionsRow').style.display = 'none';
+
+  $('videoModelRow').style.display = 'none';
+  $('voiceRow').style.display = '';
+
+  $('ttsModelRow').style.display = '';
+  $('tonesRow').style.display = '';
+  loadVoices().then(() => {
+    if (charInfo.voice) $('genVoice').value = charInfo.voice;
+  });
+  // Тоны: подсказки из commonTones персонажа + дефолты, обычный тон уже применён
+  state.toneSuggestions = (charInfo.commonTones || []).slice();
+  state.activeTones = charInfo.tone ? [charInfo.tone] : [];
+  renderTones();
+  $('genPrompt').value = '';
+  const placeholderHint = `Что должен сказать ${charInfo.name}...`;
+  $('genPrompt').setAttribute('placeholder', placeholderHint);
+  $('genStatus').textContent = '';
+  $('genStatus').className = 'status';
+  $('genSubmit').disabled = false;
+  resetPicks();
+  syncCharLocRows();
+  closeMentionPopup();
+  $('genModal').classList.remove('hidden');
+  setTimeout(() => $('genPrompt').focus(), 50);
+}
+
+function closeAddMenu(e) {
+  if (e && e.target.closest('#addMenu')) {
+    document.addEventListener('mousedown', closeAddMenu, { once: true });
+    return;
+  }
+  $('addMenu').classList.add('hidden');
+}
+
+document.querySelectorAll('#addMenu button').forEach(btn => {
+  btn.addEventListener('click', async () => {
+    const act = btn.dataset.act;
+    $('addMenu').classList.add('hidden');
+    document.removeEventListener('mousedown', closeAddMenuOnOutside, true);
+    const fromNode = state.anchorFromNode;  // если меню вызвано из anchor-drag
+    state.anchorFromNode = null;
+
+    if (act === 'text') {
+      await addTextAt(state.addMenuPos);
+      state.addMenuPos = null;
+      return;
+    }
+    if (act === 'gen-text') {
+      // открываем text-gen modal; если есть fromNode — подставляем @ref в промпт
+      if (!await ensureApiKey('text')) return;
+      $('textGenPrompt').value = fromNode ? `[@${nodeRefKey(fromNode)}] ` : '';
+      $('textGenStatus').textContent = ''; $('textGenStatus').className = 'status';
+      $('textGenSubmit').disabled = false;
+      const savedModel = localStorage.getItem('textGenModel');
+      if (savedModel) $('textGenModel').value = savedModel;
+      $('textGenModal').classList.remove('hidden');
+      setTimeout(() => {
+        const ta = $('textGenPrompt');
+        ta.focus();
+        ta.setSelectionRange(ta.value.length, ta.value.length);
+      }, 30);
+      return;
+    }
+    if (act === 'image' || act === 'video' || act === 'audio') {
+      if (fromNode) {
+        // Из anchor-drag — переиспользуем openGenerateForRef, передавая kind
+        await openGenerateForRef(fromNode, state.addMenuPos?.clientX, state.addMenuPos?.clientY, act);
+      } else {
+        await openGenModal(act);
+      }
+    }
+  });
+});
+
+async function addTextAt(pos) {
+  if (!state.currentBoard) return;
+  const rect = canvas.getBoundingClientRect();
+  const x = pos ? (pos.clientX - rect.left) / state.zoom : canvasWrap.scrollLeft / state.zoom + 80;
+  const y = pos ? (pos.clientY - rect.top)  / state.zoom : canvasWrap.scrollTop  / state.zoom + 80;
+  const dir = await getOrCreateBoardSubdir(state.currentBoard.handle, 'texts');
+  const mdName = await uniqueName(dir, 'text.md');
+  await writeFile(dir, mdName, '');
+  const node = { id: crypto.randomUUID(), type: 'text', file: `texts/${mdName}`, text: '', x, y };
+  state.currentBoard.metadata.nodes.push(node);
+  canvas.appendChild(await createNodeEl(node));
+  scheduleSave();
+}
+
+// =================== Generate (фоновая, не блокирующая) ===================
+// === Preferences modal (API-ключи) ===
+async function openSettings(initialFocus) {
+  if (!window.appSettings) {
+    alert('Настройки доступны только в Electron-сборке.');
+    return;
+  }
+  const cur = await window.appSettings.get();
+  $('prefsKieKey').value = cur.kieKey || '';
+  $('prefsElevenKey').value = cur.elevenKey || '';
+  $('prefsOpenrouterKey').value = cur.openrouterKey || '';
+  $('prefsModal').classList.remove('hidden');
+  setTimeout(() => {
+    const focusId = initialFocus === 'kie' ? 'prefsKieKey'
+                  : initialFocus === 'eleven' ? 'prefsElevenKey'
+                  : initialFocus === 'openrouter' ? 'prefsOpenrouterKey'
+                  : 'prefsKieKey';
+    $(focusId).focus();
+  }, 30);
+}
+$('prefsCancel').addEventListener('click', () => $('prefsModal').classList.add('hidden'));
+$('prefsSave').addEventListener('click', async () => {
+  await window.appSettings.save({
+    kieKey: $('prefsKieKey').value.trim() || undefined,
+    elevenKey: $('prefsElevenKey').value.trim() || undefined,
+    openrouterKey: $('prefsOpenrouterKey').value.trim() || undefined,
+  });
+  $('prefsModal').classList.add('hidden');
+});
+
+// Универсальное позиционирование floating-меню около курсора с учётом границ
+// окна. Меню должно быть уже видимым (без .hidden) чтобы offsetWidth/Height
+// были реальными — поэтому делаем remove('hidden'), измеряем, корректируем.
+function positionFloatingMenu(menu, clientX, clientY) {
+  menu.classList.remove('hidden');
+  // Сначала ставим в (0,0), чтобы измерить «честный» размер без overflow.
+  menu.style.left = '0px';
+  menu.style.top  = '0px';
+  const w = menu.offsetWidth || 240;
+  const h = menu.offsetHeight || 200;
+  const pad = 8;
+  let x = clientX, y = clientY;
+  // Если не помещается справа от курсора — открываем слева от него.
+  if (clientX + w + pad > window.innerWidth)  x = Math.max(pad, clientX - w);
+  // Если не помещается ниже курсора — открываем выше.
+  if (clientY + h + pad > window.innerHeight) y = Math.max(pad, clientY - h);
+  menu.style.left = x + 'px';
+  menu.style.top  = y + 'px';
+}
+
+// Глобальный Esc: закрывает самую верхнюю видимую модалку.
+document.addEventListener('keydown', e => {
+  if (e.key !== 'Escape') return;
+  // Reverse DOM order — поздняя в DOM лежит «выше», прячем именно её.
+  const modals = [...document.querySelectorAll('.modal:not(.hidden)')].reverse();
+  if (!modals.length) return;
+  e.preventDefault();
+  e.stopPropagation();
+  modals[0].classList.add('hidden');
+});
+
+// Проверка наличия нужного ключа перед открытием gen-модалки.
+// Возвращает true если ключ есть; иначе показывает settings и false.
+async function ensureApiKey(forKind) {
+  if (!window.appSettings) return true; // веб-режим — настройки не доступны
+  const s = await window.appSettings.get();
+  // Если KingKont подключён и активен — он покроет любой kind, прямые
+  // ключи не нужны.
+  const hasChatium = !!(s.useChatium === true && s.chatium?.token && s.chatium?.base);
+  if (hasChatium) return true;
+  // Иначе нужен прямой ключ для соответствующего провайдера.
+  if (forKind === 'audio' && (!s.useElevenlabs || !s.elevenKey)) {
+    alert('Войдите в KingKont или включите ElevenLabs (нужен API-ключ).');
+    openSettings('eleven');
+    return false;
+  }
+  if ((forKind === 'image' || forKind === 'video') && (!s.useKie || !s.kieKey)) {
+    alert('Войдите в KingKont или включите KIE (нужен API-ключ).');
+    openSettings('kie');
+    return false;
+  }
+  if (forKind === 'text' && (!s.useOpenrouter || !s.openrouterKey)) {
+    alert('Войдите в KingKont или включите OpenRouter (нужен API-ключ).');
+    openSettings('openrouter');
+    return false;
+  }
+  return true;
+}
+
+// Открыть модалку генерации с заранее выбранным kind. UI типа в модалке
+// скрыт — selector переехал в кнопки тулбара.
+async function openGenModal(kind) {
+  if (!await ensureApiKey(kind)) return;
+  if (!state.currentBoard) return;
+  state.genKind = kind;
+  document.querySelectorAll('#genModal [data-kind]').forEach(b =>
+    b.classList.toggle('active', b.dataset.kind === kind));
+  // Видимость рядов под текущий kind
+  $('imageModelRow').style.display = kind === 'image' ? '' : 'none';
+
+  $('imageOptionsRow').style.display = kind === 'image' ? '' : 'none';
+  $('videoOptionsRow').style.display = kind === 'video' ? '' : 'none';
+
+  $('videoModelRow').style.display = kind === 'video' ? '' : 'none';
+  $('voiceRow').style.display      = kind === 'audio' ? '' : 'none';
+
+  $('ttsModelRow').style.display      = kind === 'audio' ? '' : 'none';
+  $('tonesRow').style.display      = kind === 'audio' ? '' : 'none';
+  // Заголовок модалки = действие
+  const title = $('genTitle');
+  if (title) {
+    title.textContent =
+      kind === 'image' ? 'Сгенерировать картинку' :
+      kind === 'video' ? 'Сгенерировать видео' :
+      kind === 'audio' ? 'Сгенерировать голос' : 'Сгенерировать ноду';
+  }
+  // Плейсхолдер промпта — соответствующий
+  const ph = kind === 'audio'
+    ? 'Текст, который надо озвучить...'
+    : 'Что должно быть. Печатай @ чтобы вставить ссылку на ноду...';
+  $('genPrompt').setAttribute('placeholder', ph);
+
+  $('genStatus').textContent = '';
+  $('genStatus').className = 'status';
+  $('genSubmit').disabled = false;
+  $('genPrompt').value = '';
+  state.activeTones = [];
+  state.toneSuggestions = [];
+  renderTones();
+  resetPicks();
+  presetPicksForBoard();
+  renderCharsPickChips();
+  renderLocPickSelect();
+  syncCharLocRows();
+  if (kind === 'audio') { loadVoices(); }
+  closeMentionPopup();
+  syncSourceRefRow();
+  $('genModal').classList.remove('hidden');
+  setTimeout(() => $('genPrompt').focus(), 50);
+}
+
+$('genImage').addEventListener('click', () => openGenModal('image'));
+$('genVideo').addEventListener('click', () => openGenModal('video'));
+$('genAudio').addEventListener('click', () => openGenModal('audio'));
+$('genText').addEventListener('click', async () => {
+  if (!state.currentBoard) return;
+  if (!await ensureApiKey('text')) return;
+  $('textGenPrompt').value = '';
+  $('textGenStatus').textContent = '';
+  $('textGenStatus').className = 'status';
+  $('textGenSubmit').disabled = false;
+  // Восстановить выбор модели из localStorage
+  const savedModel = localStorage.getItem('textGenModel');
+  if (savedModel) $('textGenModel').value = savedModel;
+  $('textGenModal').classList.remove('hidden');
+  setTimeout(() => $('textGenPrompt').focus(), 30);
+});
+
+$('textGenCancel').addEventListener('click', () => $('textGenModal').classList.add('hidden'));
+
+$('textGenSubmit').addEventListener('click', async () => {
+  const rawPrompt = $('textGenPrompt').value.trim();
+  if (!rawPrompt) { $('textGenPrompt').focus(); return; }
+  const model = $('textGenModel').value;
+  localStorage.setItem('textGenModel', model);
+  // Позиция новой ноды: место отпускания (anchor-drag) или свободное.
+  let spot;
+  if (state.addMenuPos) {
+    const rect = canvas.getBoundingClientRect();
+    spot = {
+      x: (state.addMenuPos.clientX - rect.left) / state.zoom,
+      y: (state.addMenuPos.clientY - rect.top)  / state.zoom,
+    };
+    state.addMenuPos = null;
+  } else {
+    spot = findFreeSpot();
+  }
+  const pendingFrom = state.pendingConnectionFrom;
+  state.pendingConnectionFrom = null;
+  // Собираем image-mentions из промпта (видение для модели). Видео/audio в
+  // OpenRouter chat не поддерживается — игнорируем.
+  const allMediaRefs = (typeof gatherMediaRefs === 'function') ? gatherMediaRefs(rawPrompt) : [];
+  const imageRefs = allMediaRefs.filter(r => r.type === 'image' && r.file);
+  // Резолвим mentions: text-ноды → инлайн .md, image-ноды → маркеры [image N].
+  const resolvedPrompt = (typeof resolveMentions === 'function') ? resolveMentions(rawPrompt, imageRefs) : rawPrompt;
+  // Создаём ноду в pending-состоянии сразу — пока модель работает, на холсте
+  // виден spinner, юзер может закрыть модалку, ходить по проекту и т.д.
+  const dir = await getOrCreateBoardSubdir(state.currentBoard.handle, 'texts');
+  const mdName = await uniqueName(dir, 'text.md');
+  await writeFile(dir, mdName, '');  // пустой плейсхолдер
+  const node = {
+    id: crypto.randomUUID(),
+    type: 'text', file: `texts/${mdName}`, text: '',
+    x: spot.x, y: spot.y,
+    status: 'generating',
+    generated: { kind: 'text', rawPrompt, prompt: resolvedPrompt, model, state: 'submitting' },
+  };
+  state.currentBoard.metadata.nodes.push(node);
+  canvas.appendChild(await createNodeEl(node));
+  if (pendingFrom) addConnection(pendingFrom, node.id);
+  scheduleSave();
+  $('textGenModal').classList.add('hidden');
+  // Фоновая генерация — модалку уже закрыли.
+  runTextJob(node, resolvedPrompt, model, state.currentBoard.handle, state.currentBoard.key, imageRefs);
+});
+
+async function _imageRefToDataUrl(ref) {
+  try {
+    const fh = await resolveBoardFile(ref.boardHandle, ref.file);
+    const file = await fh.getFile();
+    return await new Promise((res, rej) => {
+      const r = new FileReader();
+      r.onload = () => res(r.result);
+      r.onerror = () => rej(r.error);
+      r.readAsDataURL(file);
+    });
+  } catch (e) { return null; }
+}
+
+async function runTextJob(node, prompt, model, boardHandle, bKey, imageRefs) {
+  state.jobs.set(node.id, { boardKey: bKey, kind: 'text', nodeId: node.id });
+  if (typeof updateJobsBadge === 'function') updateJobsBadge();
+  logJob(node.id, `text-gen start model=${model} prompt="${(prompt||'').slice(0,80)}" images=${imageRefs?.length||0}`);
+  try {
+    const images = [];
+    for (const ref of (imageRefs || [])) {
+      const url = await _imageRefToDataUrl(ref);
+      if (url) images.push({ name: ref.name, url });
+    }
+    const provider = await plannedProvider('text');
+    logJob(node.id, `→ POST /api/text → ${provider} (model=${model})`);
+    const r = await fetch('/api/text', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ prompt, model, images }),
+    });
+    logJob(node.id, `← via ${r.headers.get('x-provider') || '?'} HTTP ${r.status}`);
+    const data = await r.json();
+    if (!r.ok) throw new Error(data?.error || `HTTP ${r.status}`);
+    const text = (data.text || '').trim();
+    if (!text) throw new Error('пустой ответ модели');
+    // Записываем в .md и обновляем ноду.
+    await writeBoardFile(boardHandle, node.file, text);
+    await mutateNode(bKey, boardHandle, node.id, n => {
+      n.text = text;
+      n.status = undefined;
+      n.generated = {
+        ...(n.generated || {}),
+        prompt, model: data.model || model, state: 'success',
+        ...(typeof data.cost === 'number' ? { creditsCharged: data.cost } : {}),
+      };
+    });
+    if (typeof data.cost === 'number') logJob(node.id, `списано ${data.cost} credits`);
+    logJob(node.id, `text-gen done (${text.length} chars)`);
+    if (typeof window.refreshBalance === 'function') window.refreshBalance();
+  } catch (e) {
+    logJob(node.id, `text-gen failed: ${e?.message || e}`);
+    await mutateNode(bKey, boardHandle, node.id, n => {
+      n.status = 'error';
+      n.error = e?.message || String(e);
+    });
+  } finally {
+    state.jobs.delete(node.id);
+    if (typeof updateJobsBadge === 'function') updateJobsBadge();
+  }
+}
+
+// === SFX (ElevenLabs Sound Effects) ===
+$('genSfx').addEventListener('click', async () => {
+  if (!state.currentBoard) return;
+  if (!await ensureApiKey('audio')) return;
+  $('sfxPrompt').value = '';
+  $('sfxDuration').value = '';
+  $('sfxStatus').textContent = ''; $('sfxStatus').className = 'status';
+  $('sfxSubmit').disabled = false;
+  $('sfxModal').classList.remove('hidden');
+  setTimeout(() => $('sfxPrompt').focus(), 30);
+});
+$('sfxCancel').addEventListener('click', () => $('sfxModal').classList.add('hidden'));
+$('sfxSubmit').addEventListener('click', async () => {
+  const text = $('sfxPrompt').value.trim();
+  if (!text) { $('sfxPrompt').focus(); return; }
+  const durRaw = $('sfxDuration').value.trim();
+  const durationSeconds = durRaw ? parseFloat(durRaw) : null;
+  $('sfxSubmit').disabled = true;
+  const status = $('sfxStatus');
+  status.className = 'status'; status.textContent = 'Генерация…';
+  $('sfxModal').classList.add('hidden');
+  // Regenerate существующей ноды — обновляем её, не создаём новую.
+  if (state.sfxRegenerateTarget) {
+    const node = state.sfxRegenerateTarget;
+    state.sfxRegenerateTarget = null;
+    await mutateNode(state.currentBoard.key, state.currentBoard.handle, node.id, n => {
+      n.status = 'generating';
+      n.error = undefined;
+      n.generated = { ...(n.generated || {}), kind: 'audio', subKind: 'sfx', prompt: text, durationSeconds, model: 'eleven-sfx', state: 'submitting' };
+    });
+    runSfxJob(node, text, durationSeconds, state.currentBoard.handle, state.currentBoard.key);
+    return;
+  }
+  // Новая нода
+  const spot = (state.addMenuPos
+    ? { x: (state.addMenuPos.clientX - canvas.getBoundingClientRect().left) / state.zoom,
+        y: (state.addMenuPos.clientY - canvas.getBoundingClientRect().top)  / state.zoom }
+    : findFreeSpot());
+  state.addMenuPos = null;
+  const node = {
+    id: crypto.randomUUID(), type: 'audio',
+    name: uniqueNodeName(state.currentBoard.metadata.nodes, slugifyPrompt(text) || 'sfx'),
+    x: spot.x, y: spot.y, status: 'generating',
+    generated: { kind: 'audio', subKind: 'sfx', prompt: text, durationSeconds, model: 'eleven-sfx', state: 'submitting' },
+  };
+  state.currentBoard.metadata.nodes.push(node);
+  canvas.appendChild(await createNodeEl(node));
+  scheduleSave();
+  runSfxJob(node, text, durationSeconds, state.currentBoard.handle, state.currentBoard.key);
+});
+
+// Если в тексте кириллица — переводим в английский через OpenRouter,
+// иначе ElevenLabs SFX endpoint делает TTS-fallback вместо звукового
+// эффекта. Тихо, без блокировки UI; на ошибке оставляем оригинал.
+async function _translateForSfx(text) {
+  if (!/[А-Яа-яЁё]/.test(text)) return text; // уже латиница
+  if (!window.appSettings) return text;
+  const s = await window.appSettings.get();
+  if (!s.openrouterKey) return text;
+  try {
+    const r = await fetch('/api/text', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        prompt: text,
+        model: 'anthropic/claude-haiku-4',
+        system: 'You translate descriptions of sound effects from any language into short, vivid English suitable for a sound-effects generation API. Reply with translation ONLY, no quotes, no explanations. Keep it under 150 characters.',
+      }),
+    });
+    const data = await r.json();
+    if (r.ok && data.text) return data.text.trim();
+  } catch (e) { /* fallthrough */ }
+  return text;
+}
+
+async function runSfxJob(node, text, durationSeconds, boardHandle, bKey) {
+  state.jobs.set(node.id, { boardKey: bKey, kind: 'audio', nodeId: node.id });
+  if (typeof updateJobsBadge === 'function') updateJobsBadge();
+  // Защита: если boardHandle потерян — пробуем взять текущий, иначе валим
+  // с понятным сообщением до запуска генерации.
+  if (!boardHandle || typeof boardHandle.getDirectoryHandle !== 'function') {
+    boardHandle = state.currentBoard?.handle;
+  }
+  if (!boardHandle || typeof boardHandle.getDirectoryHandle !== 'function') {
+    const err = 'нет доступа к папке проекта (закрой и открой проект заново)';
+    logJob(node.id, `sfx aborted: ${err}`);
+    await mutateNode(bKey, boardHandle, node.id, n => { n.status = 'error'; n.error = err; }).catch(() => {});
+    state.jobs.delete(node.id);
+    return;
+  }
+  logJob(node.id, `sfx start text="${(text||'').slice(0,80)}" dur=${durationSeconds||'auto'} board=${boardHandle.name||'?'}`);
+  try {
+    const enText = await _translateForSfx(text);
+    if (enText !== text) {
+      logJob(node.id, `sfx translated → "${enText.slice(0,100)}"`);
+      await mutateNode(bKey, boardHandle, node.id, n => {
+        n.generated = { ...(n.generated || {}), translatedPrompt: enText };
+      });
+    }
+    const provider = await plannedProvider('sfx');
+    logJob(node.id, `→ POST /api/sfx → ${provider} (dur=${durationSeconds || '-'}s)`);
+    const r = await fetch('/api/sfx', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ text: enText, durationSeconds }),
+    });
+    logJob(node.id, `← via ${r.headers.get('x-provider') || '?'} HTTP ${r.status}`);
+    if (!r.ok) throw new Error((await r.text()).slice(0, 300) || `HTTP ${r.status}`);
+    const cost = parseInt(r.headers.get('x-cost-credits') || '', 10);
+    const blob = await r.blob();
+    const dir = await getOrCreateBoardSubdir(boardHandle, 'audio');
+    const baseName = await uniqueName(dir, `sfx_${Date.now()}.mp3`);
+    await writeFile(dir, baseName, blob);
+    const relPath = `audio/${baseName}`;
+    await mutateNode(bKey, boardHandle, node.id, n => {
+      n.file = relPath;
+      n.status = undefined;
+      n.generated = {
+        ...(n.generated || {}), state: 'success',
+        ...(Number.isFinite(cost) ? { creditsCharged: cost } : {}),
+      };
+    });
+    if (Number.isFinite(cost)) logJob(node.id, `списано ${cost} credits`);
+    logJob(node.id, `sfx saved → ${relPath}`);
+    if (typeof window.refreshBalance === 'function') window.refreshBalance();
+  } catch (e) {
+    logJob(node.id, `sfx failed: ${e?.message || e}\n${e?.stack || ''}`);
+    await mutateNode(bKey, boardHandle, node.id, n => {
+      n.status = 'error'; n.error = e?.message || String(e);
+    });
+  } finally {
+    state.jobs.delete(node.id);
+    if (typeof updateJobsBadge === 'function') updateJobsBadge();
+  }
+}
+
+// === Music (ElevenLabs) ===
+$('genMusic').addEventListener('click', async () => {
+  if (!state.currentBoard) return;
+  if (!await ensureApiKey('audio')) return;
+  $('musicPrompt').value = '';
+  $('musicDuration').value = '';
+  $('musicStatus').textContent = ''; $('musicStatus').className = 'status';
+  $('musicSubmit').disabled = false;
+  $('musicModal').classList.remove('hidden');
+  setTimeout(() => $('musicPrompt').focus(), 30);
+});
+$('musicCancel').addEventListener('click', () => $('musicModal').classList.add('hidden'));
+$('musicSubmit').addEventListener('click', async () => {
+  const prompt = $('musicPrompt').value.trim();
+  if (!prompt) { $('musicPrompt').focus(); return; }
+  const durRaw = $('musicDuration').value.trim();
+  const durationMs = durRaw ? Math.round(parseFloat(durRaw) * 1000) : null;
+  $('musicSubmit').disabled = true;
+  const status = $('musicStatus');
+  status.className = 'status'; status.textContent = 'Генерация… (может занять до минуты)';
+  $('musicModal').classList.add('hidden');
+  if (state.musicRegenerateTarget) {
+    const node = state.musicRegenerateTarget;
+    state.musicRegenerateTarget = null;
+    await mutateNode(state.currentBoard.key, state.currentBoard.handle, node.id, n => {
+      n.status = 'generating';
+      n.error = undefined;
+      n.generated = { ...(n.generated || {}), kind: 'audio', subKind: 'music', prompt, durationMs, model: 'eleven-music', state: 'submitting' };
+    });
+    runMusicJob(node, prompt, durationMs, state.currentBoard.handle, state.currentBoard.key);
+    return;
+  }
+  const spot = (state.addMenuPos
+    ? { x: (state.addMenuPos.clientX - canvas.getBoundingClientRect().left) / state.zoom,
+        y: (state.addMenuPos.clientY - canvas.getBoundingClientRect().top)  / state.zoom }
+    : findFreeSpot());
+  state.addMenuPos = null;
+  const node = {
+    id: crypto.randomUUID(), type: 'audio',
+    name: uniqueNodeName(state.currentBoard.metadata.nodes, slugifyPrompt(prompt) || 'music'),
+    x: spot.x, y: spot.y, status: 'generating',
+    generated: { kind: 'audio', subKind: 'music', prompt, durationMs, model: 'eleven-music', state: 'submitting' },
+  };
+  state.currentBoard.metadata.nodes.push(node);
+  canvas.appendChild(await createNodeEl(node));
+  scheduleSave();
+  runMusicJob(node, prompt, durationMs, state.currentBoard.handle, state.currentBoard.key);
+});
+
+async function runMusicJob(node, prompt, durationMs, boardHandle, bKey) {
+  state.jobs.set(node.id, { boardKey: bKey, kind: 'audio', nodeId: node.id });
+  if (typeof updateJobsBadge === 'function') updateJobsBadge();
+  if (!boardHandle || typeof boardHandle.getDirectoryHandle !== 'function') {
+    boardHandle = state.currentBoard?.handle;
+  }
+  if (!boardHandle || typeof boardHandle.getDirectoryHandle !== 'function') {
+    const err = 'нет доступа к папке проекта (закрой и открой проект заново)';
+    logJob(node.id, `music aborted: ${err}`);
+    await mutateNode(bKey, boardHandle, node.id, n => { n.status = 'error'; n.error = err; }).catch(() => {});
+    state.jobs.delete(node.id);
+    return;
+  }
+  logJob(node.id, `music start prompt="${(prompt||'').slice(0,80)}" dur=${durationMs||'default'} board=${boardHandle.name||'?'}`);
+  try {
+    const enPrompt = await _translateForSfx(prompt);
+    if (enPrompt !== prompt) {
+      logJob(node.id, `music translated → "${enPrompt.slice(0,100)}"`);
+      await mutateNode(bKey, boardHandle, node.id, n => {
+        n.generated = { ...(n.generated || {}), translatedPrompt: enPrompt };
+      });
+    }
+    const provider = await plannedProvider('music');
+    logJob(node.id, `→ POST /api/music → ${provider} (dur=${durationMs ? durationMs/1000 + 's' : '-'})`);
+    const r = await fetch('/api/music', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ prompt: enPrompt, durationMs }),
+    });
+    logJob(node.id, `← via ${r.headers.get('x-provider') || '?'} HTTP ${r.status}`);
+    if (!r.ok) throw new Error((await r.text()).slice(0, 300) || `HTTP ${r.status}`);
+    const cost = parseInt(r.headers.get('x-cost-credits') || '', 10);
+    const blob = await r.blob();
+    const dir = await getOrCreateBoardSubdir(boardHandle, 'audio');
+    const baseName = await uniqueName(dir, `music_${Date.now()}.mp3`);
+    await writeFile(dir, baseName, blob);
+    const relPath = `audio/${baseName}`;
+    await mutateNode(bKey, boardHandle, node.id, n => {
+      n.file = relPath;
+      n.status = undefined;
+      n.generated = {
+        ...(n.generated || {}), state: 'success',
+        ...(Number.isFinite(cost) ? { creditsCharged: cost } : {}),
+      };
+    });
+    if (Number.isFinite(cost)) logJob(node.id, `списано ${cost} credits`);
+    logJob(node.id, `music saved → ${relPath}`);
+    if (typeof window.refreshBalance === 'function') window.refreshBalance();
+  } catch (e) {
+    logJob(node.id, `music failed: ${e?.message || e}`);
+    await mutateNode(bKey, boardHandle, node.id, n => {
+      n.status = 'error'; n.error = e?.message || String(e);
+    });
+  } finally {
+    state.jobs.delete(node.id);
+    if (typeof updateJobsBadge === 'function') updateJobsBadge();
+  }
+}
+
+$('textGenModal').addEventListener('keydown', e => {
+  // Esc обрабатывает глобальный handler. Cmd+Enter — отправить.
+  if (e.key === 'Enter' && (e.metaKey || e.ctrlKey)) {
+    e.preventDefault();
+    $('textGenSubmit').click();
+  }
+});
+
+// Переключатель типа (картинка/видео)
+document.querySelectorAll('#genModal [data-kind]').forEach(b => {
+  b.addEventListener('click', () => {
+    document.querySelectorAll('#genModal [data-kind]').forEach(x => x.classList.remove('active'));
+    b.classList.add('active');
+    state.genKind = b.dataset.kind;
+    $('imageModelRow').style.display = state.genKind === 'image' ? '' : 'none';
+
+    $('imageOptionsRow').style.display = state.genKind === 'image' ? '' : 'none';
+    $('videoOptionsRow').style.display = state.genKind === 'video' ? '' : 'none';
+
+    $('videoModelRow').style.display = state.genKind === 'video' ? '' : 'none';
+    $('voiceRow').style.display      = state.genKind === 'audio' ? '' : 'none';
+
+    $('ttsModelRow').style.display      = state.genKind === 'audio' ? '' : 'none';
+    $('tonesRow').style.display      = state.genKind === 'audio' ? '' : 'none';
+    if (state.genKind === 'audio') {
+      syncTtsModelActive();
+      if (state.ttsModel === 'elevenlabs/v3') loadVoices();
+      renderTones();
+    }
+    const ph = state.genKind === 'audio'
+      ? 'Текст, который надо озвучить...'
+      : 'Что должно быть. Печатай @ чтобы вставить ссылку на ноду...';
+    $('genPrompt').setAttribute('placeholder', ph);
+    syncSourceRefRow();
+    syncCharLocRows();
+  });
+});
+
+// === Source frame controls ===
+function syncSourceRefRow() {
+  const showable = state.sourceRef && (state.genKind === 'image' || state.genKind === 'video');
+  $('sourceRefRow').style.display = showable ? '' : 'none';
+}
+
+// === Персонажи + Локация: чипы/дропдаун ===
+function renderCharsPickChips() {
+  const wrap = $('charsPickChips');
+  wrap.innerHTML = '';
+  for (const c of state.charactersInfo) {
+    if (!c.characterSheet) continue; // без sheet не из чего брать референс
+    const chip = document.createElement('div');
+    chip.className = 'picker-chip';
+    if (state.pickedCharNames.has(c.name)) chip.classList.add('active');
+    const dot = document.createElement('span'); dot.className = 'dot';
+    chip.appendChild(dot);
+    chip.appendChild(document.createTextNode(c.name));
+    chip.addEventListener('click', () => {
+      if (state.pickedCharNames.has(c.name)) state.pickedCharNames.delete(c.name);
+      else state.pickedCharNames.add(c.name);
+      chip.classList.toggle('active');
+    });
+    wrap.appendChild(chip);
+  }
+}
+
+function renderLocPickSelect() {
+  const sel = $('locPickSelect');
+  sel.innerHTML = '<option value="">— не выбрана —</option>';
+  for (const l of state.locationsInfo) {
+    if (!l.sheet) continue;
+    const opt = document.createElement('option');
+    opt.value = l.name;
+    opt.textContent = l.name;
+    sel.appendChild(opt);
+  }
+  sel.value = state.pickedLocName || '';
+  sel.onchange = () => { state.pickedLocName = sel.value || null; };
+}
+
+function syncCharLocRows() {
+  const showPicker = (state.genKind === 'image' || state.genKind === 'video');
+  $('charsPickRow').style.display = showPicker ? '' : 'none';
+  $('locPickRow').style.display   = showPicker ? '' : 'none';
+}
+
+// Авто-предвыбор: если открываем доску персонажа/локации — пометим её сразу
+function presetPicksForBoard() {
+  const b = state.currentBoard;
+  if (b?.kind === 'character' && b.name) state.pickedCharNames.add(b.name);
+  if (b?.kind === 'location' && b.name)  state.pickedLocName = b.name;
+}
+
+// Собрать рефы из выбранных персонажей и локации (sheet'ы)
+function gatherPickedSheetRefs() {
+  const refs = [];
+  for (const name of state.pickedCharNames) {
+    const c = state.charactersInfo.find(x => x.name === name);
+    if (!c || !c.characterSheet) continue;
+    refs.push({
+      key: `char:${c.name}`,
+      name: c.name,
+      type: 'image',
+      file: c.characterSheet,
+      boardHandle: c.handle,
+      charName: c.name,
+    });
+  }
+  if (state.pickedLocName) {
+    const l = state.locationsInfo.find(x => x.name === state.pickedLocName);
+    if (l && l.sheet) {
+      refs.push({
+        key: `loc:${l.name}`,
+        name: l.name,
+        type: 'image',
+        file: l.sheet,
+        boardHandle: l.handle,
+      });
+    }
+  }
+  return refs;
+}
+
+function resetPicks() {
+  state.pickedCharNames.clear();
+  state.pickedLocName = null;
+}
+function applySourceRefVisuals() {
+  if (!state.sourceRef) return;
+  const box = $('sourceRefBox');
+  const btn = $('sourceRefToggle');
+  box.classList.toggle('disabled', !state.sourceRef.use);
+  btn.textContent = state.sourceRef.use ? 'Отключить' : 'Включить';
+  btn.title = state.sourceRef.use ? 'Не использовать в этой генерации' : 'Использовать как референс';
+}
+$('sourceRefToggle').addEventListener('click', () => {
+  if (!state.sourceRef) return;
+  state.sourceRef.use = !state.sourceRef.use;
+  applySourceRefVisuals();
+});
+
+// =================== Тоны (audio gen) ===================
+function renderTones() {
+  const tags = $('tonesTags');
+  tags.innerHTML = '';
+  for (const t of state.activeTones) {
+    const chip = document.createElement('span');
+    chip.className = 'chip';
+    chip.appendChild(document.createTextNode(t));
+    const x = document.createElement('button');
+    x.className = 'x'; x.type = 'button'; x.textContent = '×';
+    x.addEventListener('click', e => { e.stopPropagation(); removeTone(t); });
+    chip.appendChild(x);
+    tags.appendChild(chip);
+  }
+  // Частые тоны персонажа — кликабельные «ghost»-чипы для быстрого выбора (множественный выбор)
+  const suggestions = (state.toneSuggestions || []).filter(t => !state.activeTones.includes(t));
+  for (const t of suggestions) {
+    const chip = document.createElement('button');
+    chip.type = 'button';
+    chip.className = 'chip ghost';
+    chip.title = 'Кликни, чтобы добавить тон';
+    chip.textContent = '+ ' + t;
+    // mousedown срабатывает раньше любого глобального click-listener'а
+    chip.addEventListener('mousedown', e => {
+      e.preventDefault();
+      e.stopPropagation();
+      addTone(t);
+    });
+    tags.appendChild(chip);
+  }
+}
+function addTone(t) {
+  t = (t || '').trim();
+  if (!t) return;
+  if (!Array.isArray(state.activeTones)) state.activeTones = [];
+  if (!state.activeTones.includes(t)) state.activeTones.push(t);
+  renderTones();
+}
+function removeTone(t) {
+  state.activeTones = state.activeTones.filter(x => x !== t);
+  renderTones();
+}
+function updateToneSuggest() {
+  const inp = $('tonesInput');
+  const q = inp.value.trim().toLowerCase();
+  const pool = [...new Set([...(state.toneSuggestions || []), ...DEFAULT_TONES])];
+  const opts = pool
+    .filter(t => !state.activeTones.includes(t))
+    .filter(t => !q || t.toLowerCase().includes(q))
+    .slice(0, 12);
+  const box = $('tonesSuggest');
+  box.innerHTML = '';
+  if (!opts.length) { box.classList.add('hidden'); return; }
+  opts.forEach((t, i) => {
+    const o = document.createElement('div');
+    o.className = 'opt' + (i === 0 ? ' sel' : '');
+    o.textContent = t;
+    o.addEventListener('mousedown', e => { e.preventDefault(); addTone(t); inp.value = ''; box.classList.add('hidden'); });
+    box.appendChild(o);
+  });
+  box.classList.remove('hidden');
+}
+$('tonesInput').addEventListener('input', updateToneSuggest);
+$('tonesInput').addEventListener('focus', updateToneSuggest);
+$('tonesInput').addEventListener('keydown', e => {
+  const box = $('tonesSuggest');
+  const opts = [...box.querySelectorAll('.opt')];
+  if (e.key === 'Enter' || e.key === ',') {
+    e.preventDefault();
+    const sel = box.querySelector('.opt.sel')?.textContent;
+    const val = sel || $('tonesInput').value.trim();
+    if (val) { addTone(val); $('tonesInput').value = ''; box.classList.add('hidden'); }
+  } else if (e.key === 'ArrowDown' || e.key === 'ArrowUp') {
+    if (!opts.length) return;
+    e.preventDefault();
+    const cur = opts.findIndex(o => o.classList.contains('sel'));
+    const next = e.key === 'ArrowDown' ? Math.min(cur + 1, opts.length - 1) : Math.max(cur - 1, 0);
+    opts.forEach(o => o.classList.remove('sel'));
+    opts[next].classList.add('sel');
+    opts[next].scrollIntoView({ block: 'nearest' });
+  } else if (e.key === 'Escape') {
+    box.classList.add('hidden');
+  }
+});
+document.addEventListener('mousedown', e => {
+  if (!e.target.closest('#tonesRow')) $('tonesSuggest').classList.add('hidden');
+});
+
+let voicesLoaded = false;
+const VOICES_CACHE_KEY = 'voicesCache';
+const VOICES_CACHE_TTL = 24 * 60 * 60 * 1000;
+
+// ElevenLabs v3 в KingKont/Chatium ждёт voice СТРОГО из этого enum'а.
+// (см. server-side validation: ValidationError: voice: invalid enum value).
+// Это не воссы из ElevenLabs API, а hardcoded набор поддерживаемых @start/sdk.
+const ELEVENLABS_V3_VOICES = [
+  'Rachel', 'Drew', 'Clyde', 'Paul', 'Aria', 'Domi', 'Dave', 'Roger',
+  'Fin', 'Sarah', 'James', 'Jane', 'Juniper', 'Arabella', 'Hope',
+  'Bradford', 'Reginald', 'Gaming', 'Austin', 'Kuon', 'Blondie',
+  'Priyanka', 'Alexandra', 'Monika', 'Mark', 'Grimblewood',
+];
+
+function populateVoicesSelect(voices, useEnum) {
+  const select = $('genVoice');
+  select.innerHTML = '';
+  // Через KingKont elevenlabs/v3 принимает только hardcoded enum 26 имён.
+  // Через прямой ElevenLabs — полный список из его API.
+  if (useEnum) {
+    for (const name of ELEVENLABS_V3_VOICES) {
+      const opt = document.createElement('option');
+      opt.value = name;            // value = name (для KingKont)
+      opt.dataset.voiceName = name;
+      opt.textContent = name;
+      select.appendChild(opt);
+    }
+    const last = localStorage.getItem('lastElevenV3Voice');
+    if (last && ELEVENLABS_V3_VOICES.includes(last)) select.value = last;
+    return;
+  }
+  voices.sort((a, b) => a.name.localeCompare(b.name));
+  for (const v of voices) {
+    const opt = document.createElement('option');
+    opt.value = v.id;
+    opt.dataset.voiceName = v.name;
+    const lbl = v.labels || {};
+    const tags = [lbl.gender, lbl.language || lbl.accent, lbl.age].filter(Boolean).join(' / ');
+    opt.textContent = tags ? `${v.name} — ${tags}` : v.name;
+    select.appendChild(opt);
+  }
+  const last = localStorage.getItem('lastVoiceId');
+  if (last && voices.some(v => v.id === last)) select.value = last;
+}
+
+async function loadVoices() {
+  if (voicesLoaded) return;
+  // 1) Подхватываем кэш из localStorage — мгновенно, без сети
+  let cached = null;
+  try {
+    const raw = localStorage.getItem(VOICES_CACHE_KEY);
+    if (raw) cached = JSON.parse(raw);
+  } catch {}
+  if (cached?.voices?.length) {
+    populateVoicesSelect(cached.voices, !!state._ttsUseEnum);
+    voicesLoaded = true;
+  }
+  // 2) Если кэш свежий — выходим
+  if (cached?.ts && Date.now() - cached.ts < VOICES_CACHE_TTL) return;
+  // 3) Иначе обновляем (или грузим впервые)
+  try {
+    const r = await fetch('/api/voices');
+    if (!r.ok) return;
+    const { voices } = await r.json();
+    if (!voices?.length) return;
+    localStorage.setItem(VOICES_CACHE_KEY, JSON.stringify({ ts: Date.now(), voices }));
+    populateVoicesSelect(voices, !!state._ttsUseEnum);
+    voicesLoaded = true;
+  } catch (e) { console.error('voices load failed', e); }
+}
+// Переключатель модели картинки
+document.querySelectorAll('#genModal [data-img-model]').forEach(b => {
+  b.addEventListener('click', () => {
+    document.querySelectorAll('#genModal [data-img-model]').forEach(x => x.classList.remove('active'));
+    b.classList.add('active');
+    state.imageModel = b.dataset.imgModel;
+  });
+});
+// Переключатель модели видео
+document.querySelectorAll('#genModal [data-vid-model]').forEach(b => {
+  b.addEventListener('click', () => {
+    document.querySelectorAll('#genModal [data-vid-model]').forEach(x => x.classList.remove('active'));
+    b.classList.add('active');
+    state.videoModel = b.dataset.vidModel;
+    localStorage.setItem('videoModel', state.videoModel);
+  });
+});
+// Переключатель aspect ratio для image
+document.querySelectorAll('#genModal [data-img-asp]').forEach(b => {
+  b.addEventListener('click', () => {
+    document.querySelectorAll('#genModal [data-img-asp]').forEach(x => x.classList.remove('active'));
+    b.classList.add('active');
+    state.imageAspect = b.dataset.imgAsp;
+    localStorage.setItem('imageAspect', state.imageAspect);
+  });
+});
+function syncImageAspectActive() {
+  document.querySelectorAll('#genModal [data-img-asp]').forEach(b =>
+    b.classList.toggle('active', b.dataset.imgAsp === state.imageAspect));
+}
+syncImageAspectActive();
+
+// Переключатель модели TTS
+document.querySelectorAll('#genModal [data-tts-model]').forEach(b => {
+  b.addEventListener('click', () => {
+    document.querySelectorAll('#genModal [data-tts-model]').forEach(x => x.classList.remove('active'));
+    b.classList.add('active');
+    state.ttsModel = b.dataset.ttsModel;
+    localStorage.setItem('ttsModel', state.ttsModel);
+    syncTtsVoiceList();
+  });
+});
+async function syncTtsVoiceList() {
+  const showVoice = state.ttsModel === 'elevenlabs/v3';
+  $('voiceRow').style.display = showVoice ? '' : 'none';
+  if (!showVoice) return;
+  // Через KingKont — hardcoded enum (validation требует одно из 26 имён).
+  // Через прямой ElevenLabs — полный список из ElevenLabs API.
+  const provider = await plannedProvider('tts');
+  const useEnum = provider === 'kingkont';
+  state._ttsUseEnum = useEnum;
+  if (useEnum) {
+    populateVoicesSelect([], true);
+  } else {
+    // Сбрасываем кэш-флаг и подгружаем свежий список (loadVoices
+    // переиспользует populateVoicesSelect внутри).
+    voicesLoaded = false;
+    await loadVoices();
+  }
+}
+function syncTtsModelActive() {
+  document.querySelectorAll('#genModal [data-tts-model]').forEach(b =>
+    b.classList.toggle('active', b.dataset.ttsModel === state.ttsModel));
+  syncTtsVoiceList();
+}
+// Подсветить активную video-модель при открытии modal'а
+function syncVideoModelActive() {
+  document.querySelectorAll('#genModal [data-vid-model]').forEach(b =>
+    b.classList.toggle('active', b.dataset.vidModel === state.videoModel));
+}
+// Переключатели длительности и разрешения для видео
+document.querySelectorAll('#genModal [data-vid-dur]').forEach(b => {
+  b.addEventListener('click', () => {
+    document.querySelectorAll('#genModal [data-vid-dur]').forEach(x => x.classList.remove('active'));
+    b.classList.add('active');
+    state.videoDuration = +b.dataset.vidDur;
+    localStorage.setItem('videoDuration', String(state.videoDuration));
+  });
+});
+document.querySelectorAll('#genModal [data-vid-res]').forEach(b => {
+  b.addEventListener('click', () => {
+    document.querySelectorAll('#genModal [data-vid-res]').forEach(x => x.classList.remove('active'));
+    b.classList.add('active');
+    state.videoResolution = b.dataset.vidRes;
+    localStorage.setItem('videoResolution', state.videoResolution);
+  });
+});
+document.querySelectorAll('#genModal [data-vid-asp]').forEach(b => {
+  b.addEventListener('click', () => {
+    document.querySelectorAll('#genModal [data-vid-asp]').forEach(x => x.classList.remove('active'));
+    b.classList.add('active');
+    state.videoAspect = b.dataset.vidAsp;
+    localStorage.setItem('videoAspect', state.videoAspect);
+  });
+});
+// Helper: подсветить активные кнопки duration/resolution/aspect согласно state.
+// Вызывать при открытии любой формы где видны videoOptions.
+function syncVideoOptionsActive() {
+  document.querySelectorAll('#genModal [data-vid-dur]').forEach(b =>
+    b.classList.toggle('active', +b.dataset.vidDur === state.videoDuration));
+  document.querySelectorAll('#genModal [data-vid-res]').forEach(b =>
+    b.classList.toggle('active', b.dataset.vidRes === state.videoResolution));
+  document.querySelectorAll('#genModal [data-vid-asp]').forEach(b =>
+    b.classList.toggle('active', b.dataset.vidAsp === state.videoAspect));
+}
+syncVideoOptionsActive();
+syncVideoModelActive();
+
+$('genCancel').addEventListener('click', () => {
+  state.pendingConnectionFrom = null;
+  state.regenerateTarget = null;
+  state.sourceRef = null;
+  state.timelineGenTarget = null;
+  resetPicks();
+  $('sourceRefRow').style.display = 'none';
+  $('charsPickRow').style.display = 'none';
+  $('locPickRow').style.display = 'none';
+  $('genModal').classList.add('hidden');
+});
+
+// «Сохранить» = тот же handler с флагом — нода создаётся как draft, без job.
+$('genSave').addEventListener('click', () => {
+  state.genSaveOnly = true;
+  $('genSubmit').click();
+});
+
+$('genSubmit').addEventListener('click', async () => {
+  const saveOnly = state.genSaveOnly === true;
+  state.genSaveOnly = false;
+  const rawPrompt = $('genPrompt').value.trim();
+  if (!rawPrompt) { alert('Введи описание'); return; }
+  const kind = state.genKind;
+
+  // ===== Regenerate существующей ноды — с возможно изменённым промптом/настройками =====
+  if (state.regenerateTarget) {
+    const target = state.regenerateTarget;
+    const sourceRef = state.sourceRef && state.sourceRef.use ? { ...state.sourceRef } : null;
+    const pickedSheets = gatherPickedSheetRefs();
+    state.regenerateTarget = null;
+    state.sourceRef = null;
+    resetPicks();
+    $('sourceRefRow').style.display = 'none';
+    $('charsPickRow').style.display = 'none';
+    $('locPickRow').style.display = 'none';
+    $('genModal').classList.add('hidden');
+    if (saveOnly) {
+      // Сохраняем правки промпта без запуска генерации.
+      target.generated = { ...(target.generated || {}), rawPrompt, kind };
+      scheduleSave();
+      return;
+    }
+    await regenerateInto(target, kind, rawPrompt, { sourceRef, pickedSheets });
+    return;
+  }
+
+  // ===== Audio (ElevenLabs TTS v3) — отдельный путь, без поллинга =====
+  if (kind === 'audio') {
+    const voiceId = $('genVoice').value || 'JBFqnCBsd6RMkjVDRZzb';
+    const voiceName = $('genVoice').selectedOptions[0]?.textContent || '';
+    if (voiceId) {
+      // Для ElevenLabs v3 (через KingKont) value === name из enum.
+      // Сохраняем в отдельный ключ, иначе при переключении модели
+      // подставится UUID-id и select не выберет его.
+      if (state.ttsModel === 'elevenlabs/v3') {
+        localStorage.setItem('lastElevenV3Voice', voiceId);
+      } else {
+        localStorage.setItem('lastVoiceId', voiceId);
+      }
+    }
+    // Резолвим @-mentions ДО добавления tone-prefix: text-ноды инлайнятся
+    // в их .md-содержимое, иначе ElevenLabs получит «[@name]» → пусто после
+    // strip-spec-tags и упадёт «empty text».
+    const resolvedRaw = (typeof resolveMentions === 'function')
+      ? resolveMentions(rawPrompt, []).trim()
+      : rawPrompt;
+    if (!resolvedRaw) {
+      alert('После раскрытия @-ссылок текст пустой. Проверь содержимое исходных нод.');
+      return;
+    }
+    // Тоны прикладываем как ElevenLabs v3 audio-tags перед текстом
+    const tonePrefix = state.activeTones.map(t => `[${t}]`).join(' ');
+    const finalText = tonePrefix ? `${tonePrefix} ${resolvedRaw}` : resolvedRaw;
+    // Запоминаем имя персонажа ДО сброса timelineGenTarget — fallback на voiceId
+    const charKey = state.timelineGenTarget?.charName || voiceId;
+    const usedTones = [...state.activeTones];
+    let spot;
+    if (state.addMenuPos) {
+      const rect = canvas.getBoundingClientRect();
+      spot = {
+        x: (state.addMenuPos.clientX - rect.left) / state.zoom,
+        y: (state.addMenuPos.clientY - rect.top)  / state.zoom,
+      };
+      state.addMenuPos = null;
+    } else spot = findFreeSpot();
+    const autoName = slugifyPrompt(rawPrompt);
+    const node = {
+      id: crypto.randomUUID(),
+      type: 'audio',
+      ...(autoName ? { name: uniqueNodeName(state.currentBoard.metadata.nodes, autoName) } : {}),
+      x: spot.x, y: spot.y,
+      status: 'generating',
+      generated: {
+        kind: 'audio',
+        prompt: finalText, rawPrompt,
+        model: 'eleven_v3', voiceId, voiceName,
+        ttsModel: state.ttsModel || 'qwen/qwen3-tts',
+        tones: [...state.activeTones],
+      },
+    };
+    if (saveOnly) node.status = 'draft';
+    state.currentBoard.metadata.nodes.push(node);
+    canvas.appendChild(await createNodeEl(node));
+    if (state.pendingConnectionFrom) {
+      addConnection(state.pendingConnectionFrom, node.id);
+      state.pendingConnectionFrom = null;
+    }
+    if (saveOnly) {
+      scheduleSave();
+      $('genModal').classList.add('hidden');
+      state.timelineGenTarget = null;
+      return;
+    }
+    // Если аудио генерится для конкретной точки таймлайна — добавляем placeholder-клип
+    if (state.timelineGenTarget) {
+      const tl = getTimeline();
+      const target = tl?.tracks.find(t => t.id === state.timelineGenTarget.trackId && t.kind === 'audio');
+      if (target) {
+        target.clips.push({
+          id: crypto.randomUUID(),
+          nodeId: node.id,
+          type: 'audio',
+          file: '',  // подхватится из node.file после TTS через syncTimelineClipsForNode
+          name: node.name || 'replica',
+          duration: 5,
+          start: state.timelineGenTarget.time,
+        });
+      }
+      state.timelineGenTarget = null;
+    }
+    // Запомним использованные тоны для этого персонажа (дополним commonTones, сохраним lastTones)
+    rememberCharTones(charKey, usedTones).catch(() => {});
+    scheduleSave();
+    $('genModal').classList.add('hidden');
+    if (!$('timelinePanel').classList.contains('hidden')) renderTimeline();
+    runTTSJob(node, finalText, state.currentBoard.handle, state.currentBoard.key, voiceId);
+    return;
+  }
+
+  const mediaRefs = gatherMediaRefs(rawPrompt);
+  // "Исходный кадр" — добавляем как первый референс, если включён.
+  // Заодно запоминаем savedSourceRef для записи в node.generated, чтобы
+  // связь с родительской нодой пережила regenerate (см. regenerateNode —
+  // там при следующем открытии modal sourceRef восстанавливается из
+  // node.generated.sourceRef).
+  let sourceMarker = '';
+  let savedSourceRef = null;
+  if (state.sourceRef && state.sourceRef.use && state.sourceRef.file) {
+    const sr = state.sourceRef;
+    savedSourceRef = { file: sr.file, type: sr.type };
+    const dup = mediaRefs.some(r => r.file === sr.file && r.boardHandle === sr.boardHandle);
+    if (!dup) {
+      const refType = sr.type === 'video' ? 'video' : 'image';
+      mediaRefs.unshift({
+        key: '__source__',
+        name: 'исходный кадр',
+        type: refType,
+        file: sr.file,
+        boardHandle: sr.boardHandle,
+      });
+      sourceMarker = refType === 'video' ? '[video 1] ' : '[image 1] ';
+    }
+  }
+  // Sheet'ы выбранных персонажей и локации
+  for (const pr of gatherPickedSheetRefs()) {
+    if (mediaRefs.some(r => r.file === pr.file && r.boardHandle === pr.boardHandle)) continue;
+    mediaRefs.push(pr);
+  }
+  const missing = mediaRefs.filter(r => !r.file || r.status === 'generating');
+  if (missing.length) {
+    alert('Эти ноды ещё не готовы: ' + missing.map(m => '@' + m.name).join(', '));
+    return;
+  }
+  let resolvedPrompt = resolveMentions(rawPrompt, mediaRefs);
+  if (sourceMarker) resolvedPrompt = sourceMarker + resolvedPrompt;
+  // Сбрасываем sourceRef и пикеры после использования
+  state.sourceRef = null;
+  resetPicks();
+  $('sourceRefRow').style.display = 'none';
+  $('charsPickRow').style.display = 'none';
+  $('locPickRow').style.display = 'none';
+
+  // Создать pending-ноду сразу. Если был dblclick / drag-line — там, иначе в свободном месте
+  let spot;
+  if (state.addMenuPos) {
+    const rect = canvas.getBoundingClientRect();
+    spot = {
+      x: (state.addMenuPos.clientX - rect.left) / state.zoom,
+      y: (state.addMenuPos.clientY - rect.top)  / state.zoom,
+    };
+    state.addMenuPos = null;
+  } else {
+    spot = findFreeSpot();
+  }
+  const node = {
+    id: crypto.randomUUID(),
+    type: kind === 'image' ? 'image' : 'video',
+    x: spot.x,
+    y: spot.y,
+    status: 'generating',
+    generated: {
+      kind,
+      prompt: resolvedPrompt,
+      rawPrompt,
+      modelKey: kind === 'image' ? state.imageModel : (state.videoModel || 'seedance-2'),
+      model: kind === 'image'
+        ? ({
+            'grok': 'grok-imagine/text-to-image',
+            'seedream': 'seedream/4.5-text-to-image',
+            'seedream-5-lite': 'seedream/5-lite-text-to-image',
+            'nano-banana-2': 'nano-banana-2',
+          }[state.imageModel] || 'nano-banana-2')
+        : ({
+            'seedance-2':       'bytedance/seedance-2',
+            'seedance-2-fast':  'bytedance/seedance-2-fast',
+            'kling-o1':         'kwaivgi/kling-o1',
+            'kling-3.0':        'kling-3.0/video',
+          }[state.videoModel || 'seedance-2'] || 'bytedance/seedance-2'),
+      refs: mediaRefs.map(r => ({ name: r.name, type: r.type, file: r.file })),
+      // Связь с родительской нодой (выведена через "вытягивание"). Хранится
+      // даже если sourceRef.use=false в state — сохраняем структурную связь.
+      ...(savedSourceRef ? { sourceRef: savedSourceRef } : {}),
+      // Параметры видео/картинки сохраняем — при regenerate используем те же.
+      ...(kind === 'video' ? {
+        duration: state.videoDuration,
+        resolution: state.videoResolution,
+        aspectRatio: state.videoAspect,
+      } : {}),
+      ...(kind === 'image' ? {
+        aspectRatio: state.imageAspect,
+      } : {}),
+    },
+  };
+  if (saveOnly) node.status = 'draft';
+  state.currentBoard.metadata.nodes.push(node);
+  canvas.appendChild(await createNodeEl(node));
+
+  // Если открывали через drag-line — фиксируем связь
+  if (state.pendingConnectionFrom) {
+    addConnection(state.pendingConnectionFrom, node.id);
+    state.pendingConnectionFrom = null;
+  }
+
+  scheduleSave();
+
+  $('genModal').classList.add('hidden');
+  if (!saveOnly) {
+    startGenerationJob(node, kind, resolvedPrompt, mediaRefs, state.currentBoard.handle, state.currentBoard.key, node.generated.modelKey);
+  }
+});
+
+async function runTTSJob(node, text, boardHandle, bKey, voiceId) {
+  state.jobs.set(node.id, { boardKey: bKey, kind: 'audio', nodeId: node.id });
+  updateJobsBadge();
+  logJob(node.id, `tts start voice=${voiceId} text="${(text||'').slice(0,80)}"`);
+  try {
+    await mutateNode(bKey, boardHandle, node.id, n => {
+      n.generated = { ...(n.generated || {}), state: 'submitting' };
+    });
+    const provider = await plannedProvider('tts');
+    // ttsModel может быть сохранён в node.generated.ttsModel (при regenerate)
+    // или в текущем глобальном state.ttsModel (новая генерация).
+    const ttsModel = node.generated?.ttsModel || state.ttsModel || 'qwen/qwen3-tts';
+    // ElevenLabs v3 в KingKont/Chatium ждёт voice как ИМЯ ('Rachel', 'Lara
+    // Croft'), не voice_id. Резолвим имя через select option (data-voice-name).
+    let voiceName = node.generated?.voiceName || null;
+    if (!voiceName && voiceId) {
+      const opt = document.querySelector(`#genVoice option[value="${voiceId}"]`);
+      voiceName = opt?.dataset.voiceName || null;
+    }
+    const ttsBody = { text, voiceId, ttsModel };
+    if (ttsModel === 'elevenlabs/v3' && voiceName) {
+      ttsBody.voice = voiceName;  // отправляем ИМЯ
+    } else if (voiceId) {
+      ttsBody.voice = voiceId;
+    }
+    logJob(node.id, `→ POST /api/tts → ${provider} (model=${ttsModel} voice=${ttsBody.voice || '—'})`);
+    const r = await fetch('/api/tts', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(ttsBody),
+    });
+    logJob(node.id, `← via ${r.headers.get('x-provider') || '?'} HTTP ${r.status}`);
+    if (!r.ok) {
+      const t = await r.text().catch(() => '');
+      logJob(node.id, `tts HTTP ${r.status}: ${t.slice(0,200)}`);
+      throw new Error(t || `HTTP ${r.status}`);
+    }
+    const cost = parseInt(r.headers.get('x-cost-credits') || '', 10);
+    const blob = await r.blob();
+    logJob(node.id, `tts response blob ${blob.size} bytes`);
+    const dir = await getOrCreateBoardSubdir(boardHandle, 'audio');
+    const baseName = await uniqueName(dir, `tts_${Date.now()}.mp3`);
+    await writeFile(dir, baseName, blob);
+    const relPath = `audio/${baseName}`;
+    if (Number.isFinite(cost)) logJob(node.id, `списано ${cost} credits`);
+    logJob(node.id, `tts saved → ${relPath}`);
+    await mutateNode(bKey, boardHandle, node.id, n => {
+      n.status = undefined; n.error = undefined; n.file = relPath;
+      if (Number.isFinite(cost)) {
+        n.generated = { ...(n.generated || {}), creditsCharged: cost };
+      }
+    });
+    if (typeof window.refreshBalance === 'function') window.refreshBalance();
+  } catch (e) {
+    logJob(node.id, `tts ERROR: ${e.message}`);
+    await mutateNode(bKey, boardHandle, node.id, n => {
+      n.status = 'error'; n.error = e.message;
+    });
+  } finally {
+    state.jobs.delete(node.id);
+    updateJobsBadge();
+  }
+}
+
+async function startGenerationJob(node, kind, prompt, mediaRefs, boardHandle, bKey, modelKey) {
+  const job = { boardKey: bKey, boardHandle, kind, taskId: null, nodeId: node.id };
+  state.jobs.set(node.id, job);
+  updateJobsBadge();
+  logJob(node.id, `gen start kind=${kind} model=${modelKey || '—'} refs=${mediaRefs?.length || 0} prompt="${(prompt||'').slice(0,200)}"`);
+  // Подробный дамп всех refs со всеми полями
+  logJob(node.id, `refs dump: ${logSafe((mediaRefs || []).map(r => ({
+    key: r.key, name: r.name, type: r.type, file: r.file,
+    char: r.charName || null, board: r.boardHandle?.name || null,
+  })))}`);
+  try {
+    // 1) Загрузить референсы в KIE
+    const imageInputs = [];
+    const videoInputs = [];
+    const uploadDetails = [];
+    if (mediaRefs?.length) {
+      await mutateNode(bKey, boardHandle, node.id, n => {
+        n.generated = { ...(n.generated || {}), state: 'uploading-refs' };
+      });
+      let i = 0;
+      for (const ref of mediaRefs) {
+        i++;
+        const refBoard = ref.boardHandle || boardHandle;
+        const refKey = ref.charName ? `char/${ref.charName}` : bKey;
+        const upStart = Date.now();
+        // Получим размер/MIME до выгрузки — для лога
+        let size = null, mime = null;
+        try {
+          const fh = await resolveBoardFile(refBoard, ref.file);
+          const file = await fh.getFile();
+          size = file.size; mime = file.type || null;
+        } catch (e) {
+          logJob(node.id, `  ✗ resolve FAILED for ${ref.file}: ${e.message}`);
+        }
+        logJob(node.id, `upload ref ${i}/${mediaRefs.length}: key=@${ref.key || ref.name} type=${ref.type} char=${ref.charName||'—'} board=${refBoard?.name||'—'} file=${ref.file} size=${size} mime=${mime}`);
+        const upTimer = setInterval(() => {
+          if (state.jobs.get(node.id) !== job) return;
+          const sec = Math.round((Date.now() - upStart) / 1000);
+          logJob(node.id, `  upload ${i}/${mediaRefs.length} still pending... ${sec}s`);
+        }, 5000);
+        let url;
+        try { url = await uploadBoardFile(refBoard, refKey, ref.file); }
+        catch (e) {
+          clearInterval(upTimer);
+          logJob(node.id, `  ✗ upload FAILED in ${Date.now() - upStart}ms: ${e.message}`);
+          throw e;
+        }
+        clearInterval(upTimer);
+        logJob(node.id, `  ↳ ok in ${Date.now() - upStart}ms — ${url}`);
+        uploadDetails.push({ idx: i, refKey: ref.key, type: ref.type, char: ref.charName||null, file: ref.file, size, mime, url });
+        if (ref.type === 'image') imageInputs.push(url);
+        else if (ref.type === 'video') videoInputs.push(url);
+      }
+    }
+    logJob(node.id, `uploads summary: ${logSafe(uploadDetails)}`);
+
+    // 2) Создать таск
+    await mutateNode(bKey, boardHandle, node.id, n => {
+      n.generated = { ...(n.generated || {}), state: 'submitting' };
+    });
+    const submitBody = { kind, prompt, imageInputs, videoInputs, model: modelKey };
+    if (kind === 'video') {
+      submitBody.duration = node.generated?.duration ?? state.videoDuration;
+      submitBody.resolution = node.generated?.resolution ?? state.videoResolution;
+      submitBody.aspectRatio = node.generated?.aspectRatio ?? state.videoAspect;
+    } else if (kind === 'image') {
+      // Grok-imagine требует aspect_ratio из {2:3, 3:2, 1:1, 9:16, 16:9}.
+      // Остальные модели (nano-banana-2, seedream и др.) тоже принимают.
+      submitBody.aspectRatio = node.generated?.aspectRatio ?? state.imageAspect;
+    }
+    logJob(node.id, `POST /api/generate body: ${logSafe(submitBody)}`);
+    logJob(node.id, `POST /api/generate (image_input=${imageInputs.length}, video_input=${videoInputs.length}, model=${modelKey})`);
+    const submitStart = Date.now();
+    const submitTimer = setInterval(() => {
+      if (state.jobs.get(node.id) !== job) return;
+      const sec = Math.round((Date.now() - submitStart) / 1000);
+      logJob(node.id, `submit still pending... ${sec}s (KIE может тормозить)`);
+      mutateNode(bKey, boardHandle, node.id, n => {
+        n.generated = { ...(n.generated || {}), state: `submitting (${sec}s)` };
+      }).catch(() => {});
+    }, 5000);
+    let r, rawText, data;
+    const provider = await plannedProvider(kind);
+    logJob(node.id, `→ POST /api/generate → ${provider} (kind=${kind} model=${modelKey || '—'})`);
+    try {
+      r = await fetch('/api/generate', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(submitBody),
+      });
+      rawText = await r.text();
+      try { data = JSON.parse(rawText); }
+      catch { logJob(node.id, `/api/generate non-JSON response: ${rawText.slice(0,200)}`); throw new Error('Bad JSON from server'); }
+    } catch (e) {
+      clearInterval(submitTimer);
+      logJob(node.id, `/api/generate FETCH FAILED in ${Date.now() - submitStart}ms: ${e.message}`);
+      throw e;
+    }
+    clearInterval(submitTimer);
+    logJob(node.id, `← via ${r.headers.get('x-provider') || '?'} HTTP ${r.status} in ${Date.now() - submitStart}ms`);
+    if (!r.ok || data.error) {
+      logJob(node.id, `generate ERROR: ${data.error || rawText.slice(0,200)}`);
+      throw new Error(data.error || `HTTP ${r.status}: ${rawText.slice(0,200)}`);
+    }
+    job.taskId = data.taskId;
+    logJob(node.id, `taskId=${data.taskId}`);
+    await mutateNode(bKey, boardHandle, node.id, n => {
+      n.generated = { ...(n.generated || {}), taskId: data.taskId, state: 'queued' };
+    });
+    await pollJob(job, node.id, bKey, boardHandle, kind);
+  } catch (e) {
+    logJob(node.id, `gen ERROR: ${e.message}`);
+    await mutateNode(bKey, boardHandle, node.id, n => {
+      n.status = 'error'; n.error = e.message;
+    });
+    state.jobs.delete(node.id);
+    updateJobsBadge();
+  }
+}
+
+async function resumeJob(node, bKey, boardHandle) {
+  if (state.jobs.has(node.id)) return;
+  if (!node.generated || node.status !== 'generating') return;
+
+  if (node.generated.taskId) {
+    // Уже зарегистрировано в KIE — просто опрашиваем
+    const job = { boardKey: bKey, boardHandle, kind: node.generated.kind, taskId: node.generated.taskId, nodeId: node.id };
+    state.jobs.set(node.id, job);
+    updateJobsBadge();
+    try {
+      await pollJob(job, node.id, bKey, boardHandle, node.generated.kind);
+    } catch (e) {
+      await mutateNode(bKey, boardHandle, node.id, n => { n.status = 'error'; n.error = e.message; });
+      state.jobs.delete(node.id);
+      updateJobsBadge();
+    }
+  } else {
+    // Перезагрузка случилась до сабмита: рестарт с фазы upload+submit.
+    // Маршрутизируем по kind — audio/text не идут через KIE.
+    const kind = node.generated.kind;
+    if (kind === 'audio') {
+      await runTTSJob(node, node.generated.prompt, boardHandle, bKey, node.generated.voiceId);
+    } else if (kind === 'text') {
+      const imageRefs = (node.generated.refs || []).filter(r => r.type === 'image' && r.file);
+      const model = node.generated.model || node.generated.modelKey || 'anthropic/claude-sonnet-4';
+      await runTextJob(node, node.generated.prompt, model, boardHandle, bKey, imageRefs);
+    } else {
+      const refs = (node.generated.refs || []).map(r => ({ name: r.name, type: r.type, file: r.file }));
+      await startGenerationJob(node, kind, node.generated.prompt, refs, boardHandle, bKey, node.generated.modelKey);
+    }
+  }
+}
+
+async function scanAllBoardsForPendingJobs(filmHandle) {
+  const [eps, chars] = await Promise.all([listEpisodes(filmHandle), listCharacters(filmHandle)]);
+  const all = [
+    ...eps.map(b => ({ kind: 'episode', ...b })),
+    ...chars.map(b => ({ kind: 'character', ...b })),
+  ];
+  for (const b of all) {
+    try {
+      const meta = await loadBoardMetadata(b.handle);
+      const bKey = boardKey(b.kind, b.name);
+      for (const n of meta.nodes) {
+        if (n.status === 'generating' && n.generated?.taskId && !state.jobs.has(n.id)) {
+          resumeJob(n, bKey, b.handle);
+        }
+      }
+    } catch (e) { console.warn('scan board failed', b.name, e); }
+  }
+}
+
+async function pollJob(job, nodeId, bKey, boardHandle, kind) {
+  let pollCount = 0;
+  let lastState = null;
+  while (state.jobs.get(nodeId) === job) {
+    await new Promise(r => setTimeout(r, 4000));
+    if (state.jobs.get(nodeId) !== job) return;
+    pollCount++;
+    let pr, pd;
+    try {
+      pr = await fetch(`/api/poll?taskId=${encodeURIComponent(job.taskId)}`);
+      pd = await pr.json();
+    } catch (e) {
+      logJob(nodeId, `poll #${pollCount} network ERROR: ${e.message}`);
+      continue;
+    }
+    // Логируем провайдера только когда меняется state (раз в несколько polls'ов).
+    // Иначе таблица логов забьётся повторами «via kie» каждые 4 секунды.
+    const provider = pr.headers.get('x-provider') || '?';
+    if (pd.state && pd.state !== lastState) {
+      logJob(nodeId, `poll #${pollCount} via ${provider} state=${pd.state}`);
+      lastState = pd.state;
+    } else if (pollCount % 6 === 0) {
+      logJob(nodeId, `poll #${pollCount} via ${provider} state=${pd.state || pd.status}`);
+    }
+    if (pd.status === 'done') {
+      logJob(nodeId, `done, downloading ${pd.url?.slice(0,80)}`);
+      const blob = await (await fetch(`/api/proxy?url=${encodeURIComponent(pd.url)}`)).blob();
+      const ext = kind === 'image' ? 'jpg' : 'mp4';
+      const sub = kind === 'image' ? 'frames' : 'clips';
+      const dir = await getOrCreateBoardSubdir(boardHandle, sub);
+      const baseName = await uniqueName(dir, `gen_${Date.now()}.${ext}`);
+      await writeFile(dir, baseName, blob);
+      const relPath = `${sub}/${baseName}`;
+      const cost = typeof pd.cost === 'number' ? pd.cost : null;
+      if (cost !== null) logJob(nodeId, `списано ${cost} credits`);
+      logJob(nodeId, `done → file=${relPath} (${blob.size} bytes)`);
+      await mutateNode(bKey, boardHandle, nodeId, n => {
+        n.status = undefined; n.error = undefined; n.file = relPath;
+        if (cost !== null) {
+          n.generated = { ...(n.generated || {}), creditsCharged: cost };
+        }
+      });
+      state.jobs.delete(nodeId);
+      updateJobsBadge();
+      if (typeof window.refreshBalance === 'function') window.refreshBalance();
+      return;
+    }
+    if (pd.status === 'error') {
+      logJob(nodeId, `KIE error: ${pd.error || 'unknown'}`);
+      throw new Error(pd.error || 'generation failed');
+    }
+    if (pd.state) {
+      await mutateNode(bKey, boardHandle, nodeId, n => {
+        n.generated = { ...(n.generated || {}), state: pd.state };
+      });
+    }
+  }
+}
+
+// Обновляет .state-text внутри node-body не перерисовывая всё тело —
+// для частых state-only тиков ("submitting (5s)" → "(10s)") DOM-rebuild дорог.
+function updateNodeStateText(nodeId, stateKey) {
+  const root = canvas.querySelector(`.node[data-id="${nodeId}"] .gen-pending .state-text`);
+  if (!root) return false;
+  const LABELS = {
+    'uploading-refs': 'Загружаю референсы в KIE...',
+    'submitting': 'Отправляю задачу...',
+    'queued': 'В очереди...',
+    'waiting': 'В очереди...',
+    'queuing': 'В очереди...',
+    'generating': 'Модель работает...',
+  };
+  root.textContent = LABELS[stateKey] || (stateKey ? `Статус: ${stateKey}` : 'Генерируется...');
+  return true;
+}
+
+// Обновление ноды (на любой доске): меняем in-memory state если эта доска текущая,
+// иначе грузим metadata, патчим и пишем; всегда сохраняем на диск; если нода видна — обновляем DOM.
+async function mutateNode(bKey, boardHandle, nodeId, mutator) {
+  // Текущая доска?
+  if (state.currentBoard?.key === bKey) {
+    const node = state.currentBoard.metadata.nodes.find(n => n.id === nodeId);
+    if (node) {
+      const fileBefore = node.file;
+      const statusBefore = node.status;
+      const stateBefore = node.generated?.state;
+      mutator(node);
+      const fileChanged = node.file !== fileBefore;
+      const statusChanged = node.status !== statusBefore;
+      const stateOnly = !statusChanged && !fileChanged && node.generated?.state !== stateBefore;
+      // Если файл сменился (после регена) — подхватить новый файл в клипах таймлайна
+      if (fileChanged && node.file) {
+        syncTimelineClipsForNode(node);
+      }
+      syncHistorySlot(node);
+      scheduleSave();
+      // Частый кейс: меняется только текст статуса генерации. Точечно обновляем .state-text,
+      // не перестраивая всё тело ноды и не дёргая таймлайн.
+      if (stateOnly && updateNodeStateText(nodeId, node.generated?.state)) {
+        return;
+      }
+      await refreshNodeDOM(nodeId);
+      if (fileChanged || statusChanged) refreshTimelineForNode(nodeId);
+      return;
+    }
+  }
+  // Иначе — на диск напрямую
+  const meta = await loadBoardMetadata(boardHandle);
+  const node = meta.nodes.find(n => n.id === nodeId);
+  if (!node) return;
+  mutator(node);
+  syncHistorySlot(node);
+  await saveBoardMetadata(boardHandle, {
+    nodes: meta.nodes,
+    connections: meta.connections,
+    view: meta.view,
+    character: meta.character,
+    location: meta.location,
+    timeline: meta.timeline,
+  });
+}
+
+function updateJobsBadge() {
+  const el = $('jobsInfo');
+  const n = state.jobs.size;
+  if (n === 0) { el.style.display = 'none'; return; }
+  el.style.display = '';
+  el.innerHTML = `<span class="spinner"></span>В фоне: ${n}`;
+}
+