@danhachuel/thunderbolt 0.4.10 → 0.4.11

package/README.md

@@ -44,7 +44,7 @@ A migração é baseada no workflow público [AI Agents A-Z — episódio 35](ht
 
 ## Pipeline de vídeo — fontes e ordem de execução
 
-Em **Pipeline Vídeos > Criação de Vídeos** e **Automação Youtube**, a opção **Pexels/Pixabay** usa a rota stock do [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo): as keywords do roteiro são encaminhadas para a pesquisa da fonte seleccionada, os clips são descarregados e reutilizados localmente, e o motor faz a composição com MoviePy/FFmpeg, respeitando proporção, duração máxima, concatenação, transições, correspondência visual ao roteiro, narração, legendas e música de fundo. As API keys de Pexels e Pixabay são exportadas para o `config.toml` do motor e a fonte efectiva é encaminhada por tarefa, sem depender apenas da fonte global guardada nas configurações.
+Em **Pipeline Vídeos > Criação de Vídeos** e **Automação Youtube**, a opção **Pexels/Pixabay** usa a rota stock do [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo): as keywords do roteiro são encaminhadas para a pesquisa da fonte seleccionada, os clips são descarregados e reutilizados localmente, e o motor faz a composição com MoviePy/FFmpeg, respeitando proporção, duração máxima, concatenação, transições, correspondência visual ao roteiro, narração, legendas e música de fundo. As API keys de Pexels e Pixabay são exportadas para o `config.toml` do motor e a fonte efectiva é encaminhada por tarefa, sem depender apenas da fonte global guardada nas configurações. Em **Configurações > Configuração API > API Keys > Imagem e Video Montagem/MoviePy**, cada cartão possui o campo **Prioridade**: o menor número aparece primeiro e a ordenação fica guardada no storage local.
 
 A ordem persistida da criação é **Tema → Script → Título → Keywords opcional → Vídeo → Prompt Thumbnail em JSON → Thumbnail → Upload**. O vídeo é materializado antes do prompt e da imagem da thumbnail; uma falha posterior de thumbnail não invalida um MP4 já pronto. **Full IA** é uma rota separada e usa o pool de vídeo configurável com **FAL AI, KIE AI, Agnes AI, Nano Banana, Replicate AI, Pollinations.ai, Hugging Face Inference API, InferencePort Proxy e HeyGen**, respeitando apenas cartões activos que declarem capacidade de vídeo. **Apenas Música** não chama a pipeline de vídeo nem tenta gerar thumbnail: reutiliza o áudio local/Suno já descarregado e deixa-o pronto para a integração de upload musical.
 

package/app/main.py

@@ -5617,7 +5617,7 @@ def _render_material_source_card(settings: dict[str, Any], cards: list[dict[str,
             _render_credential_status("" if is_local else card.get("api_key"), local=is_local, required=not is_local)
         card_form = nullcontext() if embedded else st.form(f"material_source_card_form_{card_id}")
         with card_form:
-            content_cols = st.columns(2)
+            content_cols = st.columns([1.4, 1.25, 0.85])
             with content_cols[0]:
                 if is_local:
                     st.caption("Esta fonte não usa API key.")
@@ -5631,6 +5631,16 @@ def _render_material_source_card(settings: dict[str, Any], cards: list[dict[str,
                     value=active_card_id == card_id,
                     key=f"material_card_{card_id}_selected",
                 )
+            with content_cols[2]:
+                priority = st.number_input(
+                    "Prioridade",
+                    min_value=1,
+                    max_value=999,
+                    value=max(1, int(card.get("priority", index + 1))),
+                    step=1,
+                    help="1 é o primeiro provider da fila. Em caso de falha elegível, os providers seguintes são considerados por ordem crescente.",
+                    key=f"material_card_{card_id}_priority",
+                )
             if not is_local:
                 _render_api_test_control(
                     settings,
@@ -5640,7 +5650,12 @@ def _render_material_source_card(settings: dict[str, Any], cards: list[dict[str,
                 )
             save_card = st.form_submit_button("Salvar", type="primary", use_container_width=True, key=f"material_card_{card_id}_save")
         if save_card:
-            cards[index] = {**card, "api_key": str(api_key or "").strip(), "enabled": bool(enabled)}
+            cards[index] = {
+                **card,
+                "api_key": str(api_key or "").strip(),
+                "enabled": bool(enabled),
+                "priority": max(1, int(priority)),
+            }
             selected_id = card_id if selected and enabled else active_card_id
             _persist_material_source_cards(settings, cards, selected_id)
             st.success(f"Fonte {definition['label']} guardada.")
@@ -5668,7 +5683,12 @@ def render_material_source_api_keys(settings: dict[str, Any], *, embedded: bool
         )
         add_source_clicked = st.form_submit_button("Configurar Nova Fonte de Materiais", type="primary", use_container_width=True, key="add_material_source_card") if embedded else st.button("Configurar Nova Fonte de Materiais", type="primary", use_container_width=True, key="add_material_source_card")
         if add_source_clicked:
-            cards.append(new_material_card(provider_to_add, card_id=f"material-{provider_to_add}-{uuid.uuid4().hex[:8]}"))
+            new_card = new_material_card(provider_to_add, card_id=f"material-{provider_to_add}-{uuid.uuid4().hex[:8]}")
+            new_card["priority"] = max(
+                (int(item.get("priority", index + 1)) for index, item in enumerate(cards)),
+                default=0,
+            ) + 1
+            cards.append(new_card)
             _persist_material_source_cards(settings, cards, str(settings.get("material_active_card_id") or ""))
             st.rerun()
 

package/hermes_ui/material_sources.py

@@ -6,6 +6,7 @@ from uuid import uuid4
 
 MATERIAL_CARDS_KEY = "material_source_cards"
 MATERIAL_ACTIVE_CARD_KEY = "material_active_card_id"
+DEFAULT_MATERIAL_PRIORITY = 1
 
 MATERIAL_SOURCE_CATALOG: tuple[dict[str, str], ...] = (
     {"code": "pexels", "label": "Pexels", "description": "Banco de vídeos e imagens para materiais da pipeline.", "legacy_key": "pexels_api_keys"},
@@ -43,15 +44,29 @@ def material_source_definition(source: Any) -> dict[str, str] | None:
     return _SOURCE_BY_CODE.get(str(source or "").strip().lower())
 
 
-def _new_card(provider: str, api_key: str = "", *, card_id: str | None = None) -> dict[str, Any]:
+def _new_card(
+    provider: str,
+    api_key: str = "",
+    *,
+    card_id: str | None = None,
+    priority: int = DEFAULT_MATERIAL_PRIORITY,
+) -> dict[str, Any]:
     return {
         "id": card_id or f"material-{provider}-{uuid4().hex[:8]}",
         "provider": provider,
         "api_key": str(api_key or "").strip(),
         "enabled": True,
+        "priority": max(1, int(priority)),
     }
 
 
+def _normalise_priority(value: Any, fallback: int = DEFAULT_MATERIAL_PRIORITY) -> int:
+    try:
+        return max(1, int(value))
+    except (TypeError, ValueError):
+        return max(1, int(fallback or DEFAULT_MATERIAL_PRIORITY))
+
+
 def normalize_material_card(card: Any, index: int = 0) -> dict[str, Any]:
     raw = card if isinstance(card, dict) else {}
     provider = str(raw.get("provider") or raw.get("source") or "pexels").strip().lower()
@@ -63,9 +78,25 @@ def normalize_material_card(card: Any, index: int = 0) -> dict[str, Any]:
         "provider": provider,
         "api_key": str(raw.get("api_key") or raw.get("key") or "").strip() if provider != "local" else "",
         "enabled": bool(raw.get("enabled", True)),
+        "priority": _normalise_priority(raw.get("priority", index + 1), index + 1),
     }
 
 
+def _ordered_cards(cards: list[dict[str, Any]]) -> list[dict[str, Any]]:
+    indexed = [(index, normalize_material_card(card, index)) for index, card in enumerate(cards)]
+    indexed.sort(key=lambda pair: (pair[1].get("priority", pair[0] + 1), pair[0]))
+    return [card for _index, card in indexed]
+
+
+def material_source_cards(settings: dict[str, Any], *, enabled_only: bool = False) -> list[dict[str, Any]]:
+    """Return material providers in stable priority order for the MoviePy queue."""
+    migrated, _ = ensure_material_source_cards(settings)
+    cards = [dict(item) for item in migrated.get(MATERIAL_CARDS_KEY, [])]
+    if enabled_only:
+        cards = [card for card in cards if card.get("enabled", True)]
+    return cards
+
+
 def _cards_key_mapping(cards: list[dict[str, Any]]) -> dict[str, list[str]]:
     mapping = {item["code"]: [] for item in MATERIAL_SOURCE_CATALOG}
     for index, raw_card in enumerate(cards):
@@ -94,12 +125,23 @@ def ensure_material_source_cards(settings: dict[str, Any]) -> tuple[dict[str, An
         cards: list[dict[str, Any]] = []
         for item in MATERIAL_SOURCE_CATALOG:
             for key in material_api_keys(settings, item["code"], _ignore_cards=True):
-                cards.append(_new_card(item["code"], key, card_id=f"material-{item['code']}-{len(cards)}"))
+                cards.append(
+                    _new_card(
+                        item["code"],
+                        key,
+                        card_id=f"material-{item['code']}-{len(cards)}",
+                        priority=len(cards) + 1,
+                    )
+                )
         if not cards:
             selected = selected_material_source(settings)
             cards.append(_new_card(selected if selected in _SOURCE_BY_CODE else "pexels", card_id="material-default-0"))
         changed = True
 
+    ordered_cards = _ordered_cards(cards)
+    if ordered_cards != cards:
+        changed = True
+    cards = ordered_cards
     settings[MATERIAL_CARDS_KEY] = cards
     active_id = str(settings.get(MATERIAL_ACTIVE_CARD_KEY) or "").strip()
     valid_ids = {str(card["id"]) for card in cards}
@@ -137,6 +179,7 @@ def apply_material_source_cards_to_settings(
     normalized_cards = [normalize_material_card(item, index) for index, item in enumerate(cards)]
     if not normalized_cards:
         normalized_cards = [_new_card("pexels", card_id="material-default-0")]
+    normalized_cards = _ordered_cards(normalized_cards)
     settings[MATERIAL_CARDS_KEY] = normalized_cards
     selected_card = next((card for card in normalized_cards if str(card["id"]) == str(active_card_id)), None)
     if selected_card is None:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/thunderbolt",
-  "version": "0.4.10",
+  "version": "0.4.11",
   "description": "Thunderbolt — interface local para operação de canais faceless e motor MoneyPrinterTurbo",
   "license": "MIT",
   "main": "scripts/cli.mjs",