@danhachuel/thunderbolt 0.7.38 → 0.7.40

package/app/main.py

@@ -97,7 +97,7 @@ from app.modules.token_optimizer.metrics import get_stats as get_token_optimizer
 from app.influencers_ui import render_ai_influencer_characters, render_ai_influencer_content, render_ai_influencers_api_status, render_motion_control, render_ugc_products
 from app.social_networks_ui import render_meta_api_cards, render_social_networks
 from hermes_ui.blueprints import create_blueprint_from_link, list_branding_files, save_generated_blueprint
-from hermes_ui.thumbnail_blueprints import generate_thumbnail_blueprint, list_thumbnail_blueprint_documents, resolve_thumbnail_blueprint, save_thumbnail_blueprint, save_thumbnail_blueprint_pair, thumbnail_blueprint_catalog, thumbnail_blueprint_for_blueprint, thumbnail_blueprint_for_channel
+from hermes_ui.thumbnail_blueprints import generate_thumbnail_blueprint, list_thumbnail_blueprint_documents, resolve_thumbnail_blueprint, save_thumbnail_blueprint, save_thumbnail_blueprint_pair, save_thumbnail_blueprint_pairs, thumbnail_blueprint_associations, thumbnail_blueprint_catalog, thumbnail_blueprint_for_blueprint, thumbnail_blueprint_for_channel
 from hermes_ui.metadata_cleaner import build_description, clean_video_metadata, list_edit_records, metadata_manifest, normalize_tags, save_edit_record, store_external_video
 from hermes_ui.python_editor import AUDIO_EXTENSIONS, VIDEO_EXTENSIONS, PythonEditorError, change_speed, editor_manifest, extract_audio, list_edit_records as list_python_editor_records, list_generated_videos, list_scripts, list_video_files, read_script, remove_audio, replace_audio, resize_video, save_edit_record as save_python_editor_record, save_script, store_uploaded_asset, trim_video
 from hermes_ui.cuts import CutsError, download_direct_video_url, generate_clips, list_generated_videos as list_cut_generated_videos, list_runs as list_cut_runs, list_video_files as list_cut_video_files, manifest_bytes as cut_manifest_bytes, store_uploaded_video, zip_run as zip_cut_run
@@ -2122,11 +2122,13 @@ def render_thumbnail_blueprints():
             pair_options = blueprint_catalog()
             pair_ids = [item[0] for item in pair_options]
             pair_labels = {item[0]: item[1] for item in pair_options}
-            pair = st.selectbox("Blueprint de roteiro associado", pair_ids, format_func=lambda item: pair_labels.get(item, item or "Sem Blueprint padrão"), key=f"thumbnail_card_pair_{path.stem}")
+            existing_pairs = thumbnail_blueprint_associations()
+            associated = [key for key, value in existing_pairs.items() if value == path.stem]
+            pair = st.multiselect("Blueprints de roteiro associados", pair_ids, default=[item for item in associated if item in pair_ids], format_func=lambda item: pair_labels.get(item, item or "Sem Blueprint padrão"), key=f"thumbnail_card_pair_{path.stem}")
             if st.button("Guardar associação deste card", key=f"thumbnail_card_pair_save_{path.stem}"):
                 try:
-                    save_thumbnail_blueprint_pair(path.stem, pair)
-                    st.success("Associação guardada; canais com esse Blueprint usarão esta thumbnail blueprint automaticamente.")
+                    save_thumbnail_blueprint_pairs(path.stem, pair)
+                    st.success("Associações guardadas; todos os Blueprints selecionados usarão esta Thumbnail Blueprint automaticamente.")
                 except ValueError as exc:
                     st.error(str(exc))
             with st.expander("Abrir documento completo", expanded=False):
@@ -2155,12 +2157,11 @@ def render_thumbnail_blueprints():
                 script = st.selectbox("Blueprint de roteiro associado", blueprint_ids, index=blueprint_ids.index(current_script) if current_script in blueprint_ids else 0, format_func=lambda item: blueprint_labels.get(item, item or "Sem Blueprint padrão"), key=f"thumbnail_script_blueprint_channel_{channel_id}")
             with cols[2]:
                 if st.button("Guardar par", key=f"thumbnail_blueprint_save_{channel_id}", width="stretch"):
