@danhachuel/thunderbolt 0.2.18 → 0.2.19

package/MANUAL-INSTALACAO.md

@@ -2,7 +2,7 @@
 
 Este manual descreve a instalação local da UI Thunderbolt, baseada no MoneyPrinterTurbo, utilizando o pacote npm `@danhachuel/thunderbolt`. O fluxo recomendado instala automaticamente o ambiente Python, as dependências da aplicação, as dependências do MoneyPrinterTurbo, o Streamlit e o suporte FFmpeg através de `imageio-ffmpeg`.
 
-> **Versão deste manual:** 0.2.18
+> **Versão deste manual:** 0.2.19
 > **Pacote npm:** `@danhachuel/thunderbolt`
 > **Porta padrão da UI:** `localhost:3030`  
 > **Repositório:** [github.com/DanHachuel/thunderbolt](https://github.com/DanHachuel/thunderbolt)
@@ -100,13 +100,13 @@ Execute:
 Windows PowerShell ou MobaXterm:
 
 ```powershell
-npx.cmd --yes @danhachuel/thunderbolt@0.2.18 install
+npx.cmd --yes @danhachuel/thunderbolt@0.2.19 install
 ```
 
 Linux/macOS:
 
 ```bash
-npx --yes @danhachuel/thunderbolt@0.2.18 install
+npx --yes @danhachuel/thunderbolt@0.2.19 install
 ```
 
 A instalação normal é **segura para actualizações**: preserva `storage`, Blueprints, Brandings, configurações e artefactos do utilizador. Remove apenas `.venv`, o clone técnico do MoneyPrinterTurbo e dependências que serão recriadas. Uma pasta antiga sem dados do utilizador, como `C:\Users\<utilizador>\AppData\Local\hermes` da tentativa incompleta, pode ser removida; uma pasta antiga que contenha Blueprints, Brandings ou storage é preservada e apenas avisada no terminal. Feche processos Python, Node, Streamlit e MobaXterm que estejam a usar as pastas antes de executar.
@@ -367,8 +367,16 @@ Após iniciar a aplicação, valide o seguinte percurso:
 7. **Upload:** autorize primeiro o **youtube-automation-agent** na própria aba, confirme o estado **pronto para publicar**, preencha título/descrição/tags e publique um MP4 real. O botão **Autorizar fallback OAuth** existe apenas para redundância; a Data API Key é exclusivamente para consultas públicas.
 8. **Limpador de metadado:** suba um vídeo de terceiro, preencha título, preview, links, timestamps e tags, aplique a limpeza e descarregue a cópia limpa e o manifesto JSON. O original fica preservado e vídeos da aba Novo vídeo não são aceites nesta área.
 9. **Configurações:** confirme que os caminhos e credenciais estão locais e não aparecem no Git.
+10. **MCP:** confirme que Short Video Maker, AutoVio, OpenMontage e OpenCut aparecem com as portas padrão editáveis. O estado **Activo** é apenas uma preferência local; a detecção deve indicar **Não detectado** quando os serviços externos não estiverem instalados ou iniciados.
+11. **Skill MCP:** clique em **Guardar skill localmente** e confirme o ficheiro em `storage/skills/moneyprinterturbo-video.md`; opcionalmente use **Descarregar skill .md** para obter a cópia através do navegador.
 
-## 10. Limpador de metadado
+## MCP e integrações externas
+
+A aba **MCP** é um configurador local de quatro serviços opcionais. As portas iniciais são `3123` para Short Video Maker, `3001` para AutoVio, `8000` como referência editável para OpenMontage e `8787` para a API do OpenCut. A página consulta apenas `http://127.0.0.1:<porta>/` com timeout curto; não clona, instala ou inicia processos externos.
+
+O botão **Guardar skill localmente** copia a skill anexada para `storage/skills/`. Esta pasta fica fora dos estados JSON e é criada pelo instalador e pelo launcher. Os quatro repositórios continuam fora do pacote npm.
+
+## 11. Limpador de metadado
 
 A aba **Limpador de metadado** recebe somente vídeos externos já prontos. O ficheiro enviado é copiado para `storage/metadata_cleaner/originals/`; a aplicação não altera o original. Ao aplicar a operação, o FFmpeg remove os metadados existentes do contentor e cria uma nova versão em `storage/metadata_cleaner/outputs/` com o título, descrição, tags, idioma e outros campos preenchidos.
 

package/README.md

@@ -17,6 +17,7 @@ A primeira versão implementa a camada UI independente com:
 | Canais | Subabas de importação pública sem API Key, Data API opcional e cadastro manual independente |
 | Novo vídeo | Subabas Criar vídeo e Vídeos; canal específico, lote no mesmo canal, lote geral, filtro de estados e controlos iniciar/parar |
 | Upload | YouTube via `youtube-automation-agent` adaptado internamente, OAuth directo de redundância, TikTok e diagnóstico |
+| MCP | Catálogo local opcional de Short Video Maker, AutoVio, OpenMontage e OpenCut, com portas editáveis e activação |
 | Limpador de metadado | Upload isolado de vídeos terceiros, limpeza FFmpeg, edição de título/descrição/tags e manifesto JSON |
 | Configurações | Provedores LLM, TTS/voz, materiais, Whisper, FFmpeg, YouTube, TikTok Client ID/Secret e Upload-Post |
 | Launcher | Execução via `npx`, instalação assistida, diagnóstico e preparação para distribuição |
@@ -102,9 +103,9 @@ thunderbolt
 No Windows PowerShell, se `npx` for bloqueado por `npx.ps1`, use directamente `npx.cmd`:
 
 ```powershell
-npx.cmd --yes @danhachuel/thunderbolt@0.2.18 install
-npx.cmd --yes @danhachuel/thunderbolt@0.2.18 doctor
-npx.cmd --yes @danhachuel/thunderbolt@0.2.18
+npx.cmd --yes @danhachuel/thunderbolt@0.2.19 install
+npx.cmd --yes @danhachuel/thunderbolt@0.2.19 doctor
+npx.cmd --yes @danhachuel/thunderbolt@0.2.19
 ```
 
 Como alternativa, pode permitir scripts para o seu utilizador:
@@ -173,6 +174,14 @@ Na aba **Upload**, configure primeiro o **YouTube OAuth Client ID** e o **YouTub
 
 Use **Autorizar fallback OAuth** apenas se precisar de uma autorização separada para o caminho de redundância. Os resultados guardam no histórico local qual mecanismo foi utilizado e as tentativas realizadas, sem guardar segredos.
 
+## MCP e integrações externas opcionais
+
+A aba **MCP** funciona como um catálogo local de clientes externos. Ela lista **Short Video Maker**, **AutoVio**, **OpenMontage** e **OpenCut** com os respectivos links oficiais, protocolo/capacidade conhecida, porta local editável e toggle **Activo**. Os repositórios não são clonados, instalados ou incluídos no pacote npm do Thunderbolt.
+
+As portas iniciais são `3123` para Short Video Maker, `3001` para a API backend do AutoVio, `8000` como referência editável para OpenMontage — que não documenta uma porta HTTP padrão — e `8787` para a API do OpenCut, cujo frontend de desenvolvimento usa `5173`. A detecção é passiva: apenas consulta `localhost` e nunca inicia processos externos. Activar uma integração guarda a preferência local; não substitui a instalação/configuração do serviço externo.
+
+A mesma aba permite **Guardar skill localmente**, copiando `moneyprinterturbo-video.md` para `storage/skills/`, e **Descarregar skill .md** através do navegador. A skill é um recurso separado dos quatro repositórios externos.
+
 ## TikTok
 
 A subaba **Vídeos**, dentro de **Novo vídeo**, mostra o backlog e permite iniciar/parar tarefas; deixou de existir como botão principal na barra lateral.

package/app/main.py

@@ -18,10 +18,66 @@ from hermes_ui.domain import STAGES, create_batch, create_channel, create_tasks_
 from hermes_ui.storage import BLUEPRINTS, ensure_storage, list_blueprint_files, load_blueprint_file, now, read_json, write_json
 from hermes_ui.blueprints import create_blueprint_from_link, list_branding_files, save_generated_blueprint
 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.mcp import detect_local_service, install_skill_locally, load_integrations, read_packaged_skill, update_integration
 from integrations.platforms import IntegrationResult, TikTokAdapter, YouTubeAdapter
 from integrations.local_runtime import MoneyPrinterRuntime
 from integrations.moneyprinter_config import sync_moneyprinter_config
 
+VIDEO_LANGUAGE_OPTIONS = [
+    "00 – Apenas Música de Fundo (Sem Falas)",
+    "01 – Inglês",
+    "02 – Norueguês",
+    "03 – Dinamarquês",
+    "04 – Sueco",
+    "05 – Holandês",
+    "06 – Alemão",
+    "07 – Luxemburguês",
+    "08 – Finlandês",
+    "09 – Hebraico",
+    "10 – Japonês",
+    "11 – Árabe (Golfo)",
+    "12 – Islandês",
+    "13 – Espanhol (Espanha)",
+    "14 – Francês",
+    "15 – Italiano",
+    "16 – Coreano",
+    "16 – Irlandês",
+    "17 – Estoniano",
+    "18 – Grego",
+    "19 – Esloveno",
+    "20 – Polonês",
+    "21 – Tcheco",
+    "22 – Lituano",
+    "23 – Português (Portugal)",
+    "24 – Eslovaco",
+    "25 – Letão",
+    "26 – Ucraniano",
+    "27 – Húngaro",
+    "28 – Afrikaans",
+    "29 – Turco",
+    "30 – Romeno",
+    "31 – Russo",
+    "32 – Croata",
+    "33 – Árabe (Magreb)",
+    "34 – Sérvio",
+    "35 – Búlgaro",
+    "36 – Português (Brasil)",
+    "37 – Cantonês",
+    "38 – Persa (Farsi)",
+    "39 – Mandarim",
+    "40 – Malaio",
+    "41 – Espanhol (LatAm)",
+    "42 – Vietnamita",
+    "43 – Filipino (Tagalog)",
+    "44 – Indonésio",
+    "45 – Malayalam",
+    "46 – Tailandês",
+    "47 – Télugo",
+    "48 – Tamil",
+    "49 – Bengali",
+    "50 – Hausa",
+]
+
 ensure_storage()
 st.set_page_config(page_title="Thunderbolt", page_icon="T", layout="wide", initial_sidebar_state="expanded")
 
@@ -338,7 +394,15 @@ def render_new_video():
             with st.form("new_video_form"):
                 topic = st.text_area("Tópico ou briefing", placeholder="Ex.: A história pouco conhecida por trás de...")
                 quantity = st.number_input("Quantidade", min_value=1, max_value=100, value=1, disabled=mode != "same_channel")
-                language = st.selectbox("Idioma", ["Português", "English", "Español"], key="video_language")
+                legacy_language = st.session_state.get("video_language")
+                legacy_language_map = {
+                    "Português": "36 – Português (Brasil)",
+                    "English": "01 – Inglês",
+                    "Español": "41 – Espanhol (LatAm)",
+                }
+                if legacy_language not in VIDEO_LANGUAGE_OPTIONS:
+                    st.session_state["video_language"] = legacy_language_map.get(legacy_language, VIDEO_LANGUAGE_OPTIONS[0])
+                language = st.selectbox("Idioma", VIDEO_LANGUAGE_OPTIONS, key="video_language")
                 fmt = st.selectbox("Formato", ["wide", "shorts", "music"])
                 style = st.selectbox("Estilo wide", ["pexels", "full_ia"])
                 submitted = st.form_submit_button("Criar tarefas", type="primary")
@@ -620,6 +684,77 @@ def render_settings():
                 st.warning(f"Configurações locais guardadas, mas não foi possível sincronizar config.toml: {exc}")
 
 
+def render_mcp():
+    st.title("MCP")
+    st.caption("Clientes opcionais para serviços externos. Os repositórios não são instalados nem incluídos no pacote Thunderbolt.")
+    st.info("Activar uma integração guarda apenas a preferência local. O Thunderbolt não inicia processos externos automaticamente; a detecção verifica passivamente se existe um serviço já disponível na porta configurada.")
+
+    integrations = load_integrations()
+    for integration in integrations:
+        integration_id = integration["id"]
+        with st.container(border=True):
+            header_cols = st.columns([2.6, 1.15, 1.65, 1.2])
+            with header_cols[0]:
+                st.write(f"**{integration['name']}**")
+                st.caption(f"{integration['protocol']} · {integration['description']}")
+                st.markdown(f"[Abrir repositório oficial]({integration['repository']})")
+            with header_cols[1]:
+                port = st.number_input(
+                    "Porta",
+                    min_value=1,
+                    max_value=65535,
+                    value=int(integration.get("port", 8000)),
+                    step=1,
+                    key=f"mcp_port_{integration_id}",
+                )
+            with header_cols[2]:
+                status = detect_local_service({**integration, "port": port})
+                if status["available"]:
+                    st.success("Disponível")
+                else:
+                    st.caption("Não detectado")
+                st.caption(status["message"])
+            with header_cols[3]:
+                active = st.toggle("Activo", value=bool(integration.get("active", False)), key=f"mcp_active_{integration_id}")
+                if active != bool(integration.get("active", False)):
+                    update_integration(integration_id, active=active)
+                    st.rerun()
+
+            st.caption(integration.get("endpoint_note", "Porta editável para o serviço local."))
+            if st.button("Guardar porta", key=f"mcp_save_port_{integration_id}", use_container_width=True):
+                update_integration(integration_id, port=int(port))
+                st.success(f"Porta de {integration['name']} guardada: {int(port)}")
+                st.rerun()
+
+    st.divider()
+    st.subheader("Skill MoneyPrinterTurbo")
+    st.caption("A skill anexada pode ser guardada na pasta local do Thunderbolt ou descarregada como ficheiro Markdown. Nenhum dos quatro repositórios externos é copiado para o pacote.")
+    skill_cols = st.columns(2)
+    with skill_cols[0]:
+        if st.button("Guardar skill localmente", type="primary", use_container_width=True, key="mcp_install_mpt_skill"):
+            try:
+                destination = install_skill_locally()
+                st.success(f"Skill guardada em `{destination}`")
+            except (FileNotFoundError, OSError) as exc:
+                st.error(f"Não foi possível guardar a skill: {exc}")
+    with skill_cols[1]:
+        try:
+            skill_data = read_packaged_skill()
+        except FileNotFoundError:
+            skill_data = None
+        if skill_data is not None:
+            st.download_button(
+                "Descarregar skill .md",
+                data=skill_data,
+                file_name="moneyprinterturbo-video.md",
+                mime="text/markdown",
+                use_container_width=True,
+                key="mcp_download_mpt_skill",
+            )
+        else:
+            st.warning("A skill ainda não está disponível nesta instalação.")
+
+
 def render_metadata_cleaner():
     st.title("Limpador de metadado")
     st.caption("Limpeza e edição de metadados para vídeos de terceiros que já estão prontos.")
@@ -756,6 +891,7 @@ def main():
         ("Canais", ":material/ondemand_video:", "Canais"),
         ("Novo vídeo", ":material/add_circle:", "Novo vídeo"),
         ("Upload", ":material/cloud_upload:", "Upload"),
+        ("MCP", ":material/hub:", "MCP"),
         ("Limpador de metadado", ":material/edit_note:", "Limpador de metadado"),
         ("Configurações", ":material/settings:", "Configurações"),
     ]
