@danhachuel/thunderbolt 0.7.48 → 0.7.50

package/app/main.py

@@ -6424,7 +6424,6 @@ def _render_facebook_automation_cards() -> None:
 def render_facebook_automation() -> None:
     st.title("Automação Facebook")
     st.caption("Fluxo local de posts: Ideia/Tema → LLM → Artigo → Google Imagens ou IA → textos e legendas → Upload pela Meta Graph API.")
-    st.info("Esta página não usa planilhas nem Google Drive. Os artigos, imagens, legendas e estados ficam no armazenamento local do Thunderbolt.")
     pages = _facebook_pages_for_automation()
     settings = read_json("settings.json", {})
     if not pages:

package/hermes_ui/media_generation.py

@@ -324,11 +324,17 @@ def _image_endpoint(card: Mapping[str, Any]) -> str:
     raise MediaGenerationError(f"O provider {card.get('provider')} não tem endpoint de imagem configurado.")
 
 
-def _thumbnail_aspect_ratio(thumbnail_blueprint: Mapping[str, Any] | None, prompt: str = "") -> str:
+def _thumbnail_aspect_ratio(
+    thumbnail_blueprint: Mapping[str, Any] | None,
+    prompt: str = "",
+    explicit_aspect_ratio: str = "",
+) -> str:
+    if explicit_aspect_ratio in {"16:9", "9:16"}:
+        return explicit_aspect_ratio
     return infer_thumbnail_aspect_ratio(prompt, dict(thumbnail_blueprint or {}))
 
 
-def _image_request(card: dict[str, Any], prompt: str, *, topic: str = "", lettering_text: str = "", lettering_prompt: str = "", thumbnail_blueprint: Mapping[str, Any] | None = None) -> Any:
+def _image_request(card: dict[str, Any], prompt: str, *, topic: str = "", lettering_text: str = "", lettering_prompt: str = "", thumbnail_blueprint: Mapping[str, Any] | None = None, aspect_ratio: str = "") -> Any:
     provider = str(card.get("provider") or "").strip().lower()
     style = str(card.get("api_style") or media_provider_definition(provider).api_style)
     endpoint = _image_endpoint(card)
@@ -338,12 +344,12 @@ def _image_request(card: dict[str, Any], prompt: str, *, topic: str = "", letter
         lettering_text=lettering_text,
         lettering_prompt=lettering_prompt,
     )
-    aspect_ratio = _thumbnail_aspect_ratio(thumbnail_blueprint, prompt)
-    requested_size = ("1024x1792" if aspect_ratio == "9:16" else "1792x1024") if provider == "pollinations" else ("720x1280 minimum" if aspect_ratio == "9:16" else "1280x720 minimum")
+    resolved_aspect_ratio = _thumbnail_aspect_ratio(thumbnail_blueprint, prompt, aspect_ratio)
+    requested_size = ("1024x1792" if resolved_aspect_ratio == "9:16" else "1792x1024") if provider == "pollinations" else ("720x1280 minimum" if resolved_aspect_ratio == "9:16" else "1280x720 minimum")
     constrained_prompt = _append_generation_constraints(
         image_prompt,
         kind="image",
-        aspect_ratio=aspect_ratio,
+        aspect_ratio=resolved_aspect_ratio,
         size=requested_size,
     )
     constrained_prompt = _fit_provider_prompt(constrained_prompt, provider)