-                    if thumb in {"Youtube_Generic_Thumbnail_Blueprint", "Tiktok_Generic_Thumbnail_Blueprint"} and script:
-                        st.error("Not Allowed to Associate, System Use Only")
-                    else:
-                        update_channel(channel_id, {"thumbnail_blueprint_id": thumb, "default_thumbnail_blueprint_id": thumb, "blueprint_id": script, "default_blueprint_id": script})
-                        st.success("Par Blueprint de roteiro + Thumbnail Blueprint guardado.")
-                        st.rerun()
+                    update_channel(channel_id, {"thumbnail_blueprint_id": thumb, "default_thumbnail_blueprint_id": thumb, "blueprint_id": script, "default_blueprint_id": script})
+                    if script:
+                        save_thumbnail_blueprint_pair(thumb, script)
+                    st.success("Par Blueprint de roteiro + Thumbnail Blueprint guardado.")
+                    st.rerun()
 def _tiktok_accounts_from_settings(settings: dict[str, Any]) -> list[dict[str, Any]]:
     raw_accounts = settings.get("tiktok_accounts")
     if not isinstance(raw_accounts, list) or not raw_accounts:

package/hermes_ui/media_generation.py

@@ -40,7 +40,7 @@ from .provider_routing import (
     route_json_request,
 )
 from .storage import STORAGE, ensure_storage, write_json
-from .thumbnail_generation import _compose_thumbnail_prompt, generate_thumbnail_image, normalize_thumbnail_bytes
+from .thumbnail_generation import _compose_thumbnail_prompt, generate_thumbnail_image, infer_thumbnail_aspect_ratio, normalize_thumbnail_bytes
 from .canva_client import CanvaClient
 from .canva_mcp_workflow import run_direct_canva_thumbnail
 
@@ -267,7 +267,14 @@ def _poll_image(card: Mapping[str, Any], request_id: str, *, attempts: int = 24,
     raise MediaGenerationError("O provider de imagem não concluiu dentro do limite de polling.")
 
 
-def _download_or_write(image_bytes: bytes | None, url: str, destination: Path, card: Mapping[str, Any]) -> Path:
+def _download_or_write(
+    image_bytes: bytes | None,
+    url: str,
+    destination: Path,
+    card: Mapping[str, Any],
+    *,
+    aspect_ratio: str = "16:9",
+) -> Path:
     if image_bytes is None and url:
         try:
             response = requests.get(url, headers={"Authorization": f"Bearer {_api_key(card)}"} if _api_key(card) else {}, timeout=180)
@@ -278,7 +285,7 @@ def _download_or_write(image_bytes: bytes | None, url: str, destination: Path, c
     if not image_bytes:
         raise MediaGenerationError("O provider concluiu a chamada mas não devolveu uma imagem utilizável.")
     try:
-        image_bytes = normalize_thumbnail_bytes(image_bytes)
+        image_bytes = normalize_thumbnail_bytes(image_bytes, aspect_ratio)
     except Exception as exc:
         raise MediaGenerationError(str(exc)) from exc
     destination.parent.mkdir(parents=True, exist_ok=True)
@@ -317,7 +324,11 @@ def _image_endpoint(card: Mapping[str, Any]) -> str:
     raise MediaGenerationError(f"O provider {card.get('provider')} não tem endpoint de imagem configurado.")
 
 
-def _image_request(card: dict[str, Any], prompt: str, *, topic: str = "", lettering_text: str = "", lettering_prompt: str = "") -> Any:
+def _thumbnail_aspect_ratio(thumbnail_blueprint: Mapping[str, Any] | None, prompt: str = "") -> str:
+    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:
     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)
@@ -327,11 +338,12 @@ def _image_request(card: dict[str, Any], prompt: str, *, topic: str = "", letter
         lettering_text=lettering_text,
         lettering_prompt=lettering_prompt,
     )
-    requested_size = "1792x1024" if provider == "pollinations" else "1280x720 minimum"
+    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")
     constrained_prompt = _append_generation_constraints(
         image_prompt,
         kind="image",
-        aspect_ratio="16:9",
+        aspect_ratio=aspect_ratio,
         size=requested_size,
     )
     constrained_prompt = _fit_provider_prompt(constrained_prompt, provider)
@@ -348,7 +360,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": "16:9", "resolution": "1K"},
+            "input": {"prompt": constrained_prompt, "aspect_ratio": aspect_ratio, "resolution": "1K"},
         }
         return requests.post(endpoint, headers=_headers(card), json=body, timeout=180)
     if provider == "agnes":