@@ -777,6 +913,7 @@ def main():
         "Canais": render_channels,
         "Novo vídeo": render_new_video,
         "Upload": render_upload,
+        "MCP": render_mcp,
         "Limpador de metadado": render_metadata_cleaner,
         "Configurações": render_settings,
     }

package/hermes_ui/mcp.py

@@ -0,0 +1,145 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+import requests
+
+from . import storage
+
+
+SKILL_FILENAME = "moneyprinterturbo-video.md"
+
+MCP_DEFAULTS: list[dict[str, Any]] = [
+    {
+        "id": "short-video-maker",
+        "name": "Short Video Maker",
+        "repository": "https://github.com/gyoridavid/short-video-maker",
+        "protocol": "MCP + REST",
+        "description": "Servidor externo para criação de vídeos curtos, com MCP e API REST.",
+        "port": 3123,
+        "active": False,
+        "endpoint_note": "Porta documentada pelo projecto: 3123.",
+    },
+    {
+        "id": "autovio",
+        "name": "AutoVio",
+        "repository": "https://github.com/Auto-Vio/autovio",
+        "protocol": "MCP + REST",
+        "description": "Pipeline externo de vídeo com API REST e servidor MCP separado.",
+        "port": 3001,
+        "active": False,
+        "endpoint_note": "Porta padrão da API backend documentada pelo projecto: 3001.",
+    },
+    {
+        "id": "openmontage",
+        "name": "OpenMontage",
+        "repository": "https://github.com/calesthio/OpenMontage",
+        "protocol": "Agente local",
+        "description": "Sistema externo de produção agentic de vídeo; o README não documenta um servidor MCP/HTTP padrão.",
+        "port": 8000,
+        "active": False,
+        "endpoint_note": "Porta editável de referência; o projecto não documenta uma porta local padrão.",
+    },
+    {
+        "id": "opencut",
+        "name": "OpenCut",
+        "repository": "https://github.com/opencut-app/opencut",
+        "protocol": "API em desenvolvimento",
+        "description": "Editor externo; o README actual indica API/MCP em desenvolvimento e documenta um servidor API local.",
+        "port": 8787,
+        "active": False,
+        "endpoint_note": "Porta padrão da API documentada pelo projecto: 8787; frontend usa 5173.",
+    },
+]
+
+
+def _merge_defaults(saved: Any) -> list[dict[str, Any]]:
+    saved_by_id = {
+        str(item.get("id")): item
+        for item in (saved if isinstance(saved, list) else [])
+        if isinstance(item, dict) and item.get("id")
+    }
+    merged: list[dict[str, Any]] = []
+    for default in MCP_DEFAULTS:
+        item = {**default, **saved_by_id.get(default["id"], {})}
+        try:
+            item["port"] = max(1, min(65535, int(item.get("port", default["port"]))))
+        except (TypeError, ValueError):
+            item["port"] = default["port"]
+        item["active"] = bool(item.get("active", False))
+        merged.append(item)
+    return merged
+
+
+def load_integrations() -> list[dict[str, Any]]:
+    return _merge_defaults(storage.read_json("mcp_integrations.json", MCP_DEFAULTS))
+
+
+def save_integrations(integrations: list[dict[str, Any]]) -> None:
+    cleaned: list[dict[str, Any]] = []
+    allowed = {item["id"] for item in MCP_DEFAULTS}
+    for item in integrations:
+        if not isinstance(item, dict) or item.get("id") not in allowed:
+            continue
+        copy = dict(item)
+        try:
+            copy["port"] = max(1, min(65535, int(copy.get("port", 1))))
+        except (TypeError, ValueError):
+            continue
+        copy["active"] = bool(copy.get("active", False))
+        cleaned.append(copy)
+    storage.write_json("mcp_integrations.json", _merge_defaults(cleaned))
+
+
+def update_integration(integration_id: str, **updates: Any) -> list[dict[str, Any]]:
+    integrations = load_integrations()
+    for item in integrations:
+        if item.get("id") == integration_id:
+            item.update(updates)
+            break
+    save_integrations(integrations)
+    return load_integrations()
+
+
+def detect_local_service(integration: dict[str, Any], timeout: float = 0.35) -> dict[str, Any]:
+    """Detecta apenas um serviço local já iniciado; nunca inicia ou instala processos."""
+    port = integration.get("port")
+    try:
+        port = int(port)
+    except (TypeError, ValueError):
+        return {"available": False, "message": "Porta inválida."}
+    try:
+        response = requests.get(f"http://127.0.0.1:{port}/", timeout=timeout)
+        return {
+            "available": True,
+            "message": f"Serviço respondeu em localhost:{port} (HTTP {response.status_code}).",
+        }
+    except requests.RequestException:
+        return {"available": False, "message": f"Nenhum serviço detectado em localhost:{port}."}
+
+
+def skill_source_path() -> Path:
+    return Path(__file__).resolve().parents[1] / "seed" / "skills" / SKILL_FILENAME
+
+
+def skill_destination_path() -> Path:
+    return storage.STORAGE / "skills" / SKILL_FILENAME
+
+
+def install_skill_locally(*, overwrite: bool = True) -> Path:
+    source = skill_source_path()
+    if not source.exists():
+        raise FileNotFoundError("A skill MoneyPrinterTurbo não está disponível no pacote local.")
+    destination = skill_destination_path()
+    destination.parent.mkdir(parents=True, exist_ok=True)
+    if overwrite or not destination.exists():
+        destination.write_bytes(source.read_bytes())
+    return destination
+
+
+def read_packaged_skill() -> bytes:
+    source = skill_source_path()
+    if not source.exists():
+        raise FileNotFoundError("A skill MoneyPrinterTurbo não está disponível no pacote local.")
+    return source.read_bytes()

