@danhachuel/thunderbolt 0.3.61 → 0.3.63

package/MANUAL-INSTALACAO.md

@@ -2,7 +2,7 @@
 
 Este manual descreve a instalação local da UI Thunderbolt, baseada no MoneyPrinterTurbo, utilizando o pacote npm `@danhachuel/thunderbolt`. O fluxo recomendado instala automaticamente o ambiente Python, as dependências da aplicação, as dependências do MoneyPrinterTurbo, o Streamlit e o suporte FFmpeg através de `imageio-ffmpeg`.
 
-> **Versão deste manual:** 0.3.61
+> **Versão deste manual:** 0.3.63
 > **Pacote npm:** `@danhachuel/thunderbolt`
 > **Porta padrão da UI:** `localhost:3030`  
 > **Repositório:** [github.com/DanHachuel/thunderbolt](https://github.com/DanHachuel/thunderbolt)
@@ -41,6 +41,20 @@ A geração guarda prompt, caption, provider, modelo, plataforma, estado e camin
 
 O runtime do Thunderbolt adapta o comportamento dos workflows do episódio 35, mas não instala nem executa n8n. Formulários, Data Tables, Switch, Wait e subworkflows são substituídos por páginas Streamlit, repository Supabase/SQLite, adapters multimédia, worker, logs e notificações. Nunca coloque API keys nos JSONs dos workflows, em ficheiros versionados ou em mensagens de diagnóstico.
 
+## Pipeline de vídeo: fontes, composição e ordem
+
+Em **Pipeline Vídeos > Criação de Vídeos** e **Automação Youtube**, seleccione a fonte no próprio vídeo ou na automação. **Pexels/Pixabay** é a rota stock e usa a infraestrutura do [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo): pesquisa por keywords, filtros de proporção e duração, cache e deduplicação de clips, descarga de materiais e composição MoviePy/FFmpeg com concatenação, transições, narração, legendas e música de fundo. A fonte escolhida é passada explicitamente ao processo (`pexels` ou `pixabay`) e as listas de API keys são sincronizadas no `config.toml`, permitindo a rotação configurada.
+
+A execução segue sempre **Tema → Script → Título → Keywords (opcional) → Vídeo → Prompt Thumbnail (JSON) → Thumbnail (imagem) → Upload**. Keywords são opcionais: se a geração por LLM falhar, é usado um fallback determinístico para não bloquear a etapa de vídeo. O worker guarda o MP4 antes de iniciar prompt ou imagem da thumbnail; assim, uma falha de quota na imagem não elimina um vídeo concluído.
+
+| Opção visível | Rota executada | Resultado esperado |
+|---|---|---|
+| Pexels/Pixabay | MoneyPrinterTurbo stock com a fonte efectiva e as chaves correspondentes | MP4 composto localmente |
+| Full IA | Pool de vídeo limitado a FAL AI, KIE AI e Agnes AI | MP4 gerado pelo provider activo |
+| Apenas Música | Áudio local/Suno já preparado | Ficheiro musical pronto para um upload de música; não gera MP4, thumbnail nem upload YouTube |
+
+Antes de iniciar a rota stock, confirme em **Configurações > Configuração API > Fontes de materiais** que existe pelo menos uma API key para a fonte efectiva. Sem uma key Pexels/Pixabay, o erro é apresentado como configuração da fonte, em vez de uma falha genérica de vídeo. Se o MoneyPrinterTurbo devolver `MPT_NEEDS_INPUT`, o Thunderbolt lê `LLM_PROVIDER`, `MISSING` e `INVALID` e mostra no erro todas as APIs afectadas, como **OpenAI / NVIDIA NIM API + Pexels API**, incluindo os campos que faltam. **Google Lyria não é apresentado como implementado nesta release**; a rota Apenas Música aceita áudio local e a integração Suno existente.
+
 ## 2. Pré-requisitos
 
 Instale os seguintes componentes antes de executar o instalador:
@@ -114,13 +128,13 @@ Execute:
 Windows PowerShell ou MobaXterm:
 
 ```powershell
-npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.61 install
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.63 install
 ```
 
 Linux/macOS:
 
 ```bash
-npx --yes --prefer-online @danhachuel/thunderbolt@0.3.61 install
+npx --yes --prefer-online @danhachuel/thunderbolt@0.3.63 install
 ```
 
 A instalação normal é **segura para actualizações**: preserva `storage`, Blueprints, Brandings, configurações e artefactos do utilizador. Remove apenas `.venv`, o clone técnico do MoneyPrinterTurbo e dependências que serão recriadas. Uma pasta antiga sem dados do utilizador, como `C:\Users\<utilizador>\AppData\Local\hermes` da tentativa incompleta, pode ser removida; uma pasta antiga que contenha Blueprints, Brandings ou storage é preservada e apenas avisada no terminal. Feche processos Python, Node, Streamlit e MobaXterm que estejam a usar as pastas antes de executar.
@@ -128,7 +142,7 @@ A instalação normal é **segura para actualizações**: preserva `storage`, Bl
 Se quiser apagar absolutamente tudo de forma intencional, use o comando destrutivo separado:
 
 ```powershell
-npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.61 install --purge-data
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.63 install --purge-data
 ```
 
 O parâmetro `--purge-data` apaga Blueprints, Brandings, configurações, storage e artefactos locais. Não o use numa actualização normal.
@@ -524,7 +538,7 @@ O cartão mostra o nicho imediatamente abaixo do nome. Os quatro blocos compacto
 
 A secção **Últimos 10 vídeos publicados** fica abaixo das configurações do canal, dentro de um expander fechado por defeito, e não dentro de Criação de Vídeos. Clique no expander e depois em **Actualizar últimos 10 vídeos** para consultar o feed RSS público do YouTube sem Data API Key. Os resultados são guardados em `storage/state/channel_videos.json`. A única vista disponível é **Lista**, que apresenta título, data, URL, estado e botão **Editar vídeo**. A edição local permite alterar título, estado, data, URL e notas. Essas alterações são overrides de gestão local e não publicam automaticamente no YouTube.
 
-A página **Configurações > Logs** aparece no menu entre **Notificações** e **Configuração API**. Mostra uma projecção unificada das tarefas e notificações persistentes, com filtro livre por operação, filtros por operação e estado e as colunas mínimas **Operação**, **Estado**, **Data** e **Hora**. A tabela também mostra **Registo**, **Origem**, **Progresso** e **Detalhes**; estados como pendente, em execução, concluído, publicado, falha, cancelado e bloqueado são apresentados quando existirem no storage local.
+A página **Configurações > Logs** aparece no menu entre **Notificações** e **Configuração API**. Mostra uma projecção unificada das tarefas e notificações persistentes, com filtro livre por operação, filtros por operação e estado e as colunas mínimas **Operação**, **Estado**, **Data** e **Hora**. A tabela também mostra **Registo**, **Origem**, **Progresso**, **API/Provider** e **Detalhes**; em qualquer falha nova, **API/Provider** identifica a API ou o pool responsável, o serviço, a rota e os campos de configuração em falta. Registos anteriores sem essa metadata aparecem explicitamente como falhas históricas cuja API não pôde ser identificada. Estados como pendente, em execução, concluído, publicado, falha, cancelado e bloqueado são apresentados quando existirem no storage local.
 
 ## Canais em lote por conta Google/YouTube
 
@@ -542,7 +556,7 @@ Ao abrir a página, o Thunderbolt não prepara dados públicos, não descarrega
 
 Os parâmetros da UI são número de clusters entre 2 e 10, suporte mínimo entre 0,01 e 0,50, país, engagement, intervalo de datas e tags, todos dentro da área principal da aba. O núcleo normaliza os dados, calcula engagement, aplica filtros, faz transformação logarítmica e standardização, executa K-Means e calcula itemsets/regras com FP-Growth. Não são apresentados resultados até ao primeiro clique em **Analisar Nichos**; o mesmo botão aplica alterações posteriores aos filtros. Os resultados são DataFrames de clusters, itemsets frequentes, regras de associação e dados analisados; o gráfico de dispersão é criado nativamente com Plotly.
 
-As dependências adicionais — `scikit-learn`, `mlxtend`, `plotly`, `seaborn`, `matplotlib` e `kagglehub` — são instaladas pelo procedimento normal de `npx`. Em instalações existentes, execute novamente `npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.61 install`; o instalador detecta e reutiliza o que já estiver válido.
+As dependências adicionais — `scikit-learn`, `mlxtend`, `plotly`, `seaborn`, `matplotlib` e `kagglehub` — são instaladas pelo procedimento normal de `npx`. Em instalações existentes, execute novamente `npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.63 install`; o instalador detecta e reutiliza o que já estiver válido.
 
 ### Niche Finder Apify
 

package/README.md

@@ -2,7 +2,7 @@
 
 > Consulte o [Manual completo de instalação](MANUAL-INSTALACAO.md) antes do primeiro teste local.
 
-Thunderbolt — UI web local da Fase 3, baseada no fluxo Streamlit do [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo). A aplicação organiza canais, blueprints, lotes de vídeos, filas, artefactos e upload em armazenamento local JSON.
+Thunderbolt — UI web local da Fase 3, baseada no fluxo Streamlit do [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo). A aplicação organiza canais, blueprints, lotes de vídeos, filas, artefactos e upload em armazenamento local JSON. O pacote npm distribui apenas os seeds versionados em `seed/`; não inclui `storage/` persistente, pelo que Blueprints, personagens, configurações e artefactos locais não são enviados durante uma actualização.
 
 ## Estado actual
 
@@ -38,6 +38,14 @@ A página **AI Influencers > Geração de Conteúdo IA** contém as subabas **Im
 
 A migração é baseada no workflow público [AI Agents A-Z — episódio 35](https://github.com/gyoridavid/ai_agents_az/tree/main/episode_35), mas o runtime do Thunderbolt não instala nem executa n8n. Os formulários, Data Tables, waits e subworkflows são substituídos pela UI Streamlit, pelo repositório dual Supabase/SQLite, pelos adapters multimédia e pelos logs/notificações locais. As API keys são sempre configuradas localmente e não devem ser colocadas nos JSONs do workflow ou no GitHub.
 
+## 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.
+
+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 exclusivamente os cartões activos FAL AI, KIE AI e Agnes AI do pool 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.
+
+Quando uma etapa falha, a tarefa, a notificação e a página **Configurações > Logs** guardam e mostram sempre a coluna **API/Provider**, o serviço, a rota e, quando aplicável, os campos de configuração em falta. No caso do MoneyPrinterTurbo, os marcadores `LLM_PROVIDER`, `MISSING` e `INVALID` são convertidos em attribution legível; por exemplo, um erro pode indicar simultaneamente **OpenAI / NVIDIA NIM API** e **Pexels API**, em vez de apresentar apenas a mensagem genérica de credenciais adicionais. Registos históricos sem metadata são identificados explicitamente como anteriores à attribution estruturada.
+
 ## Upload-Post — publicação para múltiplas plataformas
 
 A página **Upload** contém quatro subabas: **Upload convencional**, **Upload directo**, **Postiz** e **Upload-Post**. A quarta alternativa usa a API oficial do [Upload-Post](https://docs.upload-post.com/) para enviar um vídeo local para uma ou mais plataformas ligadas ao perfil configurado. Seleccione as plataformas na própria subaba, confirme o título e a descrição e clique em **Enviar vídeo pelo Upload-Post**.
@@ -79,7 +87,7 @@ No topo da área principal da aplicação existe o menu nativo de idioma no padr
 
 A UI suporta os temas **Dark** e **Light** através do menu nativo de três pontos do Streamlit, no local original do toolbar. Não existe um selector Theme adicional dentro da página. A configuração distribuída em `.streamlit/config.toml` disponibiliza as variantes nomeadas **Dark** e **Light**, e o menu nativo continua responsável por alternar entre os modos, seguindo o padrão do [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo). O CSS próprio do Thunderbolt usa cores semânticas, `currentColor` e `color-mix` para acompanhar o tema activo, sem alterar a posição nem a funcionalidade do toolbar, do botão Deploy e do menu principal.
 
-## Navegação da UI 0.3.61
+## Navegação da UI 0.3.63
 
 A barra lateral mantém os níveis principais, nesta ordem: **Início**, **Niche Finder**, **Pipeline**, **Pipeline TikTok**, **Automação**, **Edição**, **AI Influencers** e **Configurações**. **Pipeline Vídeos** é expansível e contém **Criação de Vídeos**, **Backlog Vídeos**, **Roteiros**, **Thumbnails** e **Upload**. **Pipeline Música** é expansível e contém **Criação de Músicas** e **Upload Música**. **Automação** também é expansível e contém **Automação Youtube**. **Edição** é expansível e contém **Limpador de Metadados**, **Cortes**, **Editor Python** e **Download Mídia**, nessa ordem. **AI Influencers** é expansível e contém **Personagens**, **Geração de Conteúdo IA**, **Redes Sociais**, **Tutorial Meta** e **Tutorial Supabase**, nessa ordem. A página Geração de Conteúdo IA divide-se em **Imagens**, **Vídeos** e **Motion Control**; a subaba Motion Control permanece vazia nesta release.
  **Niche Finder** é expansível e contém **Niche Finder Kaggle** e **Niche Finder Apify**. **Configurações** é expansível e contém **Canais Youtube**, **Blueprints Youtube**, **MCP**, **Contas Google**, **Notificações**, **Logs** e **Configuração API**, nessa ordem. O Início reúne o dashboard e as filas do Pipeline, sem botões de acções rápidas.

package/app/main.py

@@ -97,6 +97,7 @@ AI_STYLE_OPTIONS = [
 ]
 
 WIDE_STYLE_OPTIONS = ["Pexels/Pixabay", "full_ia", "Apenas Música"]
+MATERIAL_SOURCE_OPTIONS = ["Pexels", "Pixabay"]
 
 VIDEO_LANGUAGE_OPTIONS = [
     "00 – Apenas Música de Fundo (Sem Falas)",
@@ -993,6 +994,18 @@ def render_video_generation_settings(
             video_cols = st.columns(2)
             with video_cols[0]:
                 settings["video_source"] = st.selectbox("Video Source", WIDE_STYLE_OPTIONS, key=f"{prefix}_video_source")
+                if settings["video_source"] == "Pexels/Pixabay":
+                    configured_material_source = selected_material_source(read_json("settings.json", {}))
+                    material_source_labels = {"pexels": "Pexels", "pixabay": "Pixabay"}
+                    configured_material_label = material_source_labels.get(configured_material_source, "Pexels")
+                    settings["material_source"] = st.selectbox(
+                        "Stock Material Source",
+                        MATERIAL_SOURCE_OPTIONS,
+                        index=MATERIAL_SOURCE_OPTIONS.index(configured_material_label),
+                        key=f"{prefix}_material_source",
+                    )
+                else:
+                    settings["material_source"] = ""
                 if settings["video_source"] == "full_ia":
                     settings["style_ia"] = st.selectbox("Estilo IA", AI_STYLE_OPTIONS, key=f"{prefix}_style_ia")
                 else:
@@ -2037,6 +2050,7 @@ def _create_video_task_from_saved_script(record: dict[str, Any], channel: dict[s
         "format": settings.get("video_format", "wide"),
         "style_wide": style,
         "style_ia": settings.get("style_ia", ""),
+        "material_source": settings.get("material_source", "") if style == "pexels" else "",
         "music_mode": style == "music",
         "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"),
         "voice": str(settings.get("voice") or channel.get("default_voice") or channel.get("voice") or ""),
@@ -2266,6 +2280,12 @@ def render_new_video(page_title: str = "Criação de Vídeos", prefix: str = "ne
                     ),
                 )
             wide_style_label = generation_settings["video_source"]
+            style = {"Pexels/Pixabay": "pexels", "full_ia": "full_ia", "Apenas Música": "music"}[wide_style_label]
+            material_source = (
+                {"Pexels": "pexels", "Pixabay": "pixabay"}.get(str(generation_settings.get("material_source") or ""), "")
+                if style == "pexels"
+                else ""
+            )
             style_ia = generation_settings.get("style_ia", "")
             music_path = ""
             music_source = ""
@@ -2469,7 +2489,6 @@ def render_new_video(page_title: str = "Criação de Vídeos", prefix: str = "ne
                 submitted = st.form_submit_button("Criar tarefas", type="primary")
             if submitted:
                 save_video_language(language)
-                style = {"Pexels/Pixabay": "pexels", "full_ia": "full_ia", "Apenas Música": "music"}[wide_style_label]
                 if style == "music" and not music_path:
                     st.error("Escolha, carregue ou gere uma música antes de criar o vídeo Apenas Música.")
                     st.stop()
@@ -2517,8 +2536,8 @@ def render_new_video(page_title: str = "Criação de Vídeos", prefix: str = "ne
                             st.session_state[f"{prefix}_general_topics"] = {cid: {"topic": payload["topic"], "topic_source": payload.get("topic_source", "llm")} for cid, payload in payloads.items()}
                     if len(payloads) == len(selected):
                         batch_topic = "Lote geral — um vídeo independente por canal"
-                        channel_payloads = {cid: {**payload, "language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings} for cid, payload in payloads.items()}
-                        batch = create_batch("general", selected, batch_topic, 1, {"language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings, "topic_source": "llm", "channel_payloads": channel_payloads})
+                        channel_payloads = {cid: {**payload, "language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "material_source": material_source, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings} for cid, payload in payloads.items()}
+                        batch = create_batch("general", selected, batch_topic, 1, {"language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "material_source": material_source, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings, "topic_source": "llm", "channel_payloads": channel_payloads})
                         tasks = create_tasks_for_batch(batch)
                         st.success(f"Lote geral {batch['id']} criado com {len(tasks)} tarefas independentes, uma por canal.")
                 else:
@@ -2542,8 +2561,8 @@ def render_new_video(page_title: str = "Criação de Vídeos", prefix: str = "ne
                             except CreativeGenerationError as exc:
                                 st.warning(f"Título/keywords automáticos pendentes: {exc} A tarefa será criada com o tópico como título; o prompt e a imagem da thumbnail serão gerados depois do vídeo.")
                                 payload = {"topic": topic_value, "title": topic_value, "topic_source": "manual", "thumbnail_status": "pending_provider", "thumbnail_variants": [], "thumbnail_variant": {}, "thumbnail_prompt": "", "thumbnail_text": ""}
-                        payload.update({"topic": topic_value, "topic_source": payload.get("topic_source") or _video_topic_source(topic_value), "language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings})
-                        batch = create_batch(mode, selected, topic_value, quantity_value, {"language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings, "topic_source": payload.get("topic_source", "manual"), "channel_payloads": {selected[0]: payload}})
+                        payload.update({"topic": topic_value, "topic_source": payload.get("topic_source") or _video_topic_source(topic_value), "language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "material_source": material_source, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings})
+                        batch = create_batch(mode, selected, topic_value, quantity_value, {"language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "material_source": material_source, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings, "topic_source": payload.get("topic_source", "manual"), "channel_payloads": {selected[0]: payload}})
                         tasks = create_tasks_for_batch(batch)
                         st.success(f"Lote {batch['id']} criado com {len(tasks)} tarefa(s). Abra {ui_text('Backlog Vídeos', current_ui_language())} para acompanhar.")
 
@@ -5843,10 +5862,11 @@ def render_logs():
             "Registo": st.column_config.TextColumn("Registo", width=280),
             "Origem": st.column_config.TextColumn("Origem", width=130),
             "Progresso": st.column_config.TextColumn("Progresso", width=100),
+            "API/Provider": st.column_config.TextColumn("API/Provider", width=220),
             "Detalhes": st.column_config.TextColumn("Detalhes", width=760),
         },
     )
-    st.caption("Quando a tabela exceder a largura disponível, utilize a barra de rolagem horizontal na parte inferior para consultar todo o conteúdo das células.")
+    st.caption("A coluna API/Provider identifica a API responsável por cada falha; quando o registo é anterior a esta correcção, o sistema assinala que a API não pôde ser identificada. Quando a tabela exceder a largura disponível, utilize a barra de rolagem horizontal na parte inferior para consultar todo o conteúdo das células.")
 
 
 def render_notifications():

package/hermes_ui/automation_worker.py

@@ -10,6 +10,7 @@ from typing import Any
 from . import storage
 from .creative_generation import generate_title_and_keywords, generate_topic_for_channel
 from .domain import create_batch, create_tasks_for_batch
+from .material_sources import selected_material_source
 from .notifications import record_notification
 
 WORKER_STATE_FILE = "automation_worker.json"
@@ -156,6 +157,8 @@ def _creative_payload(channel: dict[str, Any]) -> tuple[str, dict[str, Any]]:
         blueprint,
         language=str(channel.get("language") or "Português"),
     )
+    style_wide = str(channel.get("style_wide") or "pexels").strip().casefold()
+    material_source = selected_material_source(settings) if style_wide in {"pexels", "pexels/pixabay", "stock"} else ""
     payload = {
         "topic": topic_package["topic"],
         "topic_source": "llm",
@@ -169,7 +172,8 @@ def _creative_payload(channel: dict[str, Any]) -> tuple[str, dict[str, Any]]:
         "blueprint_id": str(channel.get("default_blueprint_id") or channel.get("blueprint_id") or ""),
         "blueprint_name": str(blueprint.get("name") or "SEM BLUEPRINT CONFIGURADO"),
         "voice": str(channel.get("default_voice") or channel.get("voice") or ""),
-        "generation_settings": {"video_keywords": editorial.get("keywords", [])},
+        "material_source": material_source,
+        "generation_settings": {"video_keywords": editorial.get("keywords", []), "material_source": material_source},
         "ai_generation": {"topic": topic_package, "editorial": editorial},
     }
     return topic_package["topic"], payload
@@ -204,6 +208,7 @@ def _create_channel_batch(channel: dict[str, Any], when: datetime) -> dict[str,
         "format": "wide",
         "style_wide": style_wide,
         "style_ia": channel.get("style_ia") or "",
+        "material_source": payload.get("material_source") or "",
         "music_mode": music_mode,
         "background_mode": "none" if music_mode else ("ai" if style_wide == "full_ia" else "stock"),
         "music_path": channel.get("music_path") or "",

package/hermes_ui/domain.py

@@ -160,6 +160,7 @@ def create_tasks_for_batch(batch: dict[str, Any]) -> list[dict[str, Any]]:
                 "language": payload.get("language", options.get("language", channel.get("language", "Português"))),
                 "format": payload.get("format", options.get("format", "wide")),
                 "style_wide": payload.get("style_wide", options.get("style_wide", channel.get("style_wide", "pexels"))),
+                "material_source": payload.get("material_source", options.get("material_source", channel.get("material_source", ""))),
                 "style_ia": payload.get("style_ia", options.get("style_ia", "")),
                 "music_mode": payload.get("music_mode", options.get("music_mode", False)),
                 "music_path": payload.get("music_path", options.get("music_path", "")),
@@ -220,11 +221,22 @@ def _notify_task_completion(task: dict[str, Any], previous_state: str = "") -> N
     title = str(task.get("title") or task.get("topic") or "Actividade")
     channel = str(task.get("channel_name") or "Canal")
     if current_state == "failed":
+        failure_api = str(task.get("failure_api") or "API não identificada (falha anterior)").strip()
         record_notification(
             "activity_failed",
             f"Actividade falhou: {title}",
-            f"A actividade de {channel} terminou com erro.",
-            metadata={"task_id": task_id, "channel_name": channel, "error": task.get("error") or ""},
+            f"A actividade de {channel} terminou com erro. API/provider: {failure_api}.",
+            metadata={
+                "task_id": task_id,
+                "channel_name": channel,
+                "error": task.get("error") or "",
+                "failure_api": task.get("failure_api") or "API não identificada (falha anterior)",
+                "failure_provider": task.get("failure_provider") or "unknown",
+                "failure_service": task.get("failure_service") or "Thunderbolt",
+                "failure_route": task.get("failure_route") or "",
+                "failure_config_fields": task.get("failure_config_fields") or "",
+                "failure_stage": task.get("failure_stage") or task.get("failed_stage") or task.get("stage") or "pipeline",
+            },
             dedupe_key=f"task:{task_id}:failed",
         )
         return

package/hermes_ui/logs.py

@@ -76,6 +76,29 @@ def _operation_label(operation_code: str, fallback: str = "Operação") -> str:
     return str(event.get("label") if event else fallback or operation_code or "Operação")
 
 
+def _fallback_task_failure_api(task: dict[str, Any]) -> str:
+    """Infer a safe API label for legacy failed tasks without structured metadata."""
+    route = str(task.get("material_source") or task.get("style_wide") or "").strip().casefold()
+    if "pexels" in route and "pixabay" in route:
+        return "Pexels/Pixabay API (fonte efectiva não registada)"
+    if "pixabay" in route:
+        return "Pixabay API"
+    if "pexels" in route or "stock" in route:
+        return "Pexels/Pixabay API (fonte efectiva não registada)"
+    if route in {"full_ia", "full ia", "ia"}:
+        return "FAL AI / KIE AI / Agnes AI"
+    if route in {"music", "musica", "música"} or bool(task.get("music_mode")):
+        return "Suno / Ficheiro local"
+    stage = str(task.get("stage") or task.get("failed_stage") or "").strip().casefold()
+    if stage in {"topic", "script", "title", "keywords", "thumbnail_prompt"}:
+        return "LLM textual API (provider não registado)"
+    if stage == "thumbnail":
+        return "Pool de imagem API (provider não registado)"
+    if stage == "upload":
+        return "YouTube Upload API"
+    return "API não identificada (falha anterior)"
+
+
 def _task_log(task: dict[str, Any]) -> dict[str, Any] | None:
     task_id = str(task.get("id") or "").strip()
     if not task_id:
@@ -100,6 +123,20 @@ def _task_log(task: dict[str, Any]) -> dict[str, Any] | None:
     if progress_value is not None:
         details.append(f"Progresso: {progress_value}%")
     error = str(task.get("error") or "").strip()
+    failure_api = str(task.get("failure_api") or "").strip()
+    failure_provider = str(task.get("failure_provider") or "").strip()
+    failure_service = str(task.get("failure_service") or "").strip()
+    failure_fields = str(task.get("failure_config_fields") or "").strip()
+    api_provider = failure_api
+    if state in {"failed", "error"}:
+        api_provider = api_provider or _fallback_task_failure_api(task)
+        details.append(f"API/provider: {api_provider}")
+        if failure_provider:
+            details.append(f"Provider: {failure_provider}")
+        if failure_service:
+            details.append(f"Serviço: {failure_service}")
+        if failure_fields:
+            details.append(f"Configuração: {failure_fields}")
     if error:
         details.append(error[:500])
     return {
@@ -114,6 +151,7 @@ def _task_log(task: dict[str, Any]) -> dict[str, Any] | None:
         "source": "Tarefas",
         "record": title,
         "details": " · ".join(details),
+        "api_provider": api_provider or "",
         "progress": progress_value,
         "task_id": task_id,
     }
@@ -141,6 +179,9 @@ def _notification_log(entry: dict[str, Any]) -> dict[str, Any] | None:
     date, time = format_log_date_time(occurred_at)
     metadata = entry.get("metadata") if isinstance(entry.get("metadata"), dict) else {}
     public_metadata = [f"{key}: {value}" for key, value in metadata.items() if value not in (None, "")]
+    api_provider = str(metadata.get("failure_api") or metadata.get("api_provider") or "").strip()
+    if status_code in {"failed", "error"}:
+        api_provider = api_provider or "API não identificada (falha anterior)"
     return {
         "id": f"notification:{entry_id}",
         "operation_code": event_type,
@@ -153,6 +194,7 @@ def _notification_log(entry: dict[str, Any]) -> dict[str, Any] | None:
         "source": "Notificações",
         "record": str(entry.get("title") or entry.get("label") or "Notificação"),
         "details": " · ".join([str(entry.get("message") or "").strip(), *public_metadata]).strip(" ·")[:1000],
+        "api_provider": api_provider,
         "progress": None,
         "task_id": str(metadata.get("task_id") or ""),
     }
@@ -227,6 +269,7 @@ def logs_to_rows(records: list[dict[str, Any]]) -> list[dict[str, Any]]:
             "Registo": item.get("record") or "—",
             "Origem": item.get("source") or "—",
             "Progresso": f"{item['progress']}%" if item.get("progress") is not None else "—",
+            "API/Provider": item.get("api_provider") or "—",
             "Detalhes": item.get("details") or "—",
         }
         for item in records

package/hermes_ui/media_generation.py

@@ -489,9 +489,13 @@ def generate_video_from_pool(
     *,
     image_url: str = "",
     output_path: Path | None = None,
+    allowed_providers: set[str] | None = None,
 ) -> Path:
-    """Try eligible video cards in priority order, keeping image and video pools separate."""
+    """Try eligible video cards in priority order, optionally restricted to a route."""
     cards = media_cards_for_pool(settings, "video")
+    if allowed_providers is not None:
+        allowed = {str(provider).strip().lower() for provider in allowed_providers}
+        cards = [card for card in cards if str(card.get("provider") or "").strip().lower() in allowed]
     if not cards:
         raise MediaGenerationError("Não existem providers activos no pool de vídeo.")
     errors: list[str] = []

package/hermes_ui/notifications.py

@@ -236,7 +236,24 @@ def _task_notifications() -> int:
         title = str(task.get("title") or task.get("topic") or "Actividade")
         channel = str(task.get("channel_name") or "Canal")
         if state == "failed":
-            if record_notification("activity_failed", f"Actividade falhou: {title}", f"A actividade de {channel} terminou com erro.", metadata={"task_id": task_id, "channel_name": channel}, dedupe_key=f"task:{task_id}:failed"):
+            failure_api = str(task.get("failure_api") or "API não identificada (falha anterior)").strip()
+            if record_notification(
+                "activity_failed",
+                f"Actividade falhou: {title}",
+                f"A actividade de {channel} terminou com erro. API/provider: {failure_api}.",
+                metadata={
+                    "task_id": task_id,
+                    "channel_name": channel,
+                    "error": task.get("error") or "",
+                    "failure_api": task.get("failure_api") or "API não identificada (falha anterior)",
+                    "failure_provider": task.get("failure_provider") or "unknown",
+                    "failure_service": task.get("failure_service") or "Thunderbolt",
+                    "failure_route": task.get("failure_route") or "",
+                    "failure_config_fields": task.get("failure_config_fields") or "",
+                    "failure_stage": task.get("failure_stage") or task.get("failed_stage") or task.get("stage") or "pipeline",
+                },
+                dedupe_key=f"task:{task_id}:failed",
+            ):
                 created += 1
             continue
         if state != "done":