primocode 8.10.3 → 8.10.5

package/lib/tools.js

@@ -170,6 +170,9 @@ async function runShell(command, timeout = 60000, cwd) {
 // execFile com array de argumentos nunca passa por shell nenhum: "target" vira
 // UM argumento, não texto que um shell reinterpreta — sem isso, um valor tipo
 // `https://x/"; touch /tmp/pwned; echo "` injetava comando (achado de segurança).
+// Quando o auto-abrir do Studio abriu pela última vez — o freio das mil abas.
+let ultimaAberturaStudio = 0;
+
 function openInBrowser(target) {
     const p = os.platform();
     const [cmd, args, opener] = p === 'darwin' ? ['open', [target], 'open']
@@ -503,8 +506,31 @@ async function despachar(name, args, ctx) {
                 return studio.manual();
             case 'studio_spec':
                 return studio.spec(args.ferramenta || args.slug || '');
-            case 'studio_criar':
-                return studio.criar({ ferramenta: args.ferramenta, titulo: args.titulo, doc: args.doc });
+            case 'studio_criar': {
+                const r = await studio.criar({ ferramenta: args.ferramenta, titulo: args.titulo, doc: args.doc });
+                // Criou? ABRE NO NAVEGADOR, sozinho. O dono: "quando ele faz um
+                // vídeo, uma apresentação, abre automático — a pessoa não vai
+                // saber abrir". E cada "abre pra mim" digitado depois custava
+                // uma tarefa inteira de tokens para o modelo redescobrir o
+                // link. Abrir é determinístico: não se gasta modelo com isso.
+                if (r && r.ok !== false && r.ver) {
+                    // UMA aba por tarefa. O modelo às vezes cria três versões
+                    // seguidas, e abrir todas enchia o navegador do usuário de
+                    // abas — "abre 1000 versões". A primeira abre; as outras
+                    // são avisadas a ATUALIZAR a que já existe.
+                    const agora = Date.now();
+                    if (agora - ultimaAberturaStudio > 45000) {
+                        ultimaAberturaStudio = agora;
+                        try { openInBrowser(r.ver); } catch {}
+                        r.abertoNoNavegador = true;
+                        r.aviso = 'JÁ ABERTO no navegador do usuário. Chame finish AGORA dizendo o que foi criado — não abra de novo, não leia de volta, não ajuste sem pedido.';
+                    } else {
+                        r.aviso = `Você JÁ criou uma versão nesta tarefa, e ela está aberta no navegador. NÃO crie outra: `
+                            + `para mudar algo, use studio_atualizar com o id "${r.id}". Chame finish AGORA.`;
+                    }
+                }
+                return r;
+            }
             case 'studio_ler':
                 return studio.ler(args.id);
             case 'studio_atualizar':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "8.10.3",
+  "version": "8.10.5",
   "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/arquivos/corte-legado-teste.json

@@ -0,0 +1 @@
+{"id": "corte-legado-teste", "ferramenta": "corte", "titulo": "legado", "doc": {"tema": "meia-noite", "largura": 1080, "altura": 1920, "cenas": [{"duracao": "4s", "fundo": "aurora", "elementos": [{"tipo": "titulo", "texto": "Imersão Founders AI"}, {"tipo": "subtitulo", "conteudo": "Paris Group · Chapecó"}]}]}}

package/studio/arquivos/corte-legado2.json

@@ -0,0 +1 @@
+{"id": "corte-legado2", "ferramenta": "corte", "titulo": "legado2", "doc": {"tema": "meia-noite", "largura": 1080, "altura": 1920, "cenas": [{"duracao": "4s", "fundo": "aurora", "elementos": [{"tipo": "titulo", "texto": "Imersão Founders AI", "anim": "nenhuma"}, {"tipo": "subtitulo", "conteudo": "Paris Group · Chapecó", "anim": "nenhuma"}]}]}}

package/studio/arquivos/corte-ok-1270e.json

@@ -0,0 +1,22 @@
+{
+  "id": "corte-ok-1270e",
+  "ferramenta": "corte",
+  "titulo": "ok",
+  "doc": {
+    "tema": "brasa",
+    "cenas": [
+      {
+        "duracao": 3,
+        "elementos": [
+          {
+            "tipo": "texto",
+            "papel": "titulo",
+            "texto": "Founders AI",
+            "anim": "nenhuma"
+          }
+        ]
+      }
+    ]
+  },
+  "atualizado": "2026-08-16T17:50:21+00:00"
+}

package/studio/ferramentas/corte.md

@@ -10,6 +10,11 @@ corte e o agente inventou a estrutura. Formato primeiro; detalhe depois. -->
 
 ## Exemplo completo
 
+**ATENÇÃO — este exemplo ensina o FORMATO, não o conteúdo.** O assunto dele
+(conta de luz, bandeira tarifária) é inventado para a demonstração. Copiar
+qualquer frase dele para o SEU documento é ERRO: escreva cada cena com os
+fatos da SUA tarefa. O servidor recusa documento que venha com estas frases.
+
 ```json
 {
   "ferramenta": "corte",

package/studio/server.py

@@ -278,12 +278,60 @@ def criar(dados):
     })
 
 
+# Frases que só existem nos EXEMPLOS das specs. Documento que chega com uma
+# delas é o agente copiando o exemplo em vez de escrever o conteúdo do pedido
+# — um usuário pediu um vídeo da empresa dele e recebeu cenas sobre "bandeira
+# tarifária", o assunto fictício do exemplo do corte.
+# Só frases INCONFUNDÍVEIS entram aqui: "energia solar no brasil" seria um
+# pedido legítimo possível, e bloquear pedido legítimo é pior que deixar um
+# plágio passar. Estas seis não existem fora do exemplo.
+FRASES_DE_EXEMPLO = [
+    "bandeira tarifária em 12 meses", "bandeira tarifaria em 12 meses",
+    "não foi o seu chuveiro", "nao foi o seu chuveiro",
+    "saturadas no nordeste", "usina gerando sem escoar",
+    "segue para entender a próxima", "segue para entender a proxima",
+]
+
+
+def _texto_do_doc(doc):
+    """Todo texto visível do documento, achatado, para inspeção."""
+    pedacos = []
+
+    def anda(x):
+        if isinstance(x, dict):
+            for v in x.values():
+                anda(v)
+        elif isinstance(x, list):
+            for v in x:
+                anda(v)
+        elif isinstance(x, str):
+            pedacos.append(x)
+
+    anda(doc)
+    return " ".join(pedacos).lower()
+
+
 def validar_doc(modelo, doc):
     """None quando o doc serve; senão, a frase que ENSINA o formato certo.
 
     A mensagem repete a estrutura mínima de propósito: ela volta para o agente
     como resultado da tool, e é a única chance de ele se corrigir sem o
     usuário ver um vídeo preto."""
+    texto = _texto_do_doc(doc)
+    for frase in FRASES_DE_EXEMPLO:
+        if frase in texto:
+            return ('o documento contém "%s" — isso é texto do EXEMPLO da spec, não do pedido '
+                    'do usuário. O exemplo ensina o FORMATO; o conteúdo é seu: reescreva cada '
+                    'cena com os fatos da tarefa (a pesquisa que você fez) e crie de novo.' % frase)
+
+    # Os tipos que o render.js de fato desenha. Elemento de tipo inventado
+    # ("titulo", "subtitulo", "video"...) passava na validação e caía no
+    # default do renderizador: texto cru de 16px num canvas de 1920 — ou nada,
+    # quando o texto estava noutro campo. Era o "vídeo com música mas tudo
+    # preto": documento válido na forma, invisível na tela.
+    TIPOS_VALIDOS = {"texto", "lista", "cartoes", "numeros", "tabela", "codigo",
+                     "citacao", "forma", "imagem", "icone", "grafico", "no", "conector"}
+
     if modelo == "cena":
         cenas = doc.get("cenas")
         if not isinstance(cenas, list) or not cenas:
@@ -297,9 +345,20 @@ def validar_doc(modelo, doc):
             if not isinstance(els, list) or not els:
                 return ('cena %d sem "elementos". Cada cena precisa de elementos:[...] — '
                         'ex.: {"tipo":"texto","texto":"..."}. Leia studio_spec e refaça.' % (i + 1))
+            dur = c.get("duracao")
+            if dur is not None and not isinstance(dur, (int, float)):
+                return ('cena %d com "duracao" que não é número (veio %r). Use número de segundos: '
+                        '"duracao": 3' % (i + 1, dur))
             for j, e in enumerate(els):
                 if not isinstance(e, dict) or not e.get("tipo"):
                     return 'elemento %d da cena %d sem "tipo" (texto, imagem, lista, numeros, forma...)' % (j + 1, i + 1)
+                if e.get("tipo") not in TIPOS_VALIDOS:
+                    return ('elemento %d da cena %d tem tipo "%s", que NÃO existe. Os tipos válidos são: %s. '
+                            'Para título use {"tipo":"texto","papel":"titulo","texto":"..."}.'
+                            % (j + 1, i + 1, e.get("tipo"), ", ".join(sorted(TIPOS_VALIDOS))))
+                if e.get("tipo") == "texto" and not (e.get("texto") or "").strip():
+                    return ('elemento %d da cena %d é "texto" mas o campo "texto" está vazio — o conteúdo '
+                            'vai SEMPRE no campo "texto".' % (j + 1, i + 1))
     elif modelo == "documento":
         blocos = doc.get("blocos")
         if not isinstance(blocos, list) or not blocos:

package/studio/web/js/narracao.js

@@ -228,7 +228,12 @@ var Narracao = (function () {
     return VozNeural.audioDe(texto, cfg);
   }
 
-  function falando() { return !!sintese && sintese.speaking; }
+  function falando() {
+    /* A voz pode estar saindo por três lugares; o player precisa da verdade
+       de todos, senão corta a cena no meio da fala neural. */
+    if (typeof VozNeural !== "undefined" && VozNeural.falando && VozNeural.falando()) return true;
+    return !!sintese && sintese.speaking;
+  }
 
   function estimar(texto, velocidade) {
     var palavras = String(texto || "").trim().split(/\s+/).filter(Boolean).length;

package/studio/web/js/player.js

@@ -30,7 +30,12 @@
     return String(Math.floor(s / 60)).padStart(2, "0") + ":" + String(s % 60).padStart(2, "0");
   }
 
-  function duracaoDe(i) { return (cenas[i] && cenas[i].duracao) || 4; }
+  function duracaoDe(i) {
+    /* "duracao": "3s" (texto) fazia acc virar concatenação e o relógio dava
+       vídeo de 00:00. Número são ou o padrão — nunca corrente de texto. */
+    var d = Number(cenas[i] && cenas[i].duracao);
+    return (isFinite(d) && d > 0) ? Math.min(60, d) : 4;
+  }
   function total() { return cenas.reduce(function (s, _, i) { return s + duracaoDe(i); }, 0); }
   function inicioDe(i) { var s = 0; for (var k = 0; k < i; k++) s += duracaoDe(k); return s; }
 
@@ -185,6 +190,13 @@
     if (gravador && gravador.state === "recording") setTimeout(pararGravacao, 600);
   }
 
+  /* A narração da cena ainda está no ar? */
+  function narrando() {
+    if (vozGravada && !vozGravada.ended && !vozGravada.paused) return true;
+    if (typeof Narracao !== "undefined" && Narracao.falando && Narracao.falando()) return true;
+    return false;
+  }
+
   function laco() {
     if (!tocando) return;
     decorrido = (performance.now() - t0) / 1000;
@@ -194,6 +206,18 @@
       acc += duracaoDe(i);
       if (decorrido < acc) { alvo = i; break; }
     }
+    /* A CENA ESPERA A VOZ. O relógio andava só pela `duracao`, e uma narração
+       mais longa que a cena vazava por cima da seguinte — era a "narração
+       fora de sincronia". Se a fala da cena atual ainda está no ar, o relógio
+       congela na beirada da cena: quem dita o corte é a voz. */
+    var fimDaAtual = inicioDe(atual) + duracaoDe(atual);
+    if ((alvo !== atual || decorrido >= total()) && narrando()) {
+      t0 = performance.now() - (fimDaAtual - 0.05) * 1000;
+      decorrido = fimDaAtual - 0.05;
+      pintar();
+      quadro = requestAnimationFrame(laco);
+      return;
+    }
     if (decorrido >= total()) return fim();
     if (alvo !== atual) ir(alvo, true);
     pintar();

package/studio/web/js/render.js

@@ -137,9 +137,22 @@ function svgGrafico(e, l, a) {
 
 /* -------------------------------------------------------------- elementos */
 
+var TIPOS_CONHECIDOS = { texto: 1, lista: 1, cartoes: 1, numeros: 1, tabela: 1, codigo: 1,
+  citacao: 1, forma: 1, imagem: 1, icone: 1, grafico: 1, no: 1, conector: 1 };
+
 function renderElemento(e, ctx) {
   var no = document.createElement("div");
   var tipo = e.tipo || "texto";
+  /* Tipo inventado ("titulo", "subtitulo"...) caía num default sem estilo:
+     texto de 16px num canvas de 1920 — invisível — ou div vazio quando o
+     conteúdo estava noutro campo. O servidor novo recusa; documentos velhos
+     e outros clientes ganham a leitura generosa: vira texto de verdade. */
+  if (!TIPOS_CONHECIDOS[tipo]) {
+    e = { tipo: "texto", papel: /titulo|title/i.test(tipo) ? "titulo" : (e.papel || null),
+          texto: e.texto || e.conteudo || e.titulo || e.valor || e.legenda || "",
+          tamanho: e.tamanho, estilo: e.estilo, anim: e.anim, x: e.x, y: e.y, l: e.l, a: e.a };
+    tipo = "texto";
+  }
   no.className = "el " + tipo;
   no.dataset.tipo = tipo;
 

package/studio/web/js/voz-neural.js

@@ -106,7 +106,7 @@ var VozNeural = (function () {
         var fechou = false;
         var relogio = setTimeout(function () {
           if (!fechou) { fechou = true; try { ws.close(); } catch (e) {} erro(new Error("voz neural nao respondeu")); }
-        }, 20000);
+        }, 6000);
 
         function desistir(e) {
           if (fechou) return;
@@ -220,6 +220,11 @@ var VozNeural = (function () {
     if (tocando) { try { tocando.pause(); } catch (e) {} tocando = null; }
   }
 
+  /* O player pergunta isto para segurar a cena até a voz acabar. */
+  function falando() {
+    return !!(tocando && !tocando.paused && !tocando.ended);
+  }
+
   /* Serve para a interface avisar antes de o usuário montar o vídeo inteiro. */
   function testar(cfg) {
     return audioDe("Teste de voz do PrimoCode Studio.", cfg)
@@ -229,7 +234,7 @@ var VozNeural = (function () {
 
   return {
     vozes: vozes, vozPadrao: vozPadrao, graves: graves,
-    audioDe: audioDe, falar: falar, parar: parar, testar: testar,
+    audioDe: audioDe, falar: falar, parar: parar, falando: falando, testar: testar,
     _selo: selo
   };
 })();