package/hermes_ui/storage.py

@@ -21,6 +21,48 @@ DEFAULTS: dict[str, Any] = {
     "batches.json": [],
     "uploads.json": [],
     "metadata_edits.json": [],
+    "mcp_integrations.json": [
+        {
+            "id": "short-video-maker",
+            "name": "Short Video Maker",
+            "repository": "https://github.com/gyoridavid/short-video-maker",
+            "protocol": "MCP + REST",
+            "description": "Servidor externo para criação de vídeos curtos, com MCP e API REST.",
+            "port": 3123,
+            "active": False,
+            "endpoint_note": "Porta documentada pelo projecto: 3123.",
+        },
+        {
+            "id": "autovio",
+            "name": "AutoVio",
+            "repository": "https://github.com/Auto-Vio/autovio",
+            "protocol": "MCP + REST",
+            "description": "Pipeline externo de vídeo com API REST e servidor MCP separado.",
+            "port": 3001,
+            "active": False,
+            "endpoint_note": "Porta padrão da API backend documentada pelo projecto: 3001.",
+        },
+        {
+            "id": "openmontage",
+            "name": "OpenMontage",
+            "repository": "https://github.com/calesthio/OpenMontage",
+            "protocol": "Agente local",
+            "description": "Sistema externo de produção agentic de vídeo; não documenta um servidor MCP/HTTP padrão.",
+            "port": 8000,
+            "active": False,
+            "endpoint_note": "Porta editável de referência; o projecto não documenta uma porta local padrão.",
+        },
+        {
+            "id": "opencut",
+            "name": "OpenCut",
+            "repository": "https://github.com/opencut-app/opencut",
+            "protocol": "API em desenvolvimento",
+            "description": "Editor externo; a documentação actual indica API/MCP em desenvolvimento.",
+            "port": 8787,
+            "active": False,
+            "endpoint_note": "Porta padrão da API documentada pelo projecto: 8787; frontend usa 5173.",
+        },
+    ],
     "settings.json": {
         "port": 3030,
         "moneyprinter_path": "",
@@ -156,7 +198,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 / "metadata_cleaner", STORAGE / "metadata_cleaner" / "outputs"]:
+    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"]:
         path.mkdir(parents=True, exist_ok=True)
     seed_blueprints()
     for filename, default in DEFAULTS.items():