@@ -356,7 +368,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": "16:9",
+            "ratio": aspect_ratio,
             "return_base64": True,
             "extra_body": {"response_format": "b64_json"},
         }
@@ -365,12 +377,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": "16:9"},
+            json={"model": _model(card), "prompt": constrained_prompt, "n": 1, "aspect_ratio": aspect_ratio},
             timeout=180,
         )
     body = {"model": _model(card), "prompt": constrained_prompt, "n": 1, "response_format": "b64_json"}
     if provider == "pollinations":
-        body["size"] = "1792x1024"
+        body["size"] = "1024x1792" if aspect_ratio == "9:16" else "1792x1024"
     return requests.post(endpoint, headers=_headers(card), json=body, timeout=180)
 
 
@@ -427,6 +439,7 @@ def generate_image_for_card(
             )
         except Exception as exc:
             raise MediaGenerationError(str(exc)) from exc
+    aspect_ratio = _thumbnail_aspect_ratio(thumbnail_blueprint, prompt)
     if provider == "nano_banana":
         merged = dict(settings)
         merged["gemini_image_api_key"] = _api_key(card)
@@ -439,14 +452,15 @@ def generate_image_for_card(
                 _append_generation_constraints(
                     prompt,
                     kind="image",
-                    aspect_ratio="16:9",
-                    size="1280x720 minimum",
+                    aspect_ratio=aspect_ratio,
+                    size="720x1280 minimum" if aspect_ratio == "9:16" else "1280x720 minimum",
                 ),
                 topic=topic,
                 variant_index=variant_index,
                 lettering_text=lettering_text,
                 lettering_prompt=lettering_prompt,
                 reference_image=reference_image,
+                aspect_ratio=aspect_ratio,
             )
         except Exception as exc:
             raise MediaGenerationError(str(exc)) from exc
