primocode 8.20.0 → 8.21.0

package/lib/act.js

@@ -377,6 +377,7 @@ async function runAct(userPrompt, opts) {
     // usuário — que não tem prompt nenhum para ajustar. É o modelo tropeçando
     // ao escrever o JSON da chamada, e quase sempre acerta na segunda.
     let funcoesQuebradas = 0;
+    let respostasVazias = 0;
     // O teto de tokens é POR MINUTO, somando TODAS as chamadas — o plano, o
     // resumo e cada rodada do loop dividem a mesma cota. Um pedido perfeito
     // estoura se a rodada anterior já gastou o minuto. Encolher não resolve
@@ -457,7 +458,11 @@ async function runAct(userPrompt, opts) {
         // isto o 400 cru do provedor ("Failed to call a function. Please
         // adjust your prompt.") caía na tela de quem não tem prompt nenhum
         // para ajustar.
-        if (streamError && /failed to call a function|failed_generation|tool_use_failed/i.test(String(streamError))
+        // "failed to parse tool call arguments" é a variante nova do mesmo
+        // tropeço: o provedor recusou o JSON que o MODELO gerou. Medido em
+        // produção num "crie um vídeo" — o documento grande saía torto e o
+        // erro cru parava a tarefa com a corrente inteira ainda de pé.
+        if (streamError && /failed to call a function|failed to parse tool call|failed_generation|tool_use_failed/i.test(String(streamError))
             && funcoesQuebradas < 4 && !PARAR) {
             funcoesQuebradas++;
             if (!subagent) console.log(ident(profundidade) + c.dim('  ⎿ o modelo tropeçou na chamada — tentando de novo'));
@@ -506,12 +511,23 @@ async function runAct(userPrompt, opts) {
         // Sem tool_calls: o modelo respondeu e acabou.
         if (!toolCalls.length) {
             finalText = assistantText.trim();
+            // Resposta VAZIA não é resposta: sem tool, sem texto e sem erro é
+            // o modelo grátis engasgando. Cair direto no "parei sem concluir"
+            // jogava a tarefa fora quando repetir a MESMA rodada quase sempre
+            // resolve — visto em produção no primeiro pedido de vídeo.
+            if (!finalText && respostasVazias < 2 && !PARAR) {
+                respostasVazias++;
+                if (!subagent) console.log(ident(profundidade) + c.dim('  ⎿ o modelo respondeu vazio — tentando de novo'));
+                iteration--;
+                continue;
+            }
             if (!subagent) {
                 if (finalText && !streaming) console.log('\n' + c.white(finalText));
                 else if (streaming) process.stdout.write('\n');
             }
             break;
         }
+        respostasVazias = 0;
 
         if (streaming && !subagent) process.stdout.write('\n');
 

package/lib/studio.js

@@ -42,7 +42,7 @@ const BASE = `http://127.0.0.1:${PORTA}`;
 // voz.py é módulo do servidor, não enfeite: sem ele o server.py não importa
 // e o Studio inteiro deixa de subir. Todo arquivo .py do Studio precisa
 // entrar aqui.
-const COPIAVEIS = new Set(['server.py', 'voz.py', 'web', 'ferramentas', 'README.md', 'PRIMOCODE.md']);
+const COPIAVEIS = new Set(['server.py', 'voz.py', 'elevenlabs.py', 'web', 'ferramentas', 'README.md', 'PRIMOCODE.md']);
 
 /**
  * Onde está o Python 3 desta máquina.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "8.20.0",
+  "version": "8.21.0",
   "description": "PrimoCode — agente de engenharia com IA e cursor próprio. Modelos grátis. Cria arquivos, roda comandos, controla navegador e desktop: abre apps, clica em botões e ícones pelo nome, digita e usa atalhos.",
   "main": "bin/primocode.js",
   "bin": {

package/studio/elevenlabs.py

@@ -0,0 +1,142 @@
+"""Voz ElevenLabs — o topo da corrente de narração, quando há chave.
+
+── POR QUE ELA EXISTE ────────────────────────────────────────────────────
+O usuário ouviu a diferença: a narração que ele aprovou nos vídeos veio do
+ElevenLabs, e nenhum motor local chega perto. Este módulo coloca essa voz
+DENTRO do estúdio: com a chave configurada, toda narração — do player, do
+editor e do pré-render em arquivo — sai neural de verdade. Sem chave, nada
+muda: a corrente continua (Piper → Voicebox → Google) como sempre.
+
+── A CHAVE ───────────────────────────────────────────────────────────────
+Duas formas, nesta ordem:
+  1. variável de ambiente ELEVENLABS_API_KEY
+  2. arquivo ~/.primocode/elevenlabs.key (uma linha, só a chave)
+O endpoint POST /api/voz/elevenlabs grava o arquivo pela interface.
+
+── AS VOZES ──────────────────────────────────────────────────────────────
+Catálogo enxuto das vozes prontas da casa (IDs públicos e estáveis), com
+o timbre descrito honestamente. A padrão é a Brian — grave, de locução —
+porque abertura de vídeo pede peso. Todas falam português no modelo
+multilingual. `doc.voz.voz` escolhe pelo id daqui OU por um voice_id cru
+do ElevenLabs (quem tem voz clonada usa o ID dela direto).
+"""
+
+import json
+import os
+import urllib.request
+
+ARQUIVO_CHAVE = os.path.join(os.path.expanduser("~"), ".primocode", "elevenlabs.key")
+API = "https://api.elevenlabs.io/v1"
+MODELO = "eleven_multilingual_v2"
+# mp3_44100_128 é CBR: a duração sai do tamanho (bytes/16000), sem depender
+# de biblioteca de áudio para ler metadados.
+FORMATO = "mp3_44100_128"
+BYTES_POR_SEGUNDO = 16000.0
+
+CATALOGO = [
+    {"id": "brian",  "nome": "Brian",  "tom": "grave, de locução — é a padrão", "grave": True,
+     "voice_id": "nPczCjzI2devNBz1zQrb"},
+    {"id": "daniel", "nome": "Daniel", "tom": "grave, de noticiário", "grave": True,
+     "voice_id": "onwK4e9ZLuTAKqWW03F9"},
+    {"id": "bill",   "nome": "Bill",   "tom": "maduro, acolhedor",
+     "voice_id": "pqHfZKP75CvOlQylNhV4"},
+    {"id": "liam",   "nome": "Liam",   "tom": "jovem, energia de redes sociais",
+     "voice_id": "TX3LPaxmHKxFdv7VOQHJ"},
+    {"id": "adam",   "nome": "Adam",   "tom": "firme, dominante", "grave": True,
+     "voice_id": "pNInz6obpgDQGcFmaJgB"},
+    {"id": "sarah",  "nome": "Sarah",  "tom": "feminina, suave e profissional",
+     "voice_id": "EXAVITQu4vr4xnSDxMaL"},
+    {"id": "alice",  "nome": "Alice",  "tom": "feminina, clara e confiante",
+     "voice_id": "Xb7hH8MSUJpSbSDYk0k2"},
+]
+POR_ID = {v["id"]: v for v in CATALOGO}
+PADRAO = "brian"
+
+
+def chave():
+    k = (os.environ.get("ELEVENLABS_API_KEY") or "").strip()
+    if k:
+        return k
+    try:
+        with open(ARQUIVO_CHAVE, encoding="utf-8") as fh:
+            return fh.read().strip() or None
+    except OSError:
+        return None
+
+
+def configurado():
+    return bool(chave())
+
+
+def gravar_chave(k):
+    """Grava (ou apaga, com string vazia) a chave da interface."""
+    os.makedirs(os.path.dirname(ARQUIVO_CHAVE), exist_ok=True)
+    k = str(k or "").strip()
+    if not k:
+        try:
+            os.remove(ARQUIVO_CHAVE)
+        except OSError:
+            pass
+        return {"ok": True, "configurado": False}
+    with open(ARQUIVO_CHAVE, "w", encoding="utf-8") as fh:
+        fh.write(k)
+    try:
+        os.chmod(ARQUIVO_CHAVE, 0o600)      # a chave é segredo do usuário
+    except OSError:
+        pass
+    return {"ok": True, "configurado": True}
+
+
+def _voice_id(pedido):
+    """id do catálogo, voice_id cru do ElevenLabs, ou a padrão."""
+    p = str(pedido or "").strip()
+    if p.lower() in POR_ID:
+        return POR_ID[p.lower()]["voice_id"]
+    # voice_id cru: 20 caracteres alfanuméricos é a cara dos IDs deles —
+    # deixa passar qualquer coisa nesse formato (vozes clonadas do usuário).
+    if len(p) >= 16 and p.isalnum():
+        return p
+    return POR_ID[PADRAO]["voice_id"]
+
+
+def sintetizar(texto, voz_cfg=None, timeout=90):
+    """Texto → (bytes de MP3, duração em segundos) — ou (None, None).
+
+    None manda a corrente seguir para o próximo motor; nunca levanta para o
+    chamador, porque narração com um motor a menos ainda é narração.
+    """
+    k = chave()
+    limpo = " ".join(str(texto or "").split())
+    if not k or not limpo:
+        return None, None
+    voz_cfg = voz_cfg if isinstance(voz_cfg, dict) else {}
+    url = "%s/text-to-speech/%s?output_format=%s" % (
+        API, _voice_id(voz_cfg.get("voz")), FORMATO)
+    corpo = json.dumps({
+        "text": limpo[:4900],
+        "model_id": MODELO,
+        "voice_settings": {"stability": 0.5, "similarity_boost": 0.75},
+    }).encode("utf-8")
+    req = urllib.request.Request(url, data=corpo, headers={
+        "xi-api-key": k,
+        "Content-Type": "application/json",
+    })
+    try:
+        with urllib.request.urlopen(req, timeout=timeout) as r:
+            dados = r.read()
+        if not dados or len(dados) < 400:
+            return None, None
+        return dados, round(len(dados) / BYTES_POR_SEGUNDO, 2)
+    except Exception:
+        return None, None
+
+
+def estado():
+    return {
+        "ativo": configurado(),
+        "vozes": [{"id": v["id"], "nome": v["nome"], "tom": v["tom"],
+                   "grave": bool(v.get("grave"))} for v in CATALOGO],
+        "padrao": PADRAO,
+        "como_configurar": "POST /api/voz/elevenlabs {\"chave\":\"...\"} "
+                           "ou variável ELEVENLABS_API_KEY",
+    }

package/studio/ferramentas/corte.md

@@ -141,9 +141,17 @@ na hora de tocar — sem gravar nada, sem arquivo:
 Escolha da voz no **documento** (opcional):
 
 ```json
-"voz": { "voz": "jeff", "grave": true, "velocidade": 1 }
+"voz": { "voz": "brian", "grave": true, "velocidade": 1 }
 ```
 
+**Com o ElevenLabs configurado** (chave em `POST /api/voz/elevenlabs` ou na
+variável `ELEVENLABS_API_KEY`), a narração inteira sobe de nível e as vozes
+passam a ser: `brian` (grave, de locução — padrão) · `daniel` (grave, de
+noticiário) · `adam` (firme) · `bill` (maduro) · `liam` (jovem, redes
+sociais) · `sarah` e `alice` (femininas). Também aceita um voice_id cru do
+ElevenLabs — é assim que a voz clonada do próprio usuário entra. Consulte
+`GET /api/voz/status` para saber o que está ativo nesta máquina.
+
 A síntese é neural e roda na máquina do usuário — offline, sem limite. As
 vozes pt-BR, com a frequência de cada uma medida (menor = mais grave):
 

package/studio/server.py

@@ -56,8 +56,36 @@ except Exception as _e:    # instalação parcial, ou voz.py de uma versão velh
         def apagar():
             return {"ok": True}
 
+        @staticmethod
+        def bloqueado():
+            return "módulo de voz indisponível"
+
     voz_lib = _SemVoz()
 
+try:
+    import elevenlabs as elevenlabs_lib  # noqa: E402
+except Exception as _e:
+    sys.stderr.write("[voz] elevenlabs indisponível (%s)\n" % _e)
+
+    class _SemEleven:
+        @staticmethod
+        def configurado():
+            return False
+
+        @staticmethod
+        def sintetizar(*a, **k):
+            return None, None
+
+        @staticmethod
+        def estado():
+            return {"ativo": False, "vozes": [], "erro": "módulo indisponível"}
+
+        @staticmethod
+        def gravar_chave(*a, **k):
+            return {"ok": False, "erro": "módulo indisponível"}
+
+    elevenlabs_lib = _SemEleven()
+
 WEB = os.path.join(RAIZ, "web")
 ARQUIVOS = os.path.join(RAIZ, "arquivos")
 FERRAMENTAS = os.path.join(RAIZ, "ferramentas")
@@ -312,8 +340,12 @@ def preparar_voz(doc):
     aperta play seria tarde — ele ouviria a voz robótica do Google. Fazê-lo
     aqui, no instante em que o roteiro é gravado, dá ao download a mesma
     janela que o agente gasta escrevendo o resto: quando alguém toca o vídeo,
-    a voz boa já está na máquina. Se não der tempo, a corrente cobre."""
-    if _tem_narracao(doc) and not voz_lib.pronta():
+    a voz boa já está na máquina. Se não der tempo, a corrente cobre.
+
+    Com o ElevenLabs configurado, não há nada para baixar: a síntese é
+    imediata e os 90 MB do Piper ficam para o dia em que faltarem chave ou
+    internet."""
+    if _tem_narracao(doc) and not elevenlabs_lib.configurado() and not voz_lib.pronta():
         try:
             voz_lib.instalar()
         except Exception:
@@ -349,21 +381,24 @@ def _assinatura_voz(texto, voz):
 def _gravar_narracao(arq_id):
     """Sintetiza a narração de cada cena e guarda em midia/."""
     try:
-        # Esperar o motor: são minutos, mas ninguém está esperando na frente
-        # da tela — e o resultado é a diferença entre voz de gente e voz de
-        # robô no vídeo que a pessoa vai apresentar.
-        for _ in range(120):
-            if voz_lib.pronta():
-                break
-            # Máquina onde o Piper nunca vai rodar (binário de outra
-            # arquitetura): esperar 10 minutos aqui era esperar por nada.
-            if voz_lib.bloqueado():
-                sys.stderr.write("[voz] motor neural bloqueado: %s\n" % voz_lib.bloqueado())
+        # Com o ElevenLabs configurado não há o que esperar: a síntese é
+        # imediata e o Piper vira só a reserva do dia sem internet.
+        if not elevenlabs_lib.configurado():
+            # Esperar o motor: são minutos, mas ninguém está esperando na
+            # frente da tela — e o resultado é a diferença entre voz de gente
+            # e voz de robô no vídeo que a pessoa vai apresentar.
+            for _ in range(120):
+                if voz_lib.pronta():
+                    break
+                # Máquina onde o Piper nunca vai rodar (binário de outra
+                # arquitetura): esperar 10 minutos aqui era esperar por nada.
+                if voz_lib.bloqueado():
+                    sys.stderr.write("[voz] motor neural bloqueado: %s\n" % voz_lib.bloqueado())
+                    return
+                voz_lib.instalar()
+                time.sleep(5)
+            if not voz_lib.pronta():
                 return
-            voz_lib.instalar()
-            time.sleep(5)
-        if not voz_lib.pronta():
-            return
 
         a = ler(arq_id)
         if not a:
@@ -386,27 +421,36 @@ def _gravar_narracao(arq_id):
             # vale mais que qualquer síntese.
             if c.get("narracaoAudio") and not c.get("narracaoVoz"):
                 continue
-            try:
-                audio = voz_lib.sintetizar(
-                    texto, voz.get("voz"),
-                    grave=bool(voz.get("grave")),
-                    velocidade=float(voz.get("velocidade") or 1))
-            except Exception as e:
-                sys.stderr.write("[voz] cena %d falhou: %s\n" % (i + 1, e))
-                continue
+            audio, ext, dur = None, ".wav", None
+            # ElevenLabs primeiro, quando há chave: é a voz que o usuário
+            # aprovou. O MP3 dele é CBR — a duração sai do tamanho.
+            if elevenlabs_lib.configurado():
+                audio, dur = elevenlabs_lib.sintetizar(texto, voz)
+                if audio:
+                    ext = ".mp3"
+            if not audio:
+                try:
+                    audio = voz_lib.sintetizar(
+                        texto, voz.get("voz"),
+                        grave=bool(voz.get("grave")),
+                        velocidade=float(voz.get("velocidade") or 1))
+                except Exception as e:
+                    sys.stderr.write("[voz] cena %d falhou: %s\n" % (i + 1, e))
+                    continue
+                if audio:
+                    dur = _duracao_wav(audio)
             if not audio:
                 continue
-            nome = "narr-%s-%d-%s.wav" % (arq_id[:28], i + 1, assinatura)
+            nome = "narr-%s-%d-%s%s" % (arq_id[:28], i + 1, assinatura, ext)
             with open(os.path.join(MIDIA, nome), "wb") as fh:
                 fh.write(audio)
             c["narracaoAudio"] = "/midia/" + nome
             c["narracaoVoz"] = assinatura
-            # A duração medida do WAV vai junto: com ela o player sabe quanto
-            # a cena REALMENTE dura (a fala inteira + respiro) e a linha do
-            # tempo vira determinística — sem ela, o relógio congela na
-            # beirada da cena esperando a voz, e a duração do vídeo muda a
-            # cada reprodução.
-            dur = _duracao_wav(audio)
+            # A duração medida vai junto: com ela o player sabe quanto a cena
+            # REALMENTE dura (a fala inteira + respiro) e a linha do tempo
+            # vira determinística — sem ela, o relógio congela na beirada da
+            # cena esperando a voz, e a duração do vídeo muda a cada
+            # reprodução.
             if dur:
                 c["narracaoDur"] = round(dur, 2)
             mudou = True
@@ -1002,10 +1046,21 @@ class Handler(SimpleHTTPRequestHandler):
         tipo = "audio/mpeg"
         audio = b""
 
-        # 1) Piper: o motor bom. Se ainda não baixou, começa a baixar agora e
-        #    segue para o próximo — quem pediu narração hoje ouve o Google, e
-        #    a partir da próxima já é voz de verdade.
-        if motor not in ("google", "voicebox"):
+        # 0) ElevenLabs: a voz que o usuário aprovou nos vídeos. Só entra na
+        #    corrente quando há chave configurada — e continua caindo para os
+        #    motores locais se falhar, porque narração nunca fica muda.
+        if motor in ("", "elevenlabs") and elevenlabs_lib.configurado():
+            dados, _ = elevenlabs_lib.sintetizar(texto, {"voz": voz_pedida})
+            if dados:
+                audio = dados
+                tipo = "audio/mpeg"
+            elif motor == "elevenlabs":
+                return self.js({"erro": "ElevenLabs não devolveu áudio — chave válida? cota?"}, 502)
+
+        # 1) Piper: o motor local. Se ainda não baixou, começa a baixar agora
+        #    e segue para o próximo — quem pediu narração hoje ouve o Google,
+        #    e a partir da próxima já é voz de verdade.
+        if not audio and motor not in ("google", "voicebox", "elevenlabs"):
             try:
                 if voz_lib.pronta(voz_pedida or None):
                     audio = voz_lib.sintetizar(texto, voz_pedida or None,
@@ -1069,6 +1124,7 @@ class Handler(SimpleHTTPRequestHandler):
             except Exception:
                 vozes = []
         return self.js({
+            "elevenlabs": elevenlabs_lib.estado(),
             "piper": voz_lib.estado(),
             "voicebox": {"ativo": vivo, "vozes": vozes, "site": "https://voicebox.sh"},
             "google": {"ativo": True},
@@ -1219,6 +1275,11 @@ class Handler(SimpleHTTPRequestHandler):
             return self.js(voz_lib.instalar(pedido.get("voz"),
                                             esperar=min(60, int(pedido.get("esperar") or 0))))
 
+        if rota == "/api/voz/elevenlabs":
+            # Grava (ou apaga, com chave vazia) a chave do ElevenLabs. A chave
+            # nunca volta em resposta nenhuma — só o "configurado" volta.
+            return self.js(elevenlabs_lib.gravar_chave(self.corpo().get("chave")))
+
         if rota == "/api/sair":
             # Só o CLI chama, e só quando o código no disco mudou (update do
             # npm). Sem isto o processo antigo ficava no ar servindo o bug que

package/studio/web/core.css

@@ -852,3 +852,138 @@ body:has(.transporte) .aviso { bottom: 80px; }
   font: 500 12px/1 var(--sans); cursor: pointer;
 }
 .presets button:hover { background: var(--sup3); color: var(--texto); border-color: var(--primo); }
+
+/* ==========================================================================
+   Refresh 2026 — o estúdio deixa de parecer template.
+   Um bloco só, no fim, sobrepondo o essencial: profundidade no fundo,
+   gradiente na marca, cartões com vida e o transporte flutuando de vidro.
+   ========================================================================== */
+
+:root {
+  --primo2: #ffb03a;                          /* o par do laranja no gradiente */
+  --grad-primo: linear-gradient(120deg, #ff5a36 0%, #ff7a3c 55%, #ffb03a 100%);
+  --brilho-primo: 0 8px 32px rgba(255, 90, 54, .25);
+}
+
+body {
+  background:
+    radial-gradient(ellipse 1000px 640px at 18% -10%, rgba(255, 90, 54, .07), transparent 60%),
+    radial-gradient(ellipse 900px 600px at 92% 108%, rgba(124, 92, 246, .05), transparent 60%),
+    var(--fundo);
+}
+
+/* marca com gradiente e cubo aceso */
+.topo .marca .cubo {
+  background: var(--grad-primo);
+  box-shadow: var(--brilho-primo);
+}
+.topo .marca em {
+  background: var(--grad-primo);
+  -webkit-background-clip: text;
+  background-clip: text;
+  color: transparent;
+  font-style: normal;
+}
+
+/* hero maior, título com peso de capa */
+.home .hero h1 {
+  font-size: 42px;
+  letter-spacing: -.02em;
+  background: linear-gradient(120deg, #fff 30%, #ffd9cd 70%, var(--primo2) 100%);
+  -webkit-background-clip: text;
+  background-clip: text;
+  color: transparent;
+}
+
+/* cartões de ferramenta: vidro, glow no hover, levanta */
+.cartao-ferr {
+  border-radius: 16px;
+  background: linear-gradient(180deg, rgba(255, 255, 255, .035), rgba(255, 255, 255, .012));
+  transition: transform .18s ease, border-color .18s ease, box-shadow .18s ease;
+}
+.cartao-ferr:hover {
+  transform: translateY(-3px);
+  border-color: var(--linha2);
+  box-shadow: 0 14px 44px rgba(0, 0, 0, .45), 0 0 0 1px rgba(255, 90, 54, .12);
+}
+.cartao-ferr .icone {
+  border-radius: 12px;
+  box-shadow: inset 0 0 0 1px rgba(255, 255, 255, .06);
+}
+
+/* botão principal: gradiente da marca */
+.btn.primo,
+.transporte .tp-btn.texto.primo {
+  background: var(--grad-primo);
+  border: none;
+  color: #fff;
+  font-weight: 600;
+  box-shadow: var(--brilho-primo);
+}
+.btn.primo:hover,
+.transporte .tp-btn.texto.primo:hover {
+  filter: brightness(1.08);
+}
+
+/* itens da lista de arquivos: respiro e hover */
+.item-arq {
+  border-radius: 14px;
+  transition: background .15s ease, border-color .15s ease;
+}
+.item-arq:hover { background: var(--sup2); border-color: var(--linha2); }
+
+/* transporte do player: vidro flutuante */
+.transporte {
+  background: rgba(16, 16, 20, .78);
+  backdrop-filter: blur(14px);
+  -webkit-backdrop-filter: blur(14px);
+  border: 1px solid var(--linha);
+  border-radius: 16px;
+  margin: 0 14px 12px;
+  width: calc(100% - 28px);
+  box-shadow: 0 12px 40px rgba(0, 0, 0, .5);
+}
+.transporte .tp-cheio { background: var(--grad-primo); }
+
+/* menu do botão Baixar (vídeo / áudio) */
+.menu-baixar {
+  position: fixed;
+  right: 22px;
+  bottom: 84px;
+  z-index: 60;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 6px;
+  border-radius: 14px;
+  border: 1px solid var(--linha2);
+  background: rgba(18, 18, 23, .96);
+  backdrop-filter: blur(16px);
+  -webkit-backdrop-filter: blur(16px);
+  box-shadow: 0 18px 60px rgba(0, 0, 0, .6);
+  animation: menu-sobe .16s ease;
+}
+@keyframes menu-sobe {
+  from { opacity: 0; transform: translateY(8px); }
+  to   { opacity: 1; transform: none; }
+}
+.menu-baixar button {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 2px;
+  min-width: 250px;
+  padding: 11px 14px;
+  border: none;
+  border-radius: 10px;
+  background: transparent;
+  color: var(--texto);
+  font: 600 13.5px/1.2 var(--sans);
+  text-align: left;
+  cursor: pointer;
+}
+.menu-baixar button:hover { background: var(--primo-suave); }
+.menu-baixar button span {
+  font: 400 11.5px/1.2 var(--sans);
+  color: var(--fraco);
+}

package/studio/web/home.html

@@ -37,7 +37,8 @@
     <h1>O estúdio que a IA opera</h1>
     <p>Seis ferramentas nativas com um modelo de documento em comum. A IA escreve o
       documento, o estúdio desenha — apresentação, arte, texto, planilha, vídeo ou diagrama —
-      e você refina à mão no editor.</p>
+      e você refina à mão no editor. Vídeo sai com narração neural, trilha, efeitos
+      sonoros e download direto em MP4 ou áudio.</p>
   </section>
 
   <section class="grade-ferr" id="ferramentas"></section>

package/studio/web/js/player.js

@@ -219,6 +219,7 @@
     pintar();
     aviso("fim", 1200);
     if (gravador && gravador.state === "recording") setTimeout(pararGravacao, 600);
+    if (gravadorAudio && gravadorAudio.state === "recording") setTimeout(pararGravacao, 600);
   }
 
   /* A narração da cena ainda está no ar? */
@@ -388,12 +389,12 @@
       '<div class="tp-tempo" id="tp-total">00:00</div>' +
       '<button class="tp-btn pequeno" id="tp-som" title="Mudo (M)"></button>' +
       '<input class="tp-vol" id="tp-vol" type="range" min="0" max="100" value="70">' +
-      '<button class="tp-btn texto primo" id="tp-gravar" title="Baixar este vídeo como arquivo">Baixar MP4</button>';
+      '<button class="tp-btn texto primo" id="tp-gravar" title="Baixar vídeo ou áudio">Baixar ▾</button>';
     document.body.appendChild(transporte);
 
     document.getElementById("tp-tocar").onclick = function () { tocando ? pausar() : tocar(); };
     document.getElementById("tp-som").onclick = alternarMudo;
-    document.getElementById("tp-gravar").onclick = alternarGravacao;
+    document.getElementById("tp-gravar").onclick = menuBaixar;
     document.getElementById("tp-vol").oninput = function () {
       if (trilha) trilha.volume(this.value / 100);
     };
@@ -444,6 +445,81 @@
     iniciarGravacao();
   }
 
+  /* Menu do botão Baixar: vídeo completo ou só o áudio.
+
+     O áudio sai DIRETO do grafo (trilha + narração + SFX, já mixados com
+     ducking) — sem pedir permissão de tela nenhuma, porque não há tela:
+     é o MediaRecorder pendurado no fluxo da Web Audio. */
+  function menuBaixar() {
+    if ((gravador && gravador.state === "recording") ||
+        (gravadorAudio && gravadorAudio.state === "recording")) {
+      return pararGravacao();
+    }
+    var velho = document.getElementById("menu-baixar");
+    if (velho) { velho.remove(); return; }
+    var m = document.createElement("div");
+    m.id = "menu-baixar";
+    m.className = "menu-baixar";
+    m.innerHTML =
+      '<button data-acao="mp4">🎬 Vídeo completo <span>' + (gravaMp4() ? "MP4" : "WebM") + " · imagem + som</span></button>" +
+      '<button data-acao="audio">🎧 Só o áudio <span>narração + trilha + efeitos</span></button>';
+    document.body.appendChild(m);
+    m.onclick = function (ev) {
+      var b = ev.target.closest("button");
+      if (!b) return;
+      m.remove();
+      if (b.dataset.acao === "mp4") iniciarGravacao();
+      else iniciarGravacaoAudio();
+    };
+    setTimeout(function () {
+      document.addEventListener("click", function fecha(e) {
+        if (!m.contains(e.target)) { m.remove(); document.removeEventListener("click", fecha); }
+      });
+    }, 0);
+  }
+
+  /* ------------------------------------------------ gravação só de áudio -- */
+
+  var gravadorAudio = null, pedacosAudio = [];
+
+  var FORMATOS_AUDIO = [
+    "audio/mp4",                    // AAC → .m4a: toca em tudo, importa em tudo
+    "audio/webm;codecs=opus",
+    "audio/webm",
+  ];
+
+  function iniciarGravacaoAudio() {
+    if (!trilha || !trilha.fluxo) return aviso("áudio indisponível neste navegador", 2500);
+    var tipo = "";
+    for (var i = 0; i < FORMATOS_AUDIO.length; i++) {
+      if (MediaRecorder.isTypeSupported(FORMATOS_AUDIO[i])) { tipo = FORMATOS_AUDIO[i]; break; }
+    }
+    pedacosAudio = [];
+    gravadorAudio = new MediaRecorder(trilha.fluxo, tipo ? { mimeType: tipo, audioBitsPerSecond: 192000 } : undefined);
+    gravadorAudio.ondataavailable = function (ev) { if (ev.data.size) pedacosAudio.push(ev.data); };
+    gravadorAudio.onstop = baixarAudio;
+    gravadorAudio.start();
+    var b = document.getElementById("tp-gravar");
+    if (b) { b.classList.add("gravando"); b.textContent = "Parar"; }
+    buscar(0);
+    tocar();
+    aviso("gravando o áudio — para sozinho no fim", 2600);
+  }
+
+  function baixarAudio() {
+    var mime = (gravadorAudio && gravadorAudio.mimeType) || "audio/webm";
+    var ext = /mp4/.test(mime) ? ".m4a" : ".weba";
+    var blob = new Blob(pedacosAudio, { type: mime.split(";")[0] });
+    var url = URL.createObjectURL(blob);
+    var a = document.createElement("a");
+    a.href = url;
+    a.download = (arq.titulo || "audio").replace(/[^\w\-]+/g, "-").toLowerCase() + ext;
+    a.click();
+    setTimeout(function () { URL.revokeObjectURL(url); }, 4000);
+    aviso("áudio salvo em " + ext, 2600);
+    gravadorAudio = null;
+  }
+
 /* O melhor formato que este navegador sabe gravar.
  *
  * A ordem importa: H.264 com AAC é o MP4 que toca em qualquer lugar —
@@ -518,9 +594,10 @@ function gravaMp4() { return /mp4/.test(escolherFormato()); }
 
   function pararGravacao() {
     if (gravador && gravador.state === "recording") gravador.stop();
+    if (gravadorAudio && gravadorAudio.state === "recording") gravadorAudio.stop();
     if (fluxoTela) fluxoTela.getTracks().forEach(function (f) { f.stop(); });
     var b = document.getElementById("tp-gravar");
-    if (b) { b.classList.remove("gravando"); b.textContent = "Gravar"; }
+    if (b) { b.classList.remove("gravando"); b.textContent = "Baixar ▾"; }
   }
 
   function baixarGravacao() {