@danhachuel/thunderbolt 0.2.60 → 0.2.62

package/app/main.py

@@ -22,7 +22,7 @@ except (OSError, json.JSONDecodeError):
 
 from hermes_ui.domain import STAGES, create_batch, create_channel, create_tasks_for_batch, delete_channel, pipeline_summary, set_channel_defaults, transition_task, update_channel, update_channel_video
 from hermes_ui.automation_worker import load_worker_status
-from hermes_ui.storage import BLUEPRINTS, STORAGE, ensure_storage, list_blueprint_files, load_blueprint_file, now, read_json, write_json
+from hermes_ui.storage import BLUEPRINTS, STORAGE, TIKTOK_PROMPT_MASTERS, ensure_storage, list_blueprint_files, list_prompt_master_files, load_blueprint_file, load_prompt_master_file, now, read_json, write_json
 from app.modules.niche_finder.apify import ApifyError, DEFAULT_ACTOR_ID, abort_actor_run, build_actor_input, get_dataset_items, normalize_video_items, start_actor_run, wait_for_actor_run
 from app.modules.niche_finder.core import NicheAnalysisError, run_niche_analysis
 from app.modules.niche_finder.data_loader import DatasetError, download_kaggle_dataset
@@ -42,7 +42,7 @@ from integrations.platforms import IntegrationResult, TikTokAdapter, YouTubeAdap
 from integrations.postiz import PostizAdapter
 from integrations.upload_routing import OFFICIAL_DAILY_LIMIT, official_upload_count, upload_with_default_route
 from integrations.youtube_direct_upload import YouTubeDirectUploader
-from integrations.youtube_direct_credentials import delete_credentials_document, direct_account_status, document_status, ensure_credentials_document, merge_credentials_document, parse_credentials_document, save_credentials_document, update_credentials_document_session_info
+from integrations.youtube_direct_credentials import delete_credentials_document, direct_account_status, document_status, ensure_credentials_document, load_credentials_document, merge_credentials_document, parse_credentials_document, save_credentials_document, update_credentials_document_session_info
 from integrations.youtube_batch import account_key as youtube_batch_account_key, account_status as youtube_batch_account_status, authorize_account as authorize_youtube_batch_account, delete_account_token as delete_youtube_batch_token, list_my_channels as list_youtube_batch_channels, loopback_redirect_uri
 from integrations.local_runtime import MoneyPrinterRuntime
 from integrations.moneyprinter_config import sync_moneyprinter_config
@@ -711,6 +711,78 @@ def render_blueprints():
                     st.error(str(exc))
 
 
+def render_tiktok_prompt_masters():
+    st.title("Prompts Master")
+    st.caption(f"Biblioteca exclusiva para vídeos TikTok. Os ficheiros ficam em `{TIKTOK_PROMPT_MASTERS}` e nunca entram na pasta de Blueprints YouTube.")
+
+    upload_tab, library_tab = st.tabs(["Upload", "Biblioteca"])
+    with upload_tab:
+        st.subheader("Adicionar Prompt Master")
+        st.info("Use ficheiros Markdown `.md`. Cada Prompt Master é guardado como um ficheiro independente no storage TikTok.")
+        uploaded_prompt = st.file_uploader("Subir Prompt Master (.md)", type=["md"], key="tiktok_prompt_master_upload")
+        if uploaded_prompt is not None:
+            uploaded_name = Path(uploaded_prompt.name).stem
+            prompt_name = st.text_input("Nome do Prompt Master", value=uploaded_name, key="tiktok_prompt_master_name")
+            replace_prompt = st.checkbox("Permitir substituir um ficheiro existente", key="tiktok_prompt_master_replace")
+            if st.button("Guardar Prompt Master", type="primary", use_container_width=True, key="save_tiktok_prompt_master"):
+                safe_stem = re.sub(r"[^A-Za-z0-9À-ÿ._-]+", "-", prompt_name.strip() or uploaded_name).strip(".-") or "prompt-master"
+                destination = TIKTOK_PROMPT_MASTERS / f"{safe_stem}.md"
+                if destination.exists() and not replace_prompt:
+                    st.warning("Já existe um Prompt Master com esse nome. Active a substituição para o actualizar.")
+                else:
+                    try:
+                        content = uploaded_prompt.getvalue().decode("utf-8-sig")
+                        if not content.strip():
+                            raise ValueError("O ficheiro Markdown está vazio.")
+                        destination.write_text(content.rstrip() + "\n", encoding="utf-8")
+                        st.success(f"Prompt Master guardado em `{destination}`.")
+                        st.rerun()
+                    except UnicodeDecodeError:
+                        st.error("O ficheiro deve estar codificado em UTF-8.")
+                    except OSError as exc:
+                        st.error(f"Não foi possível guardar o Prompt Master: {exc}")
+
+    with library_tab:
+        files = list_prompt_master_files()
+        st.subheader(f"Prompts Master existentes ({len(files)})")
+        search = st.text_input("Pesquisar Prompt Master", key="tiktok_prompt_master_search", placeholder="Nome ou conteúdo")
+        visible_files: list[Path] = []
+        for path in files:
+            try:
+                content = load_prompt_master_file(path)
+            except (OSError, ValueError):
+                content = ""
+            if search and search.lower() not in f"{path.name}\n{content}".lower():
+                continue
+            visible_files.append(path)
+        if not visible_files:
+            st.info("Ainda não existem Prompt Master que correspondam à pesquisa.")
+        for path in visible_files:
+            try:
+                content = load_prompt_master_file(path)
+                heading = next((line.lstrip("#").strip() for line in content.splitlines() if line.startswith("#")), path.stem)
+                with st.expander(f"{heading} — {path.name}", expanded=False):
+                    st.caption(f"Ficheiro TikTok: `{path}`")
+                    edited_content = st.text_area("Conteúdo Markdown", value=content, height=360, key=f"tiktok_prompt_master_editor_{path.stem}")
+                    prompt_cols = st.columns(3)
+                    with prompt_cols[0]:
+                        if st.button("Guardar alterações", type="primary", use_container_width=True, key=f"save_prompt_master_{path.stem}"):
+                            path.write_text(edited_content.rstrip() + "\n", encoding="utf-8")
+                            st.success("Prompt Master actualizado.")
+                            st.rerun()
+                    with prompt_cols[1]:
+                        st.download_button("Descarregar", data=content.encode("utf-8"), file_name=path.name, mime="text/markdown", use_container_width=True, key=f"download_prompt_master_{path.stem}")
+                    with prompt_cols[2]:
+                        if st.button("Apagar", use_container_width=True, key=f"delete_prompt_master_{path.stem}"):
+                            path.unlink(missing_ok=True)
+                            st.success("Prompt Master removido da biblioteca TikTok.")
+                            st.rerun()
+                    st.markdown(content)
+            except (OSError, ValueError) as exc:
+                with st.expander(f"Ficheiro inválido — {path.name}"):
+                    st.error(str(exc))
+
+
 def render_channels():
     st.title("Canais Youtube")
     st.caption("Escolha entre importar dados públicos do YouTube ou preencher o canal manualmente.")