@@ -360,7 +366,7 @@ def _image_request(card: dict[str, Any], prompt: str, *, topic: str = "", letter
     if style == "kie":
         body = {
             "model": _model(card),
-            "input": {"prompt": constrained_prompt, "aspect_ratio": aspect_ratio, "resolution": "1K"},
+            "input": {"prompt": constrained_prompt, "aspect_ratio": resolved_aspect_ratio, "resolution": "1K"},
         }
         return requests.post(endpoint, headers=_headers(card), json=body, timeout=180)
     if provider == "agnes":
@@ -368,7 +374,7 @@ def _image_request(card: dict[str, Any], prompt: str, *, topic: str = "", letter
             "model": _model(card) or AGNES_IMAGE_MODEL,
             "prompt": constrained_prompt,
             "size": "1K",
-            "ratio": aspect_ratio,
+            "ratio": resolved_aspect_ratio,
             "return_base64": True,
             "extra_body": {"response_format": "b64_json"},
         }
@@ -377,12 +383,12 @@ def _image_request(card: dict[str, Any], prompt: str, *, topic: str = "", letter
         return requests.post(
             endpoint,
             headers=_headers(card),
-            json={"model": _model(card), "prompt": constrained_prompt, "n": 1, "aspect_ratio": aspect_ratio},
+            json={"model": _model(card), "prompt": constrained_prompt, "n": 1, "aspect_ratio": resolved_aspect_ratio},
             timeout=180,
         )
     body = {"model": _model(card), "prompt": constrained_prompt, "n": 1, "response_format": "b64_json"}
     if provider == "pollinations":
-        body["size"] = "1024x1792" if aspect_ratio == "9:16" else "1792x1024"
+        body["size"] = "1024x1792" if resolved_aspect_ratio == "9:16" else "1792x1024"
     return requests.post(endpoint, headers=_headers(card), json=body, timeout=180)
 
 
@@ -397,6 +403,7 @@ def generate_image_for_card(
     lettering_prompt: str = "",
     reference_image: Path | None = None,
     thumbnail_blueprint: Mapping[str, Any] | None = None,
+    aspect_ratio: str = "",
 ) -> Path:
     """Generate one image with the selected media card."""
     card = _hydrate_media_card(settings, card)
@@ -439,7 +446,7 @@ def generate_image_for_card(
             )
         except Exception as exc:
             raise MediaGenerationError(str(exc)) from exc
-    aspect_ratio = _thumbnail_aspect_ratio(thumbnail_blueprint, prompt)
+    aspect_ratio = _thumbnail_aspect_ratio(thumbnail_blueprint, prompt, aspect_ratio)
     if provider == "nano_banana":
         merged = dict(settings)
         merged["gemini_image_api_key"] = _api_key(card)
@@ -498,7 +505,7 @@ def generate_image_for_card(
             raise MediaGenerationError(f"Hugging Face text-to-image falhou: {str(exc)[:240]}") from exc
 
     def request(current: dict[str, Any]) -> Any:
-        return _image_request(current, prompt, topic=topic, lettering_text=lettering_text, lettering_prompt=lettering_prompt, thumbnail_blueprint=thumbnail_blueprint)
+        return _image_request(current, prompt, topic=topic, lettering_text=lettering_text, lettering_prompt=lettering_prompt, thumbnail_blueprint=thumbnail_blueprint, aspect_ratio=aspect_ratio)
 
     try:
         routed = route_json_request(settings, pool=POOL_IMAGE, cards=[card], request=request)
@@ -542,6 +549,7 @@ def generate_image_from_pool(
     reference_image: Path | None = None,
     thumbnail_only: bool = False,
     thumbnail_blueprint: Mapping[str, Any] | None = None,
+    aspect_ratio: str = "",
 ) -> Path:
     """Try eligible image cards in priority order, without cross-pool fallback."""
     cards = media_cards_for_pool(settings, "image", thumbnail_only=True) if thumbnail_only else media_cards_for_pool(settings, "image")
@@ -560,6 +568,7 @@ def generate_image_from_pool(
                 lettering_prompt=lettering_prompt,
                 reference_image=reference_image,
                 thumbnail_blueprint=thumbnail_blueprint,
+                aspect_ratio=aspect_ratio,
             )
         except MediaGenerationError as exc:
             errors.append(f"{card.get('provider')}: {str(exc)[:180]}")

package/hermes_ui/pipeline_worker.py

@@ -33,7 +33,7 @@ from hermes_ui.media_generation import MediaGenerationError, _append_generation_
 from hermes_ui.media_providers import FULL_IA_VIDEO_PROVIDER_CODES, media_cards_for_pool, media_provider_definition
 from hermes_ui.material_sources import material_api_keys, material_source_cards, selected_material_source
 from hermes_ui.thumbnail_generation import ThumbnailGenerationError, generate_thumbnail_image, infer_thumbnail_aspect_ratio
-from hermes_ui.thumbnail_blueprints import thumbnail_blueprint_for_channel
+from hermes_ui.thumbnail_blueprints import thumbnail_aspect_ratio_for_channel_task, thumbnail_blueprint_for_channel
 from hermes_ui.voice_preview import synthesize_preview
 
 PIPELINE_LOCK_FILENAME = "pipeline_worker.lock"
@@ -86,6 +86,7 @@ def _generate_pipeline_thumbnail(
     lettering_text: str = "",
     lettering_prompt: str = "",
     thumbnail_blueprint: dict[str, Any] | None = None,
+    aspect_ratio: str = "",
 ) -> Path:
     """Use the image pool while keeping the legacy single-Nano call seam."""
     cards = media_cards_for_pool(settings, "image")
@@ -97,7 +98,7 @@ def _generate_pipeline_thumbnail(
             variant_index=variant_index,
             lettering_text=lettering_text,
             lettering_prompt=lettering_prompt,
-            aspect_ratio=infer_thumbnail_aspect_ratio(prompt, thumbnail_blueprint),
+            aspect_ratio=aspect_ratio or infer_thumbnail_aspect_ratio(prompt, thumbnail_blueprint),
         )
     return generate_image_from_pool(
         settings,
@@ -107,6 +108,7 @@ def _generate_pipeline_thumbnail(
         lettering_text=lettering_text,
         lettering_prompt=lettering_prompt,
         thumbnail_blueprint=thumbnail_blueprint,
+        aspect_ratio=aspect_ratio,
     )
 
 
@@ -1356,6 +1358,7 @@ def _run_task(task: dict[str, Any]) -> dict[str, Any]:
         blueprint = {"id": str(task.get("blueprint_id") or ""), "name": str(task.get("blueprint_name") or task.get("blueprint_id") or "")}
     visual_format = task.get("format") or ("portrait" if str(task.get("platform") or "").casefold() in {"tiktok", "instagram"} else "wide")
     visual_blueprint = thumbnail_blueprint_for_channel(channel, visual_format)
+    thumbnail_aspect_ratio = thumbnail_aspect_ratio_for_channel_task(channel, task, visual_blueprint)
     if visual_blueprint.get("content"):
         blueprint = {**blueprint, "thumbnail_blueprint_rules": visual_blueprint["content"]}
     route = _normalise_video_route(task, settings)
@@ -1549,8 +1552,8 @@ def _run_task(task: dict[str, Any]) -> dict[str, Any]:
         "keywords": keywords,
         "thumbnail": variant,
         "requirements": {
-            "aspect_ratio": "16:9",
-            "resolution": "1920x1080",
+            "aspect_ratio": thumbnail_aspect_ratio,
+            "resolution": "1024x1792" if thumbnail_aspect_ratio == "9:16" else "1792x1024",
             "max_elements": 3,
             "max_overlay_words": 4,
             "lettering_required": True,
@@ -1589,6 +1592,7 @@ def _run_task(task: dict[str, Any]) -> dict[str, Any]:
                 lettering_text=str(variant.get("overlay_text") or ""),
                 lettering_prompt=str(variant.get("lettering_prompt") or ""),
                 thumbnail_blueprint=blueprint,
+                aspect_ratio=thumbnail_aspect_ratio,
             )
         except (MediaGenerationError, ThumbnailGenerationError) as exc:
             raise PipelineError(f"A thumbnail não foi gerada; o vídeo já está disponível em {video_path}: {exc}") from exc

package/hermes_ui/thumbnail_blueprints.py

@@ -89,6 +89,47 @@ def thumbnail_blueprint_for_task(channel: Mapping[str, Any], task: Mapping[str,
     return thumbnail_blueprint_for_channel({**channel, "thumbnail_blueprint_id": ""}, format_value)
 
 
+def thumbnail_aspect_ratio_for_channel_task(
+    channel: Mapping[str, Any] | None,
+    task: Mapping[str, Any] | None = None,
+    blueprint: Mapping[str, Any] | None = None,
+) -> str:
+    """Resolve thumbnail orientation consistently for new and persisted tasks.
+
+    A channel-specific blueprint remains authoritative. When no specific blueprint
+    exists, platform defaults are used: TikTok/Instagram are portrait and YouTube
+    is landscape. This deliberately ignores stale generic blueprint ids persisted
+    on older YouTube tasks.
+    """
+    channel = channel or {}
+    task = task or {}
+    selected = dict(blueprint or {})
+    direct = str(
+        channel.get("default_thumbnail_blueprint_id")
+        or channel.get("thumbnail_blueprint_id")
+        or task.get("thumbnail_blueprint_id")
+        or ""
+    ).strip()
+    generic_ids = {
+        "Generic_Thumbnail_Blueprint",
+        HORIZONTAL_GENERIC_THUMBNAIL_BLUEPRINT_ID,
+        VERTICAL_GENERIC_THUMBNAIL_BLUEPRINT_ID,
+    }
+    if not selected and direct and direct not in generic_ids:
+        selected = resolve_thumbnail_blueprint(direct)
+    if selected.get("content") and direct not in generic_ids:
+        return "9:16" if _contains_vertical_rules(selected.get("content")) else "16:9"
+
+    platform = str(channel.get("platform") or task.get("platform") or "").strip().casefold()
+    if platform in {"tiktok", "instagram", "instagram reels"}:
+        return "9:16"
+    return "16:9"
+
+
+def _contains_vertical_rules(value: Any) -> bool:
+    return bool(re.search(r"\b9\s*:\s*16\b|\bvertical\b|\bportrait\b", str(value or ""), flags=re.IGNORECASE))
+
+
 def thumbnail_blueprint_for_blueprint(blueprint_id: Any, format_value: Any = "") -> dict[str, Any]:
     """Resolve the visual pair for a script Blueprint, falling back to Generic."""
     paired_id = _pair_state().get(str(blueprint_id or "").strip(), "")

package/hermes_ui/thumbnail_generation.py

@@ -190,7 +190,7 @@ def generate_thumbnail_image(
     reference_image: str | Path | None = None,
     lettering_text: str = "",
     lettering_prompt: str = "",
-    aspect_ratio: str = DEFAULT_ASPECT_RATIO,
+    aspect_ratio: str | None = None,
 ) -> Path:
     api_key = str(settings.get("gemini_image_api_key") or "").strip()
     if not api_key:
@@ -204,7 +204,7 @@ def generate_thumbnail_image(
         lettering_text=lettering_text,
         lettering_prompt=lettering_prompt,
     )
-    effective_aspect_ratio = infer_thumbnail_aspect_ratio(clean_prompt, fallback=aspect_ratio)
+    effective_aspect_ratio = aspect_ratio if aspect_ratio in {"16:9", "9:16"} else infer_thumbnail_aspect_ratio(clean_prompt)
 
     model = str(settings.get("gemini_image_model") or DEFAULT_GEMINI_IMAGE_MODEL).strip()
     image_size = DEFAULT_IMAGE_SIZE

package/hermes_ui/thumbnails.py

@@ -12,7 +12,7 @@ from .media_generation import generate_image_from_pool
 from .media_providers import media_cards_for_pool
 from .storage import STORAGE, ensure_storage, now, read_json, update_json, write_json
 from .thumbnail_generation import ThumbnailGenerationError, generate_thumbnail_image, infer_thumbnail_aspect_ratio
-from .thumbnail_blueprints import thumbnail_blueprint_for_task
+from .thumbnail_blueprints import thumbnail_aspect_ratio_for_channel_task, thumbnail_blueprint_for_task
 
 
 def _generate_image_with_pool(
@@ -25,6 +25,7 @@ def _generate_image_with_pool(
     lettering_prompt: str = "",
     reference_image: Path | None = None,
     thumbnail_blueprint: dict[str, Any] | None = None,
+    aspect_ratio: str = "",
 ) -> Path:
     """Use the legacy Nano adapter when it is the only active image card.
 
@@ -41,7 +42,7 @@ def _generate_image_with_pool(
             reference_image=reference_image,
             lettering_text=lettering_text,
             lettering_prompt=lettering_prompt,
-            aspect_ratio=infer_thumbnail_aspect_ratio(prompt, thumbnail_blueprint),
+            aspect_ratio=aspect_ratio or infer_thumbnail_aspect_ratio(prompt, thumbnail_blueprint),
         )
     return generate_image_from_pool(
         settings,
@@ -53,6 +54,7 @@ def _generate_image_with_pool(
         lettering_prompt=lettering_prompt,
         thumbnail_only=True,
         thumbnail_blueprint=thumbnail_blueprint,
+        aspect_ratio=aspect_ratio,
     )
 
 
@@ -271,6 +273,7 @@ def generate_thumbnail_for_task(
         and bool(item.get("enabled", True))
         for item in configured_cards
     ) if isinstance(configured_cards, list) else False
+    channel = {}
     if not effective_blueprint:
         channels = read_json("channels.json", [])
         channel = next(
@@ -278,6 +281,7 @@ def generate_thumbnail_for_task(
             {},
         ) if isinstance(channels, list) else {}
         effective_blueprint = thumbnail_blueprint_for_task(channel, task)
+    aspect_ratio = thumbnail_aspect_ratio_for_channel_task(channel, task, effective_blueprint)
     rules = str(effective_blueprint.get("content") or "").strip()
     if canva_selected and not rules:
         raise ThumbnailGenerationError("A tarefa não tem um Thumbnail Blueprint local válido.")
@@ -291,6 +295,7 @@ def generate_thumbnail_for_task(
         lettering_text=record.get("thumbnail_text") or "",
         lettering_prompt=record.get("lettering_prompt") or "",
         thumbnail_blueprint=effective_blueprint,
+        aspect_ratio=aspect_ratio,
     )
     updated = _update_thumbnail_task(
         task_id,
@@ -353,6 +358,7 @@ def regenerate_thumbnail_prompt_and_image(
         {},
     ) if isinstance(channels, list) else {}
     effective_blueprint = thumbnail_blueprint_for_task(channel, task)
+    aspect_ratio = thumbnail_aspect_ratio_for_channel_task(channel, task, effective_blueprint)
     _archive_image(str(task_id), record.get("image_path"))
     image_path = _generate_image_with_pool(
         settings,
@@ -362,6 +368,7 @@ def regenerate_thumbnail_prompt_and_image(
         lettering_text=str((variant or {}).get("overlay_text") or ""),
         lettering_prompt=str((variant or {}).get("lettering_prompt") or ""),
         thumbnail_blueprint=effective_blueprint,
+        aspect_ratio=aspect_ratio,
     )
     updated = _update_thumbnail_task(
         task_id,
@@ -429,6 +436,7 @@ def regenerate_thumbnail_lettering(
         "Não adicionar logótipos, marcas de água ou outros elementos."
     )
     _archive_image(str(task_id), previous_image)
+    lettering_blueprint = thumbnail_blueprint_for_task(resolved_channel, task)
     image_path = _generate_image_with_pool(
         settings,
         combined_prompt,
@@ -437,7 +445,8 @@ def regenerate_thumbnail_lettering(
         reference_image=previous_image,
         lettering_text=exact_headline,
         lettering_prompt=edit_prompt,
-        thumbnail_blueprint=thumbnail_blueprint_for_task(resolved_channel, task),
+        thumbnail_blueprint=lettering_blueprint,
+        aspect_ratio=thumbnail_aspect_ratio_for_channel_task(resolved_channel, task, lettering_blueprint),
     )
     variant = _variant_for_record(record)
     variant["image_prompt"] = base_prompt

package/package.json

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