@@ -469,8 +483,8 @@ def generate_image_for_card(
             constrained_prompt = _append_generation_constraints(
                 image_prompt,
                 kind="image",
-                aspect_ratio="16:9",
-                size="1280x720 minimum",
+                aspect_ratio=aspect_ratio,
+                size="720x1280 minimum" if aspect_ratio == "9:16" else "1280x720 minimum",
             )
             from huggingface_hub import InferenceClient
             image = InferenceClient(token=token or None, provider="hf-inference").text_to_image(
@@ -479,12 +493,12 @@ def generate_image_for_card(
             )
             buffer = io.BytesIO()
             image.save(buffer, format="PNG")
-            return _download_or_write(buffer.getvalue(), "", destination, card)
+            return _download_or_write(buffer.getvalue(), "", destination, card, aspect_ratio=aspect_ratio)
         except Exception as exc:
             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)
+        return _image_request(current, prompt, topic=topic, lettering_text=lettering_text, lettering_prompt=lettering_prompt, thumbnail_blueprint=thumbnail_blueprint)
 
     try:
         routed = route_json_request(settings, pool=POOL_IMAGE, cards=[card], request=request)
@@ -507,7 +521,7 @@ def generate_image_for_card(
         elif request_id and style == "kie":
             urls = _poll_kie_task(routed.card, request_id, endpoint="/jobs/recordInfo", veo=False)
             url = urls[0] if urls else ""
-    return _download_or_write(image_bytes, url, destination, routed.card)
+    return _download_or_write(image_bytes, url, destination, routed.card, aspect_ratio=aspect_ratio)
 
 
 def _is_retryable_media_error(exc: BaseException) -> bool:

package/hermes_ui/pipeline_worker.py

@@ -32,7 +32,7 @@ from hermes_ui.llm_providers import active_llm_card, provider_definition
 from hermes_ui.media_generation import MediaGenerationError, _append_generation_constraints, generate_image_from_pool, generate_video_from_pool
 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
+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.voice_preview import synthesize_preview
 
@@ -97,6 +97,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),
         )
     return generate_image_from_pool(
         settings,

package/hermes_ui/storage.py

@@ -379,9 +379,9 @@ def seed_blueprints() -> None:
     thumbnail_destination = BLUEPRINTS / "thumbnails"
     thumbnail_destination.mkdir(parents=True, exist_ok=True)
     legacy_thumbnail = thumbnail_destination / "FINANCE_Thumbnail_Blueprint.md"
-    current_thumbnail = thumbnail_destination / "FINANCE USA_Thumbnail_Blueprint.md"
-    if legacy_thumbnail.is_file() and not current_thumbnail.exists():
-        legacy_thumbnail.replace(current_thumbnail)
+    renamed_thumbnail = thumbnail_destination / "FINANCE USA_Thumbnail_Blueprint.md"
+    if renamed_thumbnail.is_file() and not legacy_thumbnail.exists():
+        renamed_thumbnail.replace(legacy_thumbnail)
     for source in sorted(SEED_THUMBNAIL_BLUEPRINTS.glob("*.md")):
         target = thumbnail_destination / source.name
         if not target.exists():
@@ -393,7 +393,15 @@ def seed_blueprints() -> None:
             seeded_pairs = json.loads(pair_source.read_text(encoding="utf-8"))
             current_pairs = json.loads(pair_target.read_text(encoding="utf-8")) if pair_target.exists() else {}
             if isinstance(seeded_pairs, dict) and isinstance(current_pairs, dict):
+                finance_ids = {
+                    "blueprintcanalfinanças", "blueprintcanalfinancas", "BLUEPRINT CANAL FINANÇAS",
+                    "FINANÇAS", "FINANCAS", "FINANCE", "FINANCE USA", "FINANCE BRAZIL", "FINANCE CANADA",
+                    "FINANCE FRANCE", "FINANCE GERMANY", "FINANCE IRELAND", "FINANCE ISRAEL", "FINANCE ITALY",
+                    "FINANCE JAPAN", "FINANCE MEXICO", "FINANCE POLONY", "FINANCE SOUTH AFRICA",
+                    "FINANCE SOUTH COREA", "FINANCE SPAIN", "FINANCE UK", "FINANCE AUSTRALIA",
+                }
                 merged_pairs = {**seeded_pairs, **current_pairs}
+                merged_pairs.update({key: "FINANCE_Thumbnail_Blueprint" for key in finance_ids})
                 if merged_pairs != current_pairs:
                     atomic_write(pair_target, merged_pairs)
         except (OSError, UnicodeError, json.JSONDecodeError):
@@ -402,15 +410,15 @@ def seed_blueprints() -> None:
 
 
 def _rename_pending_finance_thumbnail_references(value: Any) -> tuple[Any, bool]:
-    """Rename the legacy finance thumbnail only in unfinished work items."""
-    legacy = "FINANCE_Thumbnail_Blueprint"
-    current = "FINANCE USA_Thumbnail_Blueprint"
+    """Restore the finance thumbnail name in unfinished persisted records."""
+    renamed = "FINANCE USA_Thumbnail_Blueprint"
+    current = "FINANCE_Thumbnail_Blueprint"
     changed = False
 
     def replace(item: Any) -> Any:
         nonlocal changed
         if isinstance(item, str):
-            if item == legacy:
+            if item == renamed:
                 changed = True
                 return current
             return item
@@ -424,7 +432,7 @@ def _rename_pending_finance_thumbnail_references(value: Any) -> tuple[Any, bool]
 
 
 def migrate_finance_thumbnail_blueprint() -> None:
-    """Move pending automation/video records to the renamed finance thumbnail."""
+    """Restore the finance thumbnail name in pending records and map finance variants."""
     def load_state(name: str, default: Any) -> Any:
         path = STATE / name
         try:
@@ -477,6 +485,50 @@ def migrate_finance_thumbnail_blueprint() -> None:
             save_state("queues.json", updated_queues)
 
 
+def migrate_tiktok_thumbnail_blueprint() -> None:
+    """Adopt the vertical generic thumbnail for legacy TikTok state."""
+    def load_state(name: str, default: Any) -> Any:
+        try:
+            return _load_json_unlocked(STATE / name)
+        except (OSError, json.JSONDecodeError):
+            return default
+
+    def save_state(name: str, value: Any) -> None:
+        _atomic_write_unlocked(STATE / name, value)
+
+    channels = load_state("channels.json", [])
+    channel_map = {str(item.get("id") or ""): item for item in channels if isinstance(item, dict)} if isinstance(channels, list) else {}
+    vertical_ids = {"Generic_Thumbnail_Blueprint", "Youtube_Generic_Thumbnail_Blueprint"}
+    channel_changes = False
+    if isinstance(channels, list):
+        for channel in channels:
+            platform = str(channel.get("platform") or "").strip().casefold()
+            current = str(channel.get("thumbnail_blueprint_id") or channel.get("default_thumbnail_blueprint_id") or "").strip()
+            if platform in {"tiktok", "instagram", "instagram reels"} and (not current or current in vertical_ids):
+                channel["thumbnail_blueprint_id"] = "Tiktok_Generic_Thumbnail_Blueprint"
+                channel["default_thumbnail_blueprint_id"] = "Tiktok_Generic_Thumbnail_Blueprint"
+                channel_changes = True
+        if channel_changes:
+            save_state("channels.json", channels)
+
+    tasks = load_state("tasks.json", [])
+    tasks_changed = False
+    if isinstance(tasks, list):
+        for task in tasks:
+            if not isinstance(task, dict):
+                continue
+            channel = channel_map.get(str(task.get("channel_id") or ""), {})
+            platform = str(task.get("platform") or channel.get("platform") or "").strip().casefold()
+            format_value = str(task.get("format") or (task.get("generation_settings") or {}).get("video_aspect_ratio") or "").strip().casefold()
+            vertical = platform in {"tiktok", "instagram", "instagram reels"} or format_value in {"portrait", "vertical", "shorts", "9:16"}
+            current = str(task.get("thumbnail_blueprint_id") or "").strip()
+            if vertical and (not current or current in vertical_ids):
+                task["thumbnail_blueprint_id"] = "Tiktok_Generic_Thumbnail_Blueprint"
+                tasks_changed = True
+        if tasks_changed:
+            save_state("tasks.json", tasks)
+
+
 def seed_prompt_masters() -> None:
     """Copy packaged TikTok Prompt Masters without overwriting user files."""
     if not SEED_TIKTOK_PROMPT_MASTERS.exists():
@@ -525,6 +577,7 @@ def ensure_storage() -> None:
         if not target.exists():
             atomic_write(target, default)
     migrate_finance_thumbnail_blueprint()
+    migrate_tiktok_thumbnail_blueprint()
 
 
 _LOCK_TIMEOUT_SECONDS = 30.0

package/hermes_ui/thumbnail_blueprints.py

@@ -53,7 +53,7 @@ def resolve_thumbnail_blueprint(identifier: Any) -> dict[str, Any]:
 
 def _generic_thumbnail_blueprint_id(format_value: Any = "", platform: Any = "") -> str:
     raw = str(format_value or "").strip().casefold()
-    if raw in {"portrait", "vertical", "shorts", "9:16", "tiktok", "reels"}:
+    if raw in {"portrait", "portrait 9:16", "vertical", "shorts", "9:16", "tiktok", "reels"}:
         return VERTICAL_GENERIC_THUMBNAIL_BLUEPRINT_ID
     platform_raw = str(platform or "").strip().casefold()
     if platform_raw in {"tiktok", "instagram", "instagram reels", "shorts"} and not raw:
@@ -63,7 +63,11 @@ def _generic_thumbnail_blueprint_id(format_value: Any = "", platform: Any = "")
 
 def thumbnail_blueprint_for_channel(channel: Mapping[str, Any], format_value: Any = "") -> dict[str, Any]:
     direct = channel.get("default_thumbnail_blueprint_id") or channel.get("thumbnail_blueprint_id")
-    if direct:
+    if direct and str(direct).strip() not in {
+        "Generic_Thumbnail_Blueprint",
+        HORIZONTAL_GENERIC_THUMBNAIL_BLUEPRINT_ID,
+        VERTICAL_GENERIC_THUMBNAIL_BLUEPRINT_ID,
+    }:
         return resolve_thumbnail_blueprint(direct)
     script_id = str(channel.get("default_blueprint_id") or channel.get("blueprint_id") or "").strip()
     pairs = _pair_state()
@@ -72,10 +76,25 @@ def thumbnail_blueprint_for_channel(channel: Mapping[str, Any], format_value: An
     )
 
 
-def thumbnail_blueprint_for_blueprint(blueprint_id: Any) -> dict[str, Any]:
+def thumbnail_blueprint_for_task(channel: Mapping[str, Any], task: Mapping[str, Any]) -> dict[str, Any]:
+    """Resolve a task thumbnail, replacing stale generic orientation defaults."""
+    format_value = task.get("format") or (task.get("generation_settings") or {}).get("video_aspect_ratio")
+    direct = str(task.get("thumbnail_blueprint_id") or "").strip()
+    if direct and direct not in {
+        "Generic_Thumbnail_Blueprint",
+        HORIZONTAL_GENERIC_THUMBNAIL_BLUEPRINT_ID,
+        VERTICAL_GENERIC_THUMBNAIL_BLUEPRINT_ID,
+    }:
+        return resolve_thumbnail_blueprint(direct)
+    return thumbnail_blueprint_for_channel({**channel, "thumbnail_blueprint_id": ""}, format_value)
+
+
+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(), "")
-    return resolve_thumbnail_blueprint(paired_id or HORIZONTAL_GENERIC_THUMBNAIL_BLUEPRINT_ID)
+    if isinstance(paired_id, list):
+        paired_id = paired_id[0] if paired_id else ""
+    return resolve_thumbnail_blueprint(paired_id or _generic_thumbnail_blueprint_id(format_value))
 
 
 def _pair_state() -> dict[str, str]:
@@ -87,9 +106,11 @@ def _pair_state() -> dict[str, str]:
         return {}
 
 
+def thumbnail_blueprint_associations() -> dict[str, str]:
+    return _pair_state()
+
+
 def save_thumbnail_blueprint_pair(thumbnail_id: str, blueprint_id: str) -> None:
-    if str(thumbnail_id) in {HORIZONTAL_GENERIC_THUMBNAIL_BLUEPRINT_ID, VERTICAL_GENERIC_THUMBNAIL_BLUEPRINT_ID} and str(blueprint_id):
-        raise ValueError(GENERIC_ASSOCIATION_ERROR)
     pairs = _pair_state()
     if blueprint_id:
         pairs[str(blueprint_id)] = str(thumbnail_id)
@@ -100,6 +121,21 @@ def save_thumbnail_blueprint_pair(thumbnail_id: str, blueprint_id: str) -> None:
     atomic_write(BLUEPRINTS / "thumbnail_blueprint_pairs.json", pairs)
 
 
+def save_thumbnail_blueprint_pairs(thumbnail_id: str, blueprint_ids: list[str]) -> None:
+    """Associate one thumbnail blueprint with any number of script blueprints."""
+    selected = {str(item).strip() for item in blueprint_ids if str(item).strip()}
+    pairs = _pair_state()
+    for key, value in list(pairs.items()):
+        values = value if isinstance(value, list) else [value]
+        if str(key) in selected:
+            continue
+        if str(thumbnail_id) in {str(item) for item in values}:
+            pairs.pop(key, None)
+    for blueprint_id in selected:
+        pairs[blueprint_id] = str(thumbnail_id)
+    atomic_write(BLUEPRINTS / "thumbnail_blueprint_pairs.json", pairs)
+
+
 def generate_thumbnail_blueprint(
     settings: Mapping[str, Any],
     *,

package/hermes_ui/thumbnail_generation.py

@@ -23,18 +23,37 @@ DEFAULT_MIME_TYPE = "image/jpeg"
 DEFAULT_IMAGE_EXTENSION = ".jpg"
 THUMBNAIL_WIDTH = 1792
 THUMBNAIL_HEIGHT = 1024
+VERTICAL_THUMBNAIL_WIDTH = 1024
+VERTICAL_THUMBNAIL_HEIGHT = 1792
 
 
 class ThumbnailGenerationError(RuntimeError):
     """Raised when Nano Banana cannot produce a thumbnail image."""
 
 
-def normalize_thumbnail_bytes(image_bytes: bytes) -> bytes:
-    """Return a non-distorted, YouTube-ready 16:9 JPEG at 1792×1024."""
+def infer_thumbnail_aspect_ratio(
+    prompt: str = "",
+    blueprint: dict[str, Any] | None = None,
+    *,
+    fallback: str = DEFAULT_ASPECT_RATIO,
+) -> str:
+    """Resolve the requested thumbnail orientation without trusting provider defaults."""
+    blueprint_content = str((blueprint or {}).get("content") or "")
+    source = f"{blueprint_content}\n{str(prompt or '')}"
+    if re.search(r"\b9\s*:\s*16\b|\bvertical\b|\bportrait\b", source, flags=re.IGNORECASE):
+        return "9:16"
+    if re.search(r"\b16\s*:\s*9\b|\blandscape\b|\bwide\b", source, flags=re.IGNORECASE):
+        return "16:9"
+    return fallback if fallback in {"16:9", "9:16"} else DEFAULT_ASPECT_RATIO
+
+
+def normalize_thumbnail_bytes(image_bytes: bytes, aspect_ratio: str = DEFAULT_ASPECT_RATIO) -> bytes:
+    """Return a non-distorted JPEG in the requested thumbnail orientation."""
     try:
         with Image.open(__import__("io").BytesIO(image_bytes)) as source:
             image = ImageOps.exif_transpose(source).convert("RGB")
-            image = ImageOps.fit(image, (THUMBNAIL_WIDTH, THUMBNAIL_HEIGHT), method=Image.Resampling.LANCZOS, centering=(0.5, 0.5))
+            size = (VERTICAL_THUMBNAIL_WIDTH, VERTICAL_THUMBNAIL_HEIGHT) if str(aspect_ratio) == "9:16" else (THUMBNAIL_WIDTH, THUMBNAIL_HEIGHT)
+            image = ImageOps.fit(image, size, method=Image.Resampling.LANCZOS, centering=(0.5, 0.5))
             output = __import__("io").BytesIO()
             image.save(output, format="JPEG", quality=95, optimize=True)
             return output.getvalue()
@@ -171,6 +190,7 @@ def generate_thumbnail_image(
     reference_image: str | Path | None = None,
     lettering_text: str = "",
     lettering_prompt: str = "",
+    aspect_ratio: str = DEFAULT_ASPECT_RATIO,
 ) -> Path:
     api_key = str(settings.get("gemini_image_api_key") or "").strip()
     if not api_key:
@@ -184,11 +204,9 @@ def generate_thumbnail_image(
         lettering_text=lettering_text,
         lettering_prompt=lettering_prompt,
     )
+    effective_aspect_ratio = infer_thumbnail_aspect_ratio(clean_prompt, fallback=aspect_ratio)
 
     model = str(settings.get("gemini_image_model") or DEFAULT_GEMINI_IMAGE_MODEL).strip()
-    # YouTube thumbnails are never square: do not allow a legacy/provider setting
-    # to override the required horizontal canvas.
-    aspect_ratio = DEFAULT_ASPECT_RATIO
     image_size = DEFAULT_IMAGE_SIZE
     request_input: str | list[dict[str, str]] = effective_prompt
     if reference_image:
@@ -202,7 +220,7 @@ def generate_thumbnail_image(
         "response_format": {
             "type": "image",
             "mime_type": DEFAULT_MIME_TYPE,
-            "aspect_ratio": aspect_ratio,
+            "aspect_ratio": effective_aspect_ratio,
             "image_size": image_size,
         },
         "store": False,
@@ -229,7 +247,7 @@ def generate_thumbnail_image(
         raise ThumbnailGenerationError("A API Nano Banana devolveu uma resposta que não é JSON.") from exc
     if str(payload.get("status") or "completed").lower() not in {"completed", "succeeded"}:
         raise ThumbnailGenerationError(f"A interação Nano Banana terminou com estado inesperado: {payload.get('status') or 'desconhecido'}.")
-    image_bytes = normalize_thumbnail_bytes(_extract_image_bytes(payload))
+    image_bytes = normalize_thumbnail_bytes(_extract_image_bytes(payload), effective_aspect_ratio)
 
     ensure_storage()
     output_dir = STORAGE / "thumbnails"
@@ -257,6 +275,7 @@ __all__ = [
     "DEFAULT_ASPECT_RATIO",
     "DEFAULT_GEMINI_IMAGE_MODEL",
     "DEFAULT_IMAGE_SIZE",
+    "infer_thumbnail_aspect_ratio",
     "THUMBNAIL_HEIGHT",
     "THUMBNAIL_WIDTH",
     "GEMINI_INTERACTIONS_ENDPOINT",

package/hermes_ui/thumbnails.py

@@ -11,8 +11,8 @@ from .creative_generation import _language_instruction, generate_thumbnail_promp
 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
-from .thumbnail_blueprints import thumbnail_blueprint_for_channel
+from .thumbnail_generation import ThumbnailGenerationError, generate_thumbnail_image, infer_thumbnail_aspect_ratio
+from .thumbnail_blueprints import thumbnail_blueprint_for_task
 
 
 def _generate_image_with_pool(
@@ -41,6 +41,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),
         )
     return generate_image_from_pool(
         settings,
@@ -270,15 +271,13 @@ def generate_thumbnail_for_task(
         and bool(item.get("enabled", True))
         for item in configured_cards
     ) if isinstance(configured_cards, list) else False
-    if not effective_blueprint and canva_selected:
+    if not effective_blueprint:
         channels = read_json("channels.json", [])
         channel = next(
             (item for item in channels if isinstance(item, dict) and str(item.get("id") or "") == record["channel_id"]),
             {},
         ) if isinstance(channels, list) else {}
-        effective_blueprint = thumbnail_blueprint_for_channel(
-            {**channel, "thumbnail_blueprint_id": record["thumbnail_blueprint_id"] or channel.get("thumbnail_blueprint_id", "")}
-        )
+        effective_blueprint = thumbnail_blueprint_for_task(channel, task)
     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.")
@@ -316,9 +315,7 @@ def regenerate_thumbnail_prompt(
     if not topic:
         raise ThumbnailGenerationError("A tarefa não tem tópico para refazer o prompt da thumbnail.")
     ensure_storage()
-    visual_blueprint = thumbnail_blueprint_for_channel(
-        {**(channel or {}), "thumbnail_blueprint_id": record.get("thumbnail_blueprint_id") or (channel or {}).get("thumbnail_blueprint_id", "")}
-    )
+    visual_blueprint = thumbnail_blueprint_for_task(channel or {}, task)
     effective_blueprint = {**(blueprint or {})}
     if visual_blueprint.get("content"):
         effective_blueprint["thumbnail_blueprint_rules"] = visual_blueprint["content"]
@@ -350,6 +347,12 @@ def regenerate_thumbnail_prompt_and_image(
     prompt = str((variant or {}).get("image_prompt") or "").strip()
     if not prompt:
         raise ThumbnailGenerationError("O provider não devolveu um prompt de imagem válido.")
+    channels = read_json("channels.json", [])
+    channel = next(
+        (item for item in channels if isinstance(item, dict) and str(item.get("id") or "") == str(task.get("channel_id") or "")),
+        {},
+    ) if isinstance(channels, list) else {}
+    effective_blueprint = thumbnail_blueprint_for_task(channel, task)
     _archive_image(str(task_id), record.get("image_path"))
     image_path = _generate_image_with_pool(
         settings,
@@ -358,6 +361,7 @@ def regenerate_thumbnail_prompt_and_image(
         variant_index=record["variant_index"],
         lettering_text=str((variant or {}).get("overlay_text") or ""),
         lettering_prompt=str((variant or {}).get("lettering_prompt") or ""),
+        thumbnail_blueprint=effective_blueprint,
     )
     updated = _update_thumbnail_task(
         task_id,
@@ -433,6 +437,7 @@ 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),
     )
     variant = _variant_for_record(record)
     variant["image_prompt"] = base_prompt

package/package.json

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

package/seed/blueprints/thumbnail_blueprint_pairs.json

@@ -1,9 +1,26 @@
 {
   "BLUEPRINTCANALMILITAR": "Militar_Thumbnail_Blueprint",
   "MILITAR": "Militar_Thumbnail_Blueprint",
-  "blueprintcanalfinanças": "FINANCE USA_Thumbnail_Blueprint",
-  "blueprintcanalfinancas": "FINANCE USA_Thumbnail_Blueprint",
-  "BLUEPRINT CANAL FINANÇAS": "FINANCE USA_Thumbnail_Blueprint",
-  "FINANÇAS": "FINANCE USA_Thumbnail_Blueprint",
-  "FINANCAS": "FINANCE USA_Thumbnail_Blueprint"
+  "blueprintcanalfinanças": "FINANCE_Thumbnail_Blueprint",
+  "blueprintcanalfinancas": "FINANCE_Thumbnail_Blueprint",
+  "BLUEPRINT CANAL FINANÇAS": "FINANCE_Thumbnail_Blueprint",
+  "FINANÇAS": "FINANCE_Thumbnail_Blueprint",
+  "FINANCAS": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE USA": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE AUSTRALIA": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE BRAZIL": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE CANADA": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE FRANCE": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE GERMANY": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE IRELAND": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE ISRAEL": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE ITALY": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE JAPAN": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE MEXICO": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE POLONY": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE SOUTH AFRICA": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE SOUTH COREA": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE SPAIN": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE UK": "FINANCE_Thumbnail_Blueprint"
 }