@@ -2571,7 +2643,7 @@ def render_settings():
             account_email_snapshot = str(batch_account.get("email") or "sem e-mail")
             account_label_snapshot = str(batch_account.get("label") or "Canais YouTube")
             ensure_credentials_document(STORAGE, batch_account, settings, channel_state)
-            direct_status = direct_account_status(STORAGE, batch_account)
+            direct_status = direct_account_status(STORAGE, batch_account, settings)
             missing_document_parts = list(direct_status.get("missing_cookies", []))
             if not direct_status.get("has_session_info"):
                 missing_document_parts.append("sessionInfo")
@@ -2678,6 +2750,31 @@ def render_settings():
         if youtube_accounts_missing_document:
             st.info("Contas que ainda precisam de dados no documento: " + ", ".join(youtube_accounts_missing_document))
 
+        st.divider()
+        st.markdown("### INNERTUBE_API_KEY")
+        st.caption("Esta chave pertence à conta Google/YouTube seleccionada e fica guardada na configuração da conta. Não faz parte do documento de cookies/credenciais e não é editada no separador API Keys.")
+        account_key_options = [str(account.get("id")) for account in batch_accounts if account.get("id")]
+        account_key_labels = {str(account.get("id")): f"{account.get('label', 'Canais YouTube')} — {account.get('email', 'sem e-mail')}" for account in batch_accounts if account.get("id")}
+        if account_key_options:
+            with st.form("innertube_api_key_form"):
+                selected_key_account_id = st.selectbox("Conta Google/YouTube", account_key_options, format_func=lambda value: account_key_labels.get(value, value), key="innertube_key_account")
+                selected_key_account = next(account for account in batch_accounts if str(account.get("id")) == selected_key_account_id)
+                current_innertube_api_key = direct_account_status(STORAGE, selected_key_account, settings).get("innertube_api_key", "")
+                innertube_api_key_value = st.text_input("INNERTUBE_API_KEY", value=current_innertube_api_key, type="password", key=f"innertube_api_key_{selected_key_account_id}", help="Chave usada pelo Upload directo desta conta. Guarde-a aqui, separada do documento de cookies.")
+                save_innertube_api_key = st.form_submit_button("Guardar INNERTUBE_API_KEY", type="primary", use_container_width=True)
+            if save_innertube_api_key:
+                selected_key_account["innertube_api_key"] = innertube_api_key_value.strip()
+                selected_key_account.pop("INNERTUBE_API_KEY", None)
+                settings.pop("direct_innertube_api_key", None)
+                settings["youtube_batch_accounts"] = batch_accounts
+                write_json("settings.json", settings)
+                document = load_credentials_document(STORAGE, selected_key_account, settings, channel_state, create=True)
+                save_credentials_document(STORAGE, selected_key_account, document)
+                st.success("INNERTUBE_API_KEY guardada na configuração da conta Google/YouTube, fora do documento de cookies.")
+                st.rerun()
+        else:
+            st.info("Adicione primeiro uma conta Google/YouTube para configurar a INNERTUBE_API_KEY.")
+
         st.divider()
         st.markdown("### Adicionar outra conta Gmail")
         st.caption("Este formulário fica fora dos cartões das contas existentes. A associação de canais não depende da completude deste documento; ela apenas ficará pendente para Upload directo até os campos serem preenchidos.")
@@ -2689,7 +2786,7 @@ def render_settings():
                 new_account_client_id = st.text_input("OAuth Client ID", key="new_batch_account_client_id")
             with add_cols[1]:
                 new_account_client_secret = st.text_input("OAuth Client Secret", type="password", key="new_batch_account_client_secret")
-                new_account_session_info = st.text_input("sessionInfo token desta conta Google", type="password", key="new_batch_account_session_info", help="Token sessionInfo desta conta. Os cookies, INNERTUBE_API_KEY, chunk_size e delegated_session_ids continuam apenas no documento.")
+                new_account_session_info = st.text_input("sessionInfo token desta conta Google", type="password", key="new_batch_account_session_info", help="Token sessionInfo desta conta. Os cookies e delegated_session_ids ficam no documento; a INNERTUBE_API_KEY é configurada no bloco próprio acima.")
                 new_account_document = st.file_uploader("Documento de cookies/credenciais opcional", type=["json"], key="new_batch_account_credentials_document", help="Pode subir agora um JSON completo ou apenas o documento de cookies. Se não subir, será criado um credentials.json padrão vazio.")
             add_account = st.form_submit_button("Adicionar conta Google/YouTube", type="primary", use_container_width=True)
         if add_account:
@@ -2763,10 +2860,6 @@ def render_settings():
                 st.caption("A YouTube Data API Key é uma credencial Google Cloud separada do OAuth. Só é necessária se escolher o método YouTube Data API para consultar métricas oficiais. Não é necessária para Página pública — sem API Key, para autorizar OAuth ou para fazer upload.")
                 youtube_api_key = text_setting("YouTube Data API Key (opcional)", "youtube_api_key", secret=True, help_text="Credencial separada, criada em Google Cloud > APIs e serviços > Credenciais > Chave de API. Não cole aqui o Client ID nem o Client Secret.")
 
-            st.caption("As credenciais e parâmetros do Upload directo — cookies, sessionInfo, INNERTUBE_API_KEY, chunk_size e DELEGATED_SESSION_ID — são lidos exclusivamente do documento JSON por conta Google. Não são editados nesta UI.")
-            direct_innertube_api_key = str(settings.get("direct_innertube_api_key", "") or "")
-            direct_chunk_size = int(settings.get("direct_chunk_size", 262144) or 262144)
-
             with st.expander("Serviço, materiais e rede"):
                 cols = st.columns(2)
                 with cols[0]:
@@ -2917,7 +3010,6 @@ def render_settings():
                     "youtube_client_id": youtube_client_id, "youtube_client_secret": youtube_client_secret,
                     "kaggle_username": kaggle_username.strip(), "kaggle_api_key": kaggle_api_key.strip(), "kaggle_kernel_slug": kaggle_kernel_slug.strip() or "thunderbolt-niche-finder",
                     "apify_api_token": apify_api_token.strip(), "apify_actor_id": apify_actor_id.strip() or DEFAULT_ACTOR_ID, "apify_poll_interval_seconds": int(apify_poll_interval), "apify_run_timeout_seconds": int(apify_run_timeout),
-                    "direct_innertube_api_key": direct_innertube_api_key, "direct_chunk_size": direct_chunk_size,
                     "log_level": log_level, "listen_host": listen_host, "listen_port": listen_port, "video_source": video_source,
                     "endpoint": endpoint, "proxy_http": proxy_http, "proxy_https": proxy_https, "match_materials_to_script": match_materials_to_script,
                     "llm_provider": llm_provider, "openai_api_key": openai_api_key, "openai_base_url": openai_base_url, "openai_model_name": openai_model_name,
@@ -3256,6 +3348,9 @@ def main():
         ("Roteiros", ":material/article:", "Roteiros"),
         ("Upload", ":material/cloud_upload:", "Upload"),
     ]
+    pipeline_tiktok_items = [
+        ("Prompts Master", ":material/auto_awesome:", "Prompts Master"),
+    ]
     edition_items = [
         ("Limpador de Metadados", ":material/edit_note:", "Limpador de Metadados"),
         ("Cortes", ":material/content_cut:", "Cortes"),
@@ -3282,6 +3377,7 @@ def main():
         ("Início", ":material/home:", "Início"),
         ("Niche Finder", ":material/search:", "Niche Finder"),
         ("Pipeline", ":material/account_tree:", "Pipeline"),
+        ("Pipeline TikTok", ":material/video_library:", "Pipeline TikTok"),
         ("Automação", ":material/schedule:", "Automação"),
         ("Edição", ":material/edit:", "Edição"),
         ("Models AI", ":material/smart_toy:", "Models AI"),
@@ -3299,7 +3395,7 @@ def main():
         "Configurações Técnicas": "Configurações Técnicas",
     }
     current_page = aliases.get(st.session_state.get("page", "Início"), st.session_state.get("page", "Início"))
-    if current_page not in {item[0] for item in top_pages + pipeline_items + automation_items + edition_items + models_ai_items + niche_finder_items + settings_items}:
+    if current_page not in {item[0] for item in top_pages + pipeline_items + pipeline_tiktok_items + automation_items + edition_items + models_ai_items + niche_finder_items + settings_items}:
         current_page = "Início"
     st.session_state["page"] = current_page
 
@@ -3319,6 +3415,10 @@ def main():
                 with st.expander("Pipeline", expanded=current_page in {item[0] for item in pipeline_items}, icon=":material/account_tree:"):
                     for child_target, child_icon, child_label in pipeline_items:
                         render_nav_button(child_target, child_icon, child_label, child=True)
+            elif target == "Pipeline TikTok":
+                with st.expander("Pipeline TikTok", expanded=current_page in {item[0] for item in pipeline_tiktok_items}, icon=":material/video_library:"):
+                    for child_target, child_icon, child_label in pipeline_tiktok_items:
+                        render_nav_button(child_target, child_icon, child_label, child=True)
             elif target == "Automação":
                 with st.expander("Automação", expanded=current_page in {item[0] for item in automation_items}, icon=":material/schedule:"):
                     for child_target, child_icon, child_label in automation_items:
@@ -3347,6 +3447,7 @@ def main():
         "Criação de Vídeos": render_new_video,
         "Criação de Músicas": render_music_creation,
         "Roteiros": render_scripts,
+        "Prompts Master": render_tiktok_prompt_masters,
         "Automação Youtube": render_automation,
         "Niche Finder Kaggle": render_niche_finder,
         "Niche Finder Apify": render_niche_finder_apify,

package/hermes_ui/storage.py

@@ -12,6 +12,7 @@ ROOT = Path(__file__).resolve().parents[1]
 STORAGE = Path(os.getenv("THUNDERBOLT_STORAGE_DIR") or ROOT / "storage")
 STATE = STORAGE / "state"
 BLUEPRINTS = STORAGE / "blueprints"
+TIKTOK_PROMPT_MASTERS = STORAGE / "tiktok" / "prompts_master"
 NICHES_DATA = STORAGE / "data" / "niches"
 SEED_BLUEPRINTS = ROOT / "seed" / "blueprints"
 
@@ -239,7 +240,7 @@ def seed_blueprints() -> None:
 
 
 def ensure_storage() -> None:
-    for path in [STATE, BLUEPRINTS / "canais", BLUEPRINTS / "nichos", BLUEPRINTS / "importados", BLUEPRINTS / "brandings", STORAGE / "brand", STORAGE / "scripts", STORAGE / "thumbnails", STORAGE / "videos", STORAGE / "artifacts", STORAGE / "skills", STORAGE / "metadata_cleaner", STORAGE / "metadata_cleaner" / "outputs", STORAGE / "music", STORAGE / "voice_previews", STORAGE / "python_editor", NICHES_DATA]:
+    for path in [STATE, BLUEPRINTS / "canais", BLUEPRINTS / "nichos", BLUEPRINTS / "importados", BLUEPRINTS / "brandings", TIKTOK_PROMPT_MASTERS, STORAGE / "brand", STORAGE / "scripts", STORAGE / "thumbnails", STORAGE / "videos", STORAGE / "artifacts", STORAGE / "skills", STORAGE / "metadata_cleaner", STORAGE / "metadata_cleaner" / "outputs", STORAGE / "music", STORAGE / "voice_previews", STORAGE / "python_editor", NICHES_DATA]:
         path.mkdir(parents=True, exist_ok=True)
     seed_blueprints()
     for filename, default in DEFAULTS.items():
@@ -303,3 +304,16 @@ def load_blueprint_file(path: Path) -> dict[str, Any]:
     if not isinstance(data, dict):
         raise ValueError("O blueprint deve ser um objecto JSON.")
     return data
+
+
+def list_prompt_master_files() -> list[Path]:
+    """List only Markdown Prompt Master files stored in the TikTok area."""
+    ensure_storage()
+    return sorted(TIKTOK_PROMPT_MASTERS.glob("*.md"), key=lambda p: p.stat().st_mtime, reverse=True)
+
+
+def load_prompt_master_file(path: Path) -> str:
+    """Read a Prompt Master Markdown file without touching YouTube Blueprints."""
+    if path.parent.resolve() != TIKTOK_PROMPT_MASTERS.resolve():
+        raise ValueError("O Prompt Master deve pertencer ao storage TikTok dedicado.")
+    return path.read_text(encoding="utf-8")

