@danhachuel/thunderbolt 0.5.85 → 0.5.87

package/README.md

@@ -141,7 +141,7 @@ A correcção da integração Nano Banana remove o campo de entrega `inline` rej
 
 A página **AI Influencers > Tutorial Meta** apresenta o guia de configuração de uma conta Instagram profissional e das credenciais Meta para automações com n8n, distribuído localmente em `seed/references/guide-instagram.md` e com ligação para a [fonte original no GitHub](https://github.com/gyoridavid/ai_agents_az/blob/main/episode_8/guide-instagram.md). A página **Configurações > Notificações** mantém um histórico persistente de conclusões e falhas, reconcilia estados escritos por componentes locais e disponibiliza um checkbox independente para cada operação mapeada. A subaba **Geral** mantém esse centro local; a subaba **Telegram** permite configurar Bot Token, Chat ID e proxy opcional e envia as mesmas notificações pela Bot API oficial, sem polling ou mensagens recebidas. As notificações novas também aparecem automaticamente como pop-ups no canto inferior direito enquanto o utilizador está noutra página, sem precisar de abrir Notificações; cada aviso é mostrado uma vez por sessão e o histórico continua a controlar o estado de leitura. A página **Configurações > Logs**, colocada imediatamente abaixo de Notificações e acima de Configuração API, apresenta o histórico unificado de tarefas e notificações, com filtro livre por operação, filtros adicionais por operação e estado, e as colunas Operação, Estado, Data, Hora, Registo, Origem, Progresso e Detalhes. A tabela mantém uma barra vertical e, quando a soma das colunas excede a largura disponível, disponibiliza também uma barra de rolagem horizontal na parte inferior para consultar integralmente células longas, sobretudo em **Detalhes**.
 
-A página **Edição > Download Mídia** utiliza a API Python do [yt-dlp](https://github.com/yt-dlp/yt-dlp) para descarregar vídeos e áudio de URLs públicas, com qualidade, contentor, formato de áudio, legendas, metadados, playlists, progresso e histórico local em `storage/downloads/` e `storage/state/media_downloads.json`. Conversão e combinação de streams podem exigir FFmpeg.
+A página **Edição > Download Mídia** utiliza a API Python do [yt-dlp](https://github.com/yt-dlp/yt-dlp) para descarregar vídeos e áudio de URLs públicas, com qualidade, contentor, formato de áudio, legendas, metadados, playlists, progresso e histórico local em `storage/downloads/` e `storage/state/media_downloads.json`. O Thunderbolt instala o pacote Python **Deno** e resolve automaticamente o executável gerido por ele, passando-o ao yt-dlp como runtime `deno:<caminho>`. O pacote `yt-dlp[default]` inclui também os scripts EJS necessários para os desafios JavaScript do YouTube. Se existir um Deno instalado no `PATH`, ele é usado como fallback. Conversão e combinação de streams podem exigir FFmpeg.
 
 ## Catálogo comum do Backlog e da Automação
 

package/hermes_ui/media_downloader.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import hashlib
 import re
+import shutil
 import uuid
 from datetime import datetime, timezone
 from pathlib import Path
@@ -43,6 +44,22 @@ def _download_root() -> Path:
     return storage.MEDIA_DOWNLOADS.resolve()
 
 
+def _deno_runtime_path() -> str | None:
+    """Resolve the project-managed Deno binary, with a PATH fallback."""
+    try:
+        import deno  # type: ignore
+
+        finder = getattr(deno, "find_deno_bin", None)
+        if callable(finder):
+            candidate = Path(str(finder())).expanduser()
+            if candidate.is_file():
+                return str(candidate.resolve())
+    except (ImportError, OSError, RuntimeError, TypeError, ValueError):
+        pass
+    candidate = shutil.which("deno")
+    return str(Path(candidate).resolve()) if candidate else None
+
+
 def _safe_download_path(value: str | Path) -> Path | None:
     root = _download_root()
     candidate = Path(value)
@@ -136,6 +153,10 @@ def build_download_options(
         "overwrites": False,
         "paths": {"home": str(root)},
     }
+    deno_path = _deno_runtime_path()
+    if deno_path:
+        # Equivalent to the CLI argument --js-runtimes deno:<path>.
+        options["js_runtimes"] = {"deno": deno_path}
     if progress_hook is not None:
         options["progress_hooks"] = [progress_hook]
     if normalized_mode == "audio":
@@ -183,7 +204,13 @@ def media_download_file(record: dict[str, Any], filename: str) -> Path | None:
 
 
 def dependency_status() -> dict[str, Any]:
-    return {"yt_dlp": yt_dlp is not None, "ffmpeg_note": "A conversão/combinação de streams pode exigir FFmpeg."}
+    deno_path = _deno_runtime_path()
+    return {
+        "yt_dlp": yt_dlp is not None,
+        "deno": bool(deno_path),
+        "deno_path": deno_path or "",
+        "ffmpeg_note": "A conversão/combinação de streams pode exigir FFmpeg.",
+    }
 
 
 def _files_from_info(info: Any, started_at: float) -> list[Path]:

package/integrations/youtube_session_manager.py

@@ -14,6 +14,8 @@ import os
 import re
 import shutil
 import signal
+import subprocess
+import sys
 import time
 from contextlib import contextmanager
 from dataclasses import dataclass
@@ -52,6 +54,70 @@ DESCRIPTION_SELECTORS = [
 ]
 BLOCKED_TEXT = ("verify", "verificação", "verification", "captcha", "confirme que você é humano", "confirm it's you", "confirme que é você")
 
+
+class _BrowserUnavailableError(RuntimeError):
+    """Raised when Playwright cannot find or prepare a usable browser."""
+
+
+def _looks_like_missing_playwright_browser(error: BaseException) -> bool:
+    message = str(error).lower()
+    return "executable doesn't exist" in message or "executable does not exist" in message or "playwright was just installed" in message
+
+
+def _install_playwright_chromium() -> bool:
+    """Install the bundled Chromium once when Playwright reports it missing."""
+    try:
+        result = subprocess.run(
+            [os.fspath(sys.executable), "-m", "playwright", "install", "chromium"],
+            check=False,
+            capture_output=True,
+            text=True,
+            timeout=300,
+        )
+    except (OSError, subprocess.SubprocessError) as exc:
+        logger.warning("Não foi possível preparar o Chromium do Playwright: %s", _safe_error(exc))
+        return False
+    if result.returncode != 0:
+        detail = (result.stderr or result.stdout or "").strip().splitlines()
+        logger.warning("A instalação automática do Chromium falhou: %s", detail[-1] if detail else "erro desconhecido")
+        return False
+    return True
+
+
+def _launch_playwright_browser(playwright: Any) -> Any:
+    """Launch the configured browser, recovering from a missing Playwright binary."""
+    configured_path = str(os.environ.get("THUNDERBOLT_CHROME_PATH") or "").strip()
+    launch_kwargs: dict[str, Any] = {"headless": True}
+    if configured_path:
+        if not Path(configured_path).is_file():
+            raise _BrowserUnavailableError(f"Executável Chrome/Chromium não encontrado: {configured_path}")
+        launch_kwargs["executable_path"] = configured_path
+
+    try:
+        return playwright.chromium.launch(**launch_kwargs)
+    except Exception as initial_error:
+        if configured_path or not _looks_like_missing_playwright_browser(initial_error):
+            raise
+
+        # Prefer an already installed Google Chrome before downloading another
+        # browser. This is particularly useful on Windows machines where the
+        # Playwright cache was removed but Chrome itself is still available.
+        try:
+            return playwright.chromium.launch(headless=True, channel="chrome")
+        except Exception as chrome_error:
+            if not _looks_like_missing_playwright_browser(initial_error):
+                raise initial_error
+            if not _install_playwright_chromium():
+                raise _BrowserUnavailableError(
+                    "O Chromium do Playwright não está instalado e não foi possível prepará-lo automaticamente."
+                ) from chrome_error
+            try:
+                return playwright.chromium.launch(headless=True)
+            except Exception as retry_error:
+                raise _BrowserUnavailableError(
+                    "O Chromium do Playwright continua indisponível depois da instalação automática."
+                ) from retry_error
+
 try:
     from yt_cm import YouTubeCookieManager  # type: ignore
     YT_CM_AVAILABLE = True
@@ -203,7 +269,11 @@ def _capture_with_playwright(document: dict[str, Any], *, logs_dir: Path, video_
     logs_dir.mkdir(parents=True, exist_ok=True)
     cookies = [{"name": key, "value": str(document["cookies"][key]), "domain": ".youtube.com", "path": "/"} for key in COOKIE_KEYS if document.get("cookies", {}).get(key)]
     with sync_playwright() as playwright:
-        browser = playwright.chromium.launch(headless=True)
+        try:
+            browser = _launch_playwright_browser(playwright)
+        except _BrowserUnavailableError as exc:
+            logger.error("Browser Playwright indisponível: %s", _safe_error(exc))
+            return "browser_unavailable", None
         context = browser.new_context()
         context.add_cookies(cookies)
         page = context.new_page()
@@ -298,6 +368,14 @@ def renew_account_session(storage_root: Path, account: dict[str, Any], settings:
                 return RenewalResult(False, "cookie_renewal_failed", f"Falha na renovação de cookies: {_safe_error(exc)}", account_id)
             for attempt in range(1, MAX_CAPTURE_ATTEMPTS + 1):
                 capture_status, token = _capture_with_playwright(document, logs_dir=logs_dir, video_id=str(account.get("video_id") or ""))
+                if capture_status == "browser_unavailable":
+                    return RenewalResult(
+                        False,
+                        "browser_unavailable",
+                        "Renovação falhou: o Chromium do Playwright não está disponível. Execute novamente a instalação do Thunderbolt e tente renovar outra vez.",
+                        account_id,
+                        attempt,
+                    )
                 if capture_status == "blocked_by_google":
                     _write_renewal_state(directory, "blocked_by_google")
                     return RenewalResult(False, "blocked_by_google", "🔒 Sessão bloqueada pelo Google. Renovação manual necessária.", account_id, attempt)

package/package.json

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

package/requirements.txt

@@ -15,7 +15,8 @@ scikit-learn>=1.3,<2
 mlxtend>=0.23,<1
 plotly>=5.18,<7
 seaborn>=0.13,<1
-yt-dlp>=2025.1.15,<2027
+yt-dlp[default]>=2025.1.15,<2027
+deno>=2.3,<3
 youtube-transcript-api>=1.2.0,<2
 ytmusicapi>=1.12,<2
 pushtunes>=2.15,<3

package/scripts/cli.mjs

@@ -135,7 +135,7 @@ function check() {
     console.error(`Python não encontrado. Execute: npx.cmd --yes @danhachuel/thunderbolt install`);
     process.exit(1);
   }
-  const requiredModules = ["streamlit", "requests", "pandas", "toml", "imageio_ffmpeg", "edge_tts", "sklearn", "mlxtend", "plotly", "seaborn", "kagglehub", "composio"];
+  const requiredModules = ["streamlit", "requests", "pandas", "toml", "imageio_ffmpeg", "edge_tts", "sklearn", "mlxtend", "plotly", "seaborn", "kagglehub", "composio", "playwright"];
   const missing = requiredModules.filter((moduleName) => !moduleAvailable(moduleName));
   const ffmpeg = moduleAvailable("imageio_ffmpeg");
   const mptPath = configuredMoneyPrinterPath();

package/scripts/install.mjs

@@ -452,6 +452,17 @@ function installRequirementIfNeeded(requirementsPath, stateKey, modules, label)
   writeDependencyState({ [stateKey]: currentHash });
 }
 
+function installPlaywrightBrowsers() {
+  if (!existsSync(pythonBin)) return;
+  console.log("Playwright: a verificar o browser Chromium... ");
+  const result = spawnSync(pythonBin, ["-m", "playwright", "install", "chromium"], { stdio: "inherit", env: pythonEnvironment });
+  if (result.status !== 0) {
+    console.error("Não foi possível instalar o browser Chromium do Playwright.");
+    console.error("Execute novamente o instalador depois de confirmar o acesso à Internet.");
+    process.exit(result.status || 1);
+  }
+}
+
 function writeSettings(moneyprinterPath) {
   const stateDir = join(thunderboltHome, "storage", "state");
   mkdirSync(stateDir, { recursive: true });
@@ -470,7 +481,8 @@ function writeSettings(moneyprinterPath) {
 
 function installThunderboltDependencies(python) {
   if (!existsSync(pythonBin)) run(python.command, [...python.args, "-m", "venv", venvPath]);
-  installRequirementIfNeeded(join(root, "requirements.txt"), "thunderbolt_requirements_sha256", ["streamlit", "requests", "pandas", "toml", "imageio_ffmpeg", "edge_tts", "google.auth", "google_auth_oauthlib", "googleapiclient", "yt_dlp", "youtube_transcript_api", "huggingface_hub"], "Thunderbolt");
+  installRequirementIfNeeded(join(root, "requirements.txt"), "thunderbolt_requirements_sha256", ["streamlit", "requests", "pandas", "toml", "imageio_ffmpeg", "edge_tts", "google.auth", "google_auth_oauthlib", "googleapiclient", "yt_dlp", "deno", "youtube_transcript_api", "huggingface_hub", "playwright"], "Thunderbolt");
+  installPlaywrightBrowsers();
 }
 
 function installMoneyPrinterDependencies(moneyprinterPath) {