package/integrations/youtube_direct_credentials.py

@@ -101,8 +101,7 @@ def parse_credentials_document(content: bytes, filename: str = DIRECT_DOCUMENT_N
         raise ValueError(f"Faltam cookies obrigatórios no documento {filename}: {', '.join(missing)}.")
     if not document["sessionInfo"]:
         raise ValueError(f"Falta sessionInfo no documento {filename}.")
-    if not document["INNERTUBE_API_KEY"]:
-        raise ValueError(f"Falta INNERTUBE_API_KEY no documento {filename}.")
+    # INNERTUBE_API_KEY é configurada separadamente na UI de Contas Google/YouTube.
     return document
 
 
@@ -128,6 +127,20 @@ def _account_session_info(account: dict[str, Any]) -> str:
     return str(account.get("sessionInfo") or account.get("session_info") or account.get("direct_session_info") or "").strip()
 
 
+def account_innertube_api_key(account: dict[str, Any] | None, document: dict[str, Any] | None = None, settings: dict[str, Any] | None = None) -> str:
+    """Return the account-level key; document value is only a legacy migration fallback."""
+    account = account or {}
+    document = document or {}
+    settings = settings or {}
+    return str(
+        account.get("innertube_api_key")
+        or account.get("INNERTUBE_API_KEY")
+        or settings.get("direct_innertube_api_key")
+        or document.get("INNERTUBE_API_KEY")
+        or ""
+    ).strip()
+
+
 def _normalise_document(raw: Any, account: dict[str, Any]) -> dict[str, Any]:
     raw = raw if isinstance(raw, dict) else {}
     cookies = _normalise_pairs(raw.get("cookies", raw))
@@ -187,7 +200,7 @@ def save_credentials_document(storage_root: Path, account: dict[str, Any], docum
         "email": normalised["email"],
         "sessionInfo": normalised["sessionInfo"],
         "cookies": normalised["cookies"],
-        "INNERTUBE_API_KEY": normalised["INNERTUBE_API_KEY"],
+        # INNERTUBE_API_KEY não pertence ao documento de cookies/credenciais.
         "chunk_size": normalised["chunk_size"],
         "delegated_session_ids": normalised["delegated_session_ids"],
     }
@@ -277,7 +290,7 @@ def merge_credentials_document(
 
     The upload may contain only cookies or the full Frontend API document. Existing
     non-empty values are preserved, so uploading cookies never discards sessionInfo,
-    INNERTUBE_API_KEY, chunk_size or delegated channel IDs.
+    chunk_size or delegated channel IDs. INNERTUBE_API_KEY is configured separately.
     """
     try:
         raw = json.loads(content.decode("utf-8-sig", errors="replace"))
@@ -295,8 +308,8 @@ def merge_credentials_document(
     incoming_session = _placeholder_to_empty(session_info_override) or incoming.get("sessionInfo", "")
     if incoming_session:
         merged["sessionInfo"] = incoming_session
-    if incoming.get("INNERTUBE_API_KEY"):
-        merged["INNERTUBE_API_KEY"] = incoming["INNERTUBE_API_KEY"]
+    # INNERTUBE_API_KEY recebida num JSON é deliberadamente ignorada: a fonte oficial
+    # é a configuração separada da secção Contas Google/YouTube.
     if "chunk_size" in raw:
         merged["chunk_size"] = incoming["chunk_size"]
     for key, value in incoming.get("delegated_session_ids", {}).items():
@@ -325,14 +338,16 @@ def document_status(storage_root: Path, account: dict[str, Any], channel: dict[s
     document = load_credentials_document(storage_root, account, settings, channels, create=True)
     missing_cookies = [key for key in COOKIE_KEYS if not document["cookies"].get(key)]
     delegated = delegated_session_id(document, channel or {}) if channel else ""
+    innertube_api_key = account_innertube_api_key(account, document, settings)
     return {
         "document_file": str(path),
         "document_exists": path.exists(),
         "missing_cookies": missing_cookies,
         "has_session_info": bool(document.get("sessionInfo")),
-        "has_innertube_api_key": bool(document.get("INNERTUBE_API_KEY")),
+        "has_innertube_api_key": bool(innertube_api_key),
+        "innertube_api_key": innertube_api_key,
         "has_delegated_session_id": bool(delegated) if channel is not None else None,
-        "ready": not missing_cookies and bool(document.get("sessionInfo")) and bool(document.get("INNERTUBE_API_KEY")) and (channel is None or bool(delegated)),
+        "ready": not missing_cookies and bool(document.get("sessionInfo")) and bool(innertube_api_key) and (channel is None or bool(delegated)),
     }
 
 
@@ -364,9 +379,9 @@ def save_cookie_file(storage_root: Path, account: dict[str, Any], content: bytes
     return destination
 
 
-def direct_account_status(storage_root: Path, account: dict[str, Any]) -> dict[str, Any]:
-    """Backward-compatible account status; the source of truth is credentials.json."""
-    status = document_status(storage_root, account)
+def direct_account_status(storage_root: Path, account: dict[str, Any], settings: dict[str, Any] | None = None) -> dict[str, Any]:
+    """Return account status; cookies stay in credentials.json and the API key is separate."""
+    status = document_status(storage_root, account, settings=settings)
     return {
         "cookie_file": status["document_file"],
         "document_exists": status["document_exists"],
@@ -374,6 +389,7 @@ def direct_account_status(storage_root: Path, account: dict[str, Any]) -> dict[s
         "missing_cookies": status["missing_cookies"],
         "has_session_info": status["has_session_info"],
         "has_innertube_api_key": status["has_innertube_api_key"],
+        "innertube_api_key": status.get("innertube_api_key", ""),
         "ready": status["ready"],
         "document_file": status["document_file"],
     }

package/integrations/youtube_direct_upload.py

@@ -9,7 +9,7 @@ from dataclasses import dataclass
 from pathlib import Path
 from typing import Any
 
-from integrations.youtube_direct_credentials import COOKIE_KEYS, delegated_session_id, load_credentials_document
+from integrations.youtube_direct_credentials import COOKIE_KEYS, account_innertube_api_key, delegated_session_id, load_credentials_document
 from urllib.parse import quote
 
 import requests
@@ -49,7 +49,8 @@ def _session_info(settings: dict[str, Any], channel: dict[str, Any], account: di
 
 
 def _innertube_api_key(settings: dict[str, Any], channel: dict[str, Any], account: dict[str, Any] | None = None, storage_root: Path | None = None) -> str:
-    return str(_direct_document(settings, channel, account, storage_root).get("INNERTUBE_API_KEY", "") or "").strip()
+    document = _direct_document(settings, channel, account, storage_root)
+    return account_innertube_api_key(account, document, settings)
 
 
 def _delegated_session(settings: dict[str, Any], channel: dict[str, Any], account: dict[str, Any] | None = None, storage_root: Path | None = None) -> str:
@@ -96,7 +97,7 @@ def validate_direct_upload(video_path: str | Path, channel: dict[str, Any], sett
     if not _session_info(settings, channel, account, storage_root):
         return "Falta sessionInfo no documento de credenciais da conta."
     if not _innertube_api_key(settings, channel, account, storage_root):
-        return "Falta INNERTUBE_API_KEY no documento de credenciais da conta."
+        return "Falta INNERTUBE_API_KEY no cartão da conta Google/YouTube."
     if not _delegated_session(settings, channel, account, storage_root):
         return "Falta DELEGATED_SESSION_ID deste canal no documento de credenciais da conta."
     return None

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/thunderbolt",
-  "version": "0.2.60",
+  "version": "0.2.62",
   "description": "Thunderbolt — interface local para operação de canais faceless e motor MoneyPrinterTurbo",
   "main": "scripts/cli.mjs",
   "type": "module",
@@ -15,6 +15,7 @@
     "integrations/data/*.json",
     "scripts/*.mjs",
     "storage/blueprints/**/*.json",
+    "storage/tiktok/prompts_master/**/*.md",
     "seed/blueprints/**/*.json",
     "seed/skills/*.md",
     "seed/references/*.md",

package/storage/tiktok/prompts_master/ASMR.md

@@ -0,0 +1,74 @@
+You are an advanced cinematic ASMR video prompt generator specialized in ultra-realistic macro visuals.
+
+STEP 1 — USER INPUT:
+Always begin by asking the user:
+1) Which fruit or vegetable should be used?
+2) Which visual style do you prefer? Choose one:
+   - transparent glass
+   - jelly glass effect
+   - realistic
+
+Do not proceed until both inputs are clearly defined.
+
+STEP 2 — STYLE ADAPTATION:
+Automatically map the chosen fruit or vegetable to its natural soft outer hue:
+- Apple → soft light red
+- Banana → pale yellow
+- Orange → gentle orange
+- Carrot → soft orange
+- Cucumber → light green
+- Tomato → soft red
+(Adapt intelligently for any other item using realistic natural coloring.)
+
+STEP 3 — PROMPT GENERATION:
+Generate a single, continuous, high-end cinematic prompt with the following exact structure and constraints:
+
+- Scene Type: Hyper-realistic cinematic macro close-up
+- Subject: A whole, full-shaped [fruit/vegetable] made of [selected style]
+- Appearance:
+  - Smooth, polished surface
+  - Slight internal translucency (if glass/jelly style)
+  - Soft natural outer hue matching the real item
+- Positioning:
+  - Perfectly centered on a wooden cutting board
+- Lighting:
+  - Soft studio lighting
+  - Subtle glow from the object
+  - Cinematic highlights and reflections
+- Camera:
+  - Ultra-sharp macro lens
+  - Shallow depth of field
+  - Background fully blurred
+- Action Sequence (MANDATORY ORDER):
+  1. A human hand enters frame holding a sharp stainless steel knife
+  2. Knife hovers briefly above the object
+  3. First slice:
+     - Clean, slow-motion cut
+     - Front section separates precisely
+     - Subtle glass cracking sound
+  4. Immediately followed by second slice:
+     - Smooth, controlled motion
+     - Another piece cleanly cut
+  5. Small transparent shards scatter lightly from both cuts
+- Audio:
+  - ONLY crisp ASMR slicing and delicate glass sounds
+  - NO talking
+  - NO music
+- Visual Restrictions:
+  - Only the hand, knife, and object visible
+  - No extra elements
+- Technical Specs:
+  - Resolution: 1280x720
+  - Frame Rate: 30 FPS
+  - Ultra-detailed, high dynamic range, cinematic realism
+
+STEP 4 — OUTPUT RULES:
+- Output MUST be a single continuous paragraph
+- No bullet points
+- No explanations
+- No extra text
+- No formatting besides plain text
+- Keep wording cinematic, immersive, and precise
+
+FINAL GOAL:
+The generated prompt must feel like a high-budget product shot combined with satisfying ASMR content, maintaining maximum realism, clarity, and sensory detail.

package/storage/tiktok/prompts_master/CINEMATICSLUMTRANSFORMATIONENGINE.md

@@ -0,0 +1,212 @@
+MASTER PROMPT — CINEMATIC SLUM TRANSFORMATION ENGINE (ULTRA-REALISTIC CONTINUITY SYSTEM)
+
+You are a Professional AI Prompt Engineer and Viral Video Director specialized in hyper-realistic urban transformation content for Instagram Reels, Facebook Reels, and YouTube Shorts.
+
+Your task is to analyze a provided image of a deteriorated slum or low-income neighborhood and generate a TWO-PHASE structured transformation system that converts the location into a modernized, clean, and organized version of itself while preserving its identity, layout, and function.
+
+CRITICAL OBJECTIVE:
+Maintain EXTREME visual continuity across all stages so the transformation feels like a single uninterrupted real-world renovation captured by a locked tripod camera.
+
+---------------------------------------------------------------------
+PHASE 1 — CONCEPT ANALYSIS & TRANSFORMATION IDEAS
+---------------------------------------------------------------------
+
+Analyze the image and extract:
+
+• Structural layout (houses, road, pathways, poles, wires)
+• Environment type (urban, riverside, hillside, alley, coastal, etc.)
+• Road geometry and direction
+• Level of deterioration
+• Functional purpose of the location
+
+Then generate 3–5 redevelopment concepts. Each concept MUST include:
+
+1. Concept Name  
+2. Location Type  
+   (Examples: riverside slum, alley slum, railway-side slum, canal-side settlement, under-bridge housing, hillside slum, etc.)
+
+3. Before Condition  
+   (Highly detailed — include: mud roads, garbage piles, broken asphalt, exposed wiring, stagnant water, clogged drains, rusted metal, graffiti, smoke haze, stray animals, etc.)
+
+4. Final Transformation Theme  
+   (Modernization while preserving layout — paved roads, sidewalks, drainage systems, painted houses, organized storefronts, greenery, lighting)
+
+5. Color Palette  
+   (3–5 colors representing before mood → after mood)
+
+6. Lighting Style  
+   (Describe transition: dull, polluted, low contrast → bright, clean, natural lighting)
+
+7. Development / Upgrade Details  
+   (Streetlights, curbs, trees, benches, signage, drainage systems, facade upgrades)
+
+8. WOW Moment  
+   (Visually striking transformation highlight moment)
+
+---------------------------------------------------------------------
+PHASE 2 — MASTER IMAGE + VIDEO CONTINUATION SYSTEM
+---------------------------------------------------------------------
+
+STRICT CONTINUITY RULES (NON-NEGOTIABLE):
+
+• Generate ONLY ONE IMAGE (Image 1)
+• ALL subsequent outputs MUST be VIDEO prompts
+• Each video continues EXACTLY from the last frame of the previous stage
+• NO new camera angles
+• NO re-framing
+• NO perspective change
+
+---------------------------------------------------------------------
+CAMERA LOCK SYSTEM (ABSOLUTE)
+---------------------------------------------------------------------
+
+The camera must remain:
+
+• Fixed tripod position
+• Same height
+• Same angle
+• Same focal length
+• Same framing
+• Same perspective depth
+• Same lighting direction
+
+NO:
+- pan
+- tilt
+- zoom
+- shake
+- handheld motion
+- re-centering
+- time-lapse
+- stabilization shifts
+
+The entire sequence must feel like ONE continuous shot.
+
+---------------------------------------------------------------------
+ROAD GEOMETRY LOCK SYSTEM
+---------------------------------------------------------------------
+
+Detect the PRIMARY ROAD PATH and define it EXACTLY as one of:
+
+• LEFT → RIGHT  
+• RIGHT → LEFT  
+• BOTTOM → CENTER  
+• CENTER → BACKGROUND  
+• DIAGONAL LEFT FRONT → RIGHT BACK  
+• DIAGONAL RIGHT FRONT → LEFT BACK  
+
+Rules:
+
+• The entire road is ONE continuous work zone  
+• ALL damage must be repaired edge-to-edge  
+• NO partial fixes allowed  
+• NO potholes, mud patches, or cracks remaining after Stage 2  
+
+---------------------------------------------------------------------
+WORKER & VEHICLE MOVEMENT RULE
+---------------------------------------------------------------------
+
+• Movement must FOLLOW the road direction
+• Entry and exit sides MUST remain consistent
+• Workers and trucks must:
+  - Enter frame naturally
+  - Traverse FULL visible road
+  - Exit frame completely before stage ends
+
+NO:
+- teleporting
+- reversing
+- disappearing mid-frame
+
+FINAL FRAME RULE:
+• ZERO workers
+• ZERO vehicles
+
+---------------------------------------------------------------------
+IMAGE 1 — MASTER REFERENCE FRAME (BEFORE STATE)
+---------------------------------------------------------------------
+
+Generate ONE ultra-realistic cinematic image prompt:
+
+Requirements:
+
+• Extreme slum condition
+• Wide-angle composition
+• Same buildings, same layout
+• Same wires, poles, depth
+• No workers
+• No machinery
+
+Must include:
+
+Primary Road Direction: (detected direction)
+
+Quality keywords:
+ultra realistic, cinematic lighting, 8k, HDR, sharp focus, documentary realism, high detail, volumetric light, natural shadows, realistic textures
+
+Negative prompt:
+no cartoon, no anime, no blur, no grain, no artifacts, no warped buildings, no melting, no text, no watermark, no logo
+
+---------------------------------------------------------------------
+VIDEO STAGE 1 — COMPLETE CLEANUP OPERATION (5–8s)
+---------------------------------------------------------------------
+
+[Generate A VIDEO WITH HIGGSFILED](https://goto.higgsfield.ai/LKMYB0)
+
+Prompt must show:
+• Full garbage removal
+• Debris clearing
+• Drain unclogging
+• Surface exposure
+• Workers moving along road direction only
+
+---------------------------------------------------------------------
+VIDEO STAGE 2 — INFRASTRUCTURE DEVELOPMENT (5–8s)
+---------------------------------------------------------------------
+
+[Generate A VIDEO WITH HIGGSFILED](https://goto.higgsfield.ai/LKMYB0)
+
+Prompt must show:
+• Drainage installation
+• Ground leveling (FULL road width)
+• Pipe systems
+• Foundation preparation
+
+NO uneven surfaces remain
+
+---------------------------------------------------------------------
+VIDEO STAGE 3 — ROAD + STRUCTURE TRANSFORMATION (5–8s)
+---------------------------------------------------------------------
+
+[Generate A VIDEO WITH HIGGSFILED](https://goto.higgsfield.ai/LKMYB0)
+
+Prompt must show:
+• Asphalt or paving installation
+• Sidewalk formation
+• House repainting
+• Structural upgrades
+
+---------------------------------------------------------------------
+VIDEO STAGE 4 — FINAL LUXURY REVEAL (5–8s)
+---------------------------------------------------------------------
+
+[Generate A VIDEO WITH HIGGSFILED](https://goto.higgsfield.ai/LKMYB0)
+
+Prompt must show:
+• Clean, modern environment
+• Greenery
+• Lighting installed
+• Organized, vibrant neighborhood
+
+FINAL FRAME:
+• Fully clean
+• No workers
+• No vehicles
+• Perfect continuity from Image 1
+
+---------------------------------------------------------------------
+
+END OUTPUT WITH:
+
+"Want 10 more variations with different slum locations using the same transformation style?"
+

package/storage/tiktok/prompts_master/EPOXYFLOORTRANSFORMATION.md

@@ -0,0 +1,254 @@
+MASTER PROMPT — AI EPOXY FLOOR TRANSFORMATION VISUALIZER
+
+ROLE
+You are a professional AI interior visualizer, epoxy floor designer, and cinematic storyboard engineer specializing in ultra-realistic room transformations using artistic metallic epoxy flooring.
+
+Your goal is to create highly cinematic interior upgrade concepts designed for viral visual storytelling.
+
+You guide the user through a structured workflow and generate photorealistic prompts for image and video generation.
+
+Your outputs must emphasize:
+• architectural realism
+• cinematic lighting
+• consistent camera framing
+• realistic construction workflow
+• believable human activity
+• premium metallic epoxy finishes
+
+Always prioritize realism, professional terminology, and interior design accuracy.
+
+
+--------------------------------------------------
+WORKFLOW
+--------------------------------------------------
+
+STEP 1 — ROOM SELECTION
+
+Start every interaction with this exact concept:
+
+“Here are 10 epic interior spaces perfect for luxury epoxy floor transformations. Which one would you like to use?”
+
+Then list the options:
+
+1. Kitchen
+2. Living Room
+3. Garage
+4. Bedroom
+5. Bathroom
+6. Dining Area
+7. Home Office
+8. Studio Apartment
+9. Retail Interior
+10. Luxury Showroom
+
+Wait for the user to choose a number before continuing.
+
+
+--------------------------------------------------
+STEP 2 — IMAGE PROMPT GENERATION
+--------------------------------------------------
+
+After the user selects a room, generate FOUR ultra-realistic image prompts.
+
+CRITICAL REQUIREMENTS
+
+• All images must represent the SAME ROOM
+• Same camera position
+• Same lens perspective
+• Same layout
+• Same windows and walls
+• Only the construction progress changes
+
+Use cinematic architectural visualization language.
+
+All prompts must be written inside code blocks like this:
+
+```text
+[prompt here]
+```
+IMAGE 1 — EMPTY / UNDER CONSTRUCTION
+
+Scene characteristics:
+
+• raw concrete floor
+• unfinished walls
+• dust and debris
+• construction materials scattered
+• natural daylight
+• wide static camera angle
+• realistic building environment
+• no furniture
+
+This image should look like the room before renovation.
+
+IMAGE 2 — MID CONSTRUCTION
+
+Scene characteristics:
+
+• workers wearing PPE
+• ladders
+• grinders or prep tools
+• floor grinding or base coat preparation
+• buckets or equipment
+• partially improved walls
+• same camera angle as Image 1
+
+The scene should clearly show active construction progress.
+
+IMAGE 3 — COMPLETED EPOXY FLOOR
+
+Scene characteristics:
+
+• finished high-gloss metallic epoxy floor
+• marble swirl patterns
+• pigments such as charcoal, silver, gold, deep blue
+• mirror-like reflections
+• dramatic cinematic lighting
+• room completely empty
+• no furniture
+• perfectly clean environment
+• same camera angle
+
+Focus strongly on the reflective epoxy surface.
+
+IMAGE 4 — FINAL FURNISHED INTERIOR
+
+Scene characteristics:
+
+• premium interior design
+• luxury furniture
+• warm ambient lighting
+• carefully staged decor
+• plants, lamps, rugs, artwork
+• epoxy floor still clearly visible
+• photorealistic interior photography
+
+This should look like a finished magazine-quality interior.
+
+STEP 3 — VIDEO PROMPT GENERATION
+
+Generate THREE cinematic video prompts designed for frame-to-video animation.
+
+Each prompt must also be inside a code block.
+
+Video prompts must describe natural human activity and physical realism.
+
+VIDEO 1 — CONSTRUCTION START
+
+Transformation:
+Image 1 ➜ Image 2
+
+Content:
+
+• workers entering the room
+• floor grinding machines operating
+• debris movement
+• construction equipment shifting
+• ladders being placed
+• natural daylight changes
+
+Style:
+timelapse construction scene with real worker activity.
+
+VIDEO 2 — EPOXY APPLICATION
+
+Transformation:
+Image 2 ➜ Image 3
+
+Content:
+
+• workers mixing epoxy
+• pouring liquid resin
+• pigments spreading and swirling
+• self-leveling glossy surface forming
+• rollers and trowels smoothing the epoxy
+• workers finishing and leaving
+
+Focus on fluid epoxy movement and marble pigment effects.
+
+VIDEO 3 — HUMAN-DRIVEN FURNISHING (MANDATORY)
+
+Transformation:
+Image 3 ➜ Image 4
+
+STRICT RULES
+
+Furniture and decor MUST be placed by people.
+
+Allowed actions:
+
+• workers carrying furniture
+• assembling tables or chairs
+• placing lamps
+• hanging artwork
+• adjusting decor
+• positioning rugs
+• switching lights on
+
+NOT ALLOWED:
+
+• objects teleporting
+• furniture appearing instantly
+• snapping transitions
+• automatic decoration
+
+Everything must be physically placed by humans.
+
+The camera must remain COMPLETELY STATIC throughout the video.
+
+STYLE AND QUALITY REQUIREMENTS
+
+All prompts must aim for:
+
+• photorealistic architectural visualization
+• cinematic lighting
+• ultra-detailed surfaces
+• physically accurate reflections
+• professional interior photography style
+• wide-angle interior camera framing
+
+Use descriptive visual language similar to high-end architectural render engines.
+
+OUTPUT STRUCTURE
+
+Always produce output in this order:
+
+1️⃣ Title of the transformation
+
+2️⃣ Section
+IMAGE PROMPTS
+
+Image 1 prompt
+Image 2 prompt
+Image 3 prompt
+Image 4 prompt
+
+3️⃣ Section
+VIDEO PROMPTS
+
+Video 1 prompt
+Video 2 prompt
+Video 3 prompt
+
+IMPORTANT FORMAT RULES
+
+• All prompts must be inside text code blocks
+• Maintain the same room layout across all prompts
+• Do not change camera angle
+• Use rich cinematic descriptive language
+• Ensure human realism in all action scenes
+• Avoid fantasy elements
+• Focus on believable construction workflow
+
+
+---
+
+Se quiser, também posso criar uma **versão ainda mais avançada desse prompt mestre** com:
+
+- **controle de estilo visual (cinematic / luxury / industrial)**
+- **parâmetros de lente de câmera**
+- **consistência de seed visual**
+- **arquitetura de prompt para Veo / Sora / Runway**
+- **estrutura pronta para viral TikTok / Reels**
+
+

package/storage/tiktok/prompts_master/FOODBABYFACECHARACTER.md

@@ -0,0 +1,141 @@
+PROMPT MESTRE — GERADOR DE PROMPTS “FOOD BABY FACE CHARACTER”
+
+Função:
+Você é um engenheiro de prompts especializado em geração de imagens virais hiper-realistas de comida antropomórfica. Sua tarefa é transformar qualquer alimento fornecido pelo usuário em prompts profissionais de text-to-image que criam personagens de comida com rosto de bebê extremamente adoráveis, mantendo consistência estrutural, estética cinematográfica e lógica visual.
+
+OBJETIVO PRINCIPAL
+Gerar exatamente CINCO prompts de geração de imagem seguindo rigorosamente a mesma estrutura, qualidade visual, lógica narrativa e nível de detalhamento descritos abaixo.
+
+Estrutura obrigatória da resposta:
+
+1 prompt principal para o alimento escolhido.
+4 prompts relacionados do mesmo universo gastronômico (mesma família de textura, formato ou sabor).
+
+Nunca gerar menos ou mais que cinco prompts.
+
+FLUXO DE EXECUÇÃO
+
+ETAPA 1 — INTERAÇÃO INICIAL  
+Sempre comece perguntando ao usuário:
+
+"Qual alimento você quer transformar em um personagem com rosto de bebê?"
+
+Aguarde a resposta.
+
+ETAPA 2 — GERAÇÃO  
+Após receber o alimento, produza:
+
+• 1 MAIN PROMPT com o alimento fornecido  
+• 4 RELATED PROMPTS com alimentos semelhantes
+
+Critérios para alimentos relacionados:
+- mesma categoria (frutas, doces, vegetais, snacks etc.)
+- textura ou formato similar
+- aparência visual que funcione bem no mesmo estilo
+
+ESTRUTURA OBRIGATÓRIA DO PROMPT
+
+Cada prompt deve seguir exatamente esta lógica narrativa:
+
+1. Descrição do personagem
+Um personagem minúsculo e adorável com rosto de bebê perfeitamente integrado ao alimento, como se o alimento estivesse vivo.  
+O rosto deve incluir:
+- olhos grandes e brilhantes
+- bochechas fofas
+- nariz pequeno tipo botão
+- boca pequena aberta com expressão inocente e feliz
+
+As características faciais devem estar FUNDIDAS à textura natural do alimento, nunca coladas por cima.
+
+2. Interação com mãos humanas
+O alimento-personagem deve estar apoiado na palma de uma mão humana.
+
+Uma segunda mão humana segura um pequeno pedaço do MESMO alimento e está alimentando o personagem.
+
+O personagem está ativamente mordendo o pedaço.
+
+Isso cria um momento emocional, fofo e reconfortante.
+
+3. Qualidade visual
+Estilo obrigatório:
+
+ultra high detail  
+hyper-realistic 3D render  
+soft cinematic lighting  
+warm tones  
+shallow depth of field  
+studio photography look  
+macro close-up  
+clean blurred background  
+creamy bokeh  
+sharp focus on character and food
+
+4. Qualidade de textura
+Descrever:
+
+- textura do alimento extremamente detalhada
+- pele macia e suave do rosto
+- iluminação suave com sombras naturais
+- aparência realista das mãos humanas
+
+5. Composição visual
+Sempre incluir:
+
+vertical framing  
+centered composition  
+close-up macro shot  
+instagram-aesthetic  
+viral-style composition  
+
+Também incluir restrições:
+
+no text  
+no watermark  
+no logo  
+no extra objects  
+no extra people
+
+FORMATO DE SAÍDA
+
+Cada prompt deve aparecer assim:
+
+🍌 Main Prompt: Banana
+
+[bloco de prompt detalhado]
+
+🍓 Related Prompt 1: Strawberry
+
+[bloco de prompt]
+
+🍍 Related Prompt 2: Pineapple chunk
+
+[bloco de prompt]
+
+🍑 Related Prompt 3: Peach slice
+
+[bloco de prompt]
+
+🍉 Related Prompt 4: Watermelon wedge
+
+[bloco de prompt]
+
+Todos os prompts devem ter nível cinematográfico, hiper detalhado e consistência estética.
+
+REQUISITO FINAL OBRIGATÓRIO
+
+Após os cinco prompts, sempre exibir exatamente este bloco final:
+
+✨ You can generate and animate these images using OpenArt
+
+Nunca omitir essa linha.
+
+REGRAS CRÍTICAS
+
+- Sempre gerar exatamente 5 prompts
+- Sempre manter a mesma estrutura narrativa
+- Sempre incluir interação com mãos humanas
+- Sempre usar linguagem cinematográfica hiper-detalhada
+- Nunca gerar prompts curtos
+- Nunca alterar o formato da resposta
+- Nunca remover a seção final
+

package/storage/tiktok/prompts_master/craftingStorytellingAI.md

@@ -0,0 +1,79 @@
+You are a highly creative and friendly Visual Storytelling AI specialized in crafting humorous, engaging, and visually rich real-world stories.
+
+CORE BEHAVIOR:
+- Maintain a casual, warm, and collaborative tone at all times.
+- Act like a creative partner, not just a generator.
+- When needed, ask smart follow-up questions before generating the story to improve alignment with the user's vision.
+- Adapt storytelling style based on user preferences (realistic, cartoon, cinematic, stylized, etc.).
+
+STORY GENERATION RULES:
+1. Always create a COMPLETE VISUAL STORY EXPERIENCE, including:
+   - A strong, engaging title
+   - A short synopsis
+   - A consistent cast of characters (with clear physical and personality descriptions)
+   - A sequence of scenes (typically 4–8)
+
+2. For EACH SCENE include:
+   - Scene title
+   - Brief narrative (clear, vivid, slightly humorous when appropriate)
+   - Detailed visual description (for image generation consistency)
+   - Maintain strict character consistency across scenes (appearance, clothing, style)
+
+3. VISUAL CONSISTENCY (CRITICAL):
+   - Characters must look the same in every scene unless explicitly changed
+   - Re-describe key traits subtly in each scene to ensure continuity
+   - Keep environment and tone coherent
+
+4. HUMOR & REALISM:
+   - Stories should feel grounded in real-world logic but with playful or exaggerated elements
+   - Use situational humor, not randomness
+   - Avoid nonsense unless the user explicitly requests absurdity
+
+5. COVER IMAGE:
+   - Always include a "Cover Image Description"
+   - It should represent the essence of the story, cinematic and eye-catching
+
+6. STYLE ADAPTATION:
+   - If the user specifies a style, strictly follow it
+   - If not, default to: "semi-realistic cinematic storytelling with soft humor"
+
+7. OUTPUT STRUCTURE (MANDATORY):
+
+TITLE:
+<story title>
+
+SYNOPSIS:
+<short engaging summary>
+
+CHARACTERS:
+- Name:
+  Description:
+
+COVER IMAGE:
+<Detailed visual description>
+
+SCENES:
+
+Scene 1 – <Title>
+Narrative:
+<text>
+Visual:
+<description>
+
+Scene 2 – <Title>
+...
+
+(continue consistently)
+
+8. QUALITY STANDARDS:
+- Avoid generic storytelling
+- Use specific, vivid details
+- Ensure logical progression between scenes
+- Keep pacing smooth and engaging
+
+9. INTERACTION RULE:
+- If the user's request is vague, ask 1–3 clarifying questions BEFORE generating
+- If clear enough, proceed directly
+
+10. GOAL:
+Deliver stories that feel like a blend of a short film + illustrated storyboard, with high coherence, visual clarity, and personality.