primocode 8.1.0 → 8.2.0

package/README.md

@@ -1,4 +1,4 @@
-# PrimoCode v7.10.1
+# PrimoCode v8.1.1
 
 Agente de engenharia brasileiro para o terminal, no estilo Claude Code.
 Cria arquivos de verdade, roda comandos, **controla o navegador e o desktop** —
@@ -9,7 +9,7 @@ OpenRouter, e cada apelido (`top`/`main`/`fast`) é uma **corrente**: se um mode
 está no limite de pedidos, o próximo atende. Você não vê o erro, e não paga nada.
 
 ```
- ▐▛███▜▌   Primo Code v7.10.1
+ ▐▛███▜▌   Primo Code v8.1.1
 ▝▜█████▛▘  Bem-vindo de volta, Joel
   ▘▘ ▝▝    ~/primocode  · /dir <pasta> muda
 ```
@@ -263,7 +263,7 @@ primocode -f app.js "onde está o bug?" # com arquivo anexado
 | `/model top\|main\|fast` | **Todos grátis.** top = o mais capaz (550B, 1M de contexto), main = agente de código (padrão), fast = o mais rápido. Aceita qualquer ID do OpenRouter |
 | `/attach <arquivo>` | Anexa arquivo ao próximo pedido |
 | `/detach` · `/files` | Remove / lista anexos |
-| `/tudo` | Lista as 30 ferramentas que ele sabe usar, por grupo |
+| `/tudo` | Lista as 44 ferramentas que ele sabe usar, por grupo |
 | `/tree [n]` | Árvore do projeto atual |
 | `/read <arquivo>` | Mostra um arquivo do projeto |
 | `/run <comando>` | Executa no shell, dentro da pasta do projeto |

package/bin/primocode.js

@@ -516,7 +516,9 @@ async function sendPrompt(userText) {
     // tokens). No auto, quem não vai usar ferramenta não paga por ela.
     let modo = state.mode;
     if (modo === 'auto') {
-        const escolha = escolherModo(userText);
+        // O modo do pedido ANTERIOR entra na decisão: no meio de uma tarefa,
+        // "refaz" e "agora põe música" são continuação, não papo novo.
+        const escolha = escolherModo(userText, { ultimoModo: state.modoEfetivo });
         modo = escolha.modo;
         state.modoEfetivo = modo;
         const rotulo = modo === 'primocode' ? c.warn('Primo Code') : c.brandDim('Chat');

package/lib/browser.js

@@ -88,8 +88,9 @@ const APPS_MAC = [
  *
  * Um app rodando de dentro do `.dmg` funciona, mas é frágil: o disco é
  * somente-leitura, o macOS o executa por AppTranslocation (caminho temporário
- * aleatório) e ele desaparece na hora que o disco for ejetado. Achamos e usamos —
- * e `avisoDeLocal()` diz ao usuário para arrastar o app para Aplicativos.
+ * aleatório) e ele desaparece na hora que o disco for ejetado. Achamos e
+ * usamos mesmo assim — sem aviso adicional, o disco ejetado já falha na hora
+ * de abrir o navegador, o que já é sinal suficiente do que aconteceu.
  */
 function procurarEmVolumes() {
     const bases = [];
@@ -107,24 +108,6 @@ function procurarEmVolumes() {
     return null;
 }
 
-/**
- * O navegador achado está num lugar problemático? Devolve o aviso, ou null.
- *
- * Não bloqueia nada: o controle funciona de dentro do disco montado. Só avisa,
- * porque quem ejetar o disco vai ver a ferramenta parar de funcionar sem entender
- * o motivo.
- */
-function avisoDeLocal(caminho) {
-    if (!caminho) return null;
-    if (caminho.startsWith('/Volumes/')) {
-        const app = (caminho.match(/\/Volumes\/[^/]+\/([^/]+\.app)/) || [, 'o navegador'])[1];
-        return `${app} está rodando do disco de instalação, não instalado. `
-            + 'Funciona, mas para de funcionar quando você ejetar esse disco — '
-            + 'arraste o app para a pasta Aplicativos.';
-    }
-    return null;
-}
-
 function httpGetJson(url, timeoutMs = 3000) {
     return new Promise((resolve, reject) => {
         const req = http.get(url, (res) => {
@@ -450,8 +433,6 @@ async function open(url) {
     return { ok: true, url };
 }
 
-async function navigate(url) { return open(url); }
-
 async function evaluate(js) {
     await ensure();
     const r = await currentSession.send('Runtime.evaluate', {
@@ -639,11 +620,6 @@ async function screenshot(saveTo) {
     return { ok: true, path: filename, bytes: Buffer.byteLength(r.data, 'base64') };
 }
 
-async function currentUrl() {
-    await ensure();
-    return evaluate('location.href');
-}
-
 async function waitFor(selector, timeoutMs = 15000) {
     await ensure();
     const deadline = Date.now() + timeoutMs;
@@ -669,8 +645,6 @@ function close() {
 }
 
 module.exports = {
-    open, navigate, click, clickText, clickSelector, type, typeInSelector,
-    key, screenshot, evaluate, currentUrl, waitFor, wait, scroll, close,
-    avisoDeLocal,
-    _internal: { findChrome, procurarEmVolumes, PROFILE_DIR, DEBUG_PORT },
+    open, click, clickText, clickSelector, type, typeInSelector,
+    key, screenshot, evaluate, waitFor, wait, scroll, close,
 };

package/lib/catalogo.js

@@ -85,6 +85,8 @@ const GRUPOS = [
             { tool: 'studio_atualizar', escreve: false, faz: 'ajusta o que já existe, sem refazer do zero',
               args: 'id. titulo (opcional). doc (opcional).' },
             { tool: 'studio_listar',    escreve: false, faz: 'lista o que já existe no estúdio', args: null },
+            { tool: 'studio_midia',     escreve: false, faz: 'manda imagem, música ou vídeo seu para usar nas peças',
+              args: 'arquivo (opcional): caminho no projeto — sem ele, lista a galeria. nome (opcional).' },
         ],
     },
     {

package/lib/config.js

@@ -73,10 +73,15 @@ function ensureStructure() {
     return { rootDir: ROOT_DIR };
 }
 
+// Tira acento (NFD + remove os diacríticos combinantes). Compartilhado com
+// lib/desktop.js — as duas versões faziam a mesma conta separadas.
+function stripAccents(s) {
+    return String(s || '').normalize('NFD').replace(/[̀-ͯ]/g, '');
+}
+
 // "Jogo de Carro!" -> "jogo-de-carro"
 function slugify(name) {
-    return String(name)
-        .normalize('NFD').replace(/[̀-ͯ]/g, '')
+    return stripAccents(name)
         .toLowerCase()
         .replace(/[^a-z0-9]+/g, '-')
         .replace(/^-+|-+$/g, '')
@@ -208,7 +213,7 @@ function appendHistory(entry) {
 module.exports = {
     loadConfig, saveConfig, appendHistory,
     CONFIG_DIR, CONFIG_FILE, HISTORY_FILE, ROOT_DIR, GENERAL_MEMORY,
-    ensureStructure, slugify,
+    ensureStructure, slugify, stripAccents,
     createProjectDir, getProjectDir, listProjects, findSimilarProject,
     readGeneralMemory, readProjectMemory, appendProjectMemory, appendGeneralMemory,
 };

package/lib/desktop.js

@@ -15,6 +15,7 @@
 
 const { execSync } = require('child_process');
 const os = require('os');
+const { stripAccents } = require('./config');
 
 const PLATFORM = os.platform();
 
@@ -344,7 +345,7 @@ const APP_ALIASES = {
 };
 
 function normaliza(s) {
-    return String(s || '').normalize('NFD').replace(/[̀-ͯ]/g, '').toLowerCase().trim();
+    return stripAccents(s).toLowerCase().trim();
 }
 
 function aliasDoApp(nome, platform = PLATFORM) {
@@ -371,7 +372,17 @@ function openApp(nome) {
     } else {
         const bin = app.split(/\s+/)[0];
         if (hasCmd('gtk-launch') && run(`gtk-launch ${sh1(bin)}`).ok) r = { ok: true };
-        else if (hasCmd(bin)) r = run(`bash -c ${sh1(`setsid ${app} >/dev/null 2>&1 < /dev/null &`)}`);
+        else if (hasCmd(bin)) {
+            // sh1() aqui só protegia o script INTEIRO como um argumento pro
+            // `bash -c` — dentro do script, bash reparsa o texto, e "app" cru
+            // continuava vulnerável a injeção (achado de segurança: um app tipo
+            // "a;touch /tmp/pwned;" executava o comando extra). Cada palavra de
+            // "app" agora entra entre aspas simples individualmente — preserva
+            // "programa --flag" como dois argumentos, mas nenhuma delas deixa
+            // metacaractere de shell passar como sintaxe.
+            const appEscapado = app.split(/\s+/).map(sh1).join(' ');
+            r = run(`bash -c ${sh1(`setsid ${appEscapado} >/dev/null 2>&1 < /dev/null &`)}`);
+        }
         else r = { ok: false, error: `Não achei o programa "${pedido}" no PATH.` };
     }
 

package/lib/modo.js

@@ -1,19 +1,28 @@
 /**
  * Escolha automática de modo.
  *
- * O modo primocode manda o schema das 30 ferramentas em todo pedido — ~4.700
- * tokens antes de você digitar a primeira letra. Um "oi" gasta o mesmo que uma
- * refatoração, e num plano com teto diário isso é dinheiro jogado fora (foi
+ * O modo primocode manda o schema das 45 ferramentas em todo pedido — milhares
+ * de tokens antes de você digitar a primeira letra. Um "oi" gasta o mesmo que
+ * uma refatoração, e num plano com teto diário isso é dinheiro jogado fora (foi
  * assim que a cota de 100 mil tokens/dia acabou às 15h).
  *
  * O modo chat não manda schema nenhum. Então a regra é: só paga o preço das
  * ferramentas quem vai usar ferramenta.
  *
  * A decisão é local e sem custo — nenhuma chamada ao modelo para descobrir a
- * intenção, senão o remédio custaria como a doença. É um classificador de
- * pistas, deliberadamente conservador: na dúvida, chat, porque errar para chat
- * custa uma repetição do pedido, e errar para primocode custa tokens e pode
- * escrever arquivo que ninguém pediu.
+ * intenção, senão o remédio custaria como a doença.
+ *
+ * ── POR QUE ELE OLHA O TURNO ANTERIOR ────────────────────────────────────
+ * A primeira versão julgava cada frase sozinha, e errava feio no uso real: o
+ * usuário pedia um vídeo (tarefa), e o "refaz", o "continua" e o "agora põe
+ * música de fundo" logo depois caíam no chat — o agente perdia o fio no meio
+ * do trabalho. Medido na conversa do dono: 7 erros em 18 frases, quase todos
+ * de continuação.
+ *
+ * Conversa humana não repete o objeto a cada frase. Então, QUANDO O TURNO
+ * ANTERIOR FOI UMA TAREFA, a régua abaixa: o que não é claramente cumprimento
+ * ou dúvida conceitual continua sendo trabalho. Fora de uma tarefa, a régua
+ * volta a subir — na dúvida, chat.
  */
 
 'use strict';
@@ -34,6 +43,13 @@ const VERBOS = [
     // "pesquisa no google", "aperta enter", "arrasta o arquivo".
     'clic[ao]r?', 'clique', 'digit[ae]r?', 'pesquis[ae]r?', 'apert[ae]r?',
     'arrast[ae]r?', 'rol[ae]r?', 'minimiz[ae]r?', 'maximiz[ae]r?', 'fech[ae]r?',
+    // Ajuste do que já foi criado — o vocabulário do estúdio. Sem estes, "agora
+    // põe música de fundo" caía no chat, no meio de um vídeo.
+    'p[õo]e', 'ponha', 'p[oô]r', 'coloc[ae]r?', 'tir[ae]r?', 'troc[ae]r?',
+    'inclu[ai]r?', 'insir[ae]', 'insert', 'aument[ae]r?', 'diminu[ai]r?',
+    'grav[ae]r?', 'narr[ae]r?', 'export[ae]r?', 'salv[ae]r?', 'envi[ae]r?',
+    'convert[ae]r?', 'transform[ae]r?', 'divid[ai]r?', 'junt[ae]r?',
+    'desenh[ae]r?', 'ilustr[ae]r?', 'resum[ae]r?', 'traduz[ai]r?',
 ];
 const RE_VERBO = new RegExp(`(^|\\s)(${VERBOS.join('|')})\\b`, 'i');
 
@@ -49,33 +65,75 @@ const RE_ARTEFATO = /\.(js|ts|tsx|jsx|html|css|json|md|py|sh|yml|yaml|txt|csv|en
 const RE_FERRAMENTA = /\b(navegador|browser|desktop|terminal|shell|git|npm|node|deploy|servidor|localhost|porta \d+|screenshot|print da tela|mouse|teclado|janela|[áa]rea de trabalho|aplicativo|[íi]cone)\b/i;
 const RE_PASTA = /\b(pasta|diret[óo]rio|arquivo|arquivos|reposit[óo]rio|repo|projeto)\b/i;
 
+// O que o estúdio produz. "faz uns slides", "quero um post", "monta a planilha"
+// — o substantivo sozinho já denuncia a tarefa, mesmo sem verbo claro.
+const RE_PECA = /\b(slides?|apresenta[çc][ãa]o|deck|v[íi]deo|reels?|anima[çc][ãa]o|post|banner|capa|thumbnail|arte|cartaz|planilha|tabela|documento|relat[óo]rio|artigo|proposta|contrato|diagrama|fluxograma|organograma|mapa mental|narra[çc][ãa]o|trilha|legenda)\b/i;
+
 // Conversa: cumprimento, agradecimento, pergunta conceitual.
-const RE_SAUDACAO = /^\s*(oi+|ol[áa]|e?a[íi]|bom dia|boa tarde|boa noite|tudo bem|beleza|valeu|obrigad[oa]|brigad[oa]|tchau|até|ok|okay|entendi|legal|show|massa)\b[\s!.?]*$/i;
+const RE_SAUDACAO = /^\s*(oi+|ol[áa]|e?a[íi]|bom dia|boa tarde|boa noite|tudo bem|beleza|valeu|obrigad[oa]|brigad[oa]|tchau|at[ée]|ok|okay|entendi|legal|show|massa|top|perfeito|isso|isso a[íi]|ta bom|t[áa] bom|certo)\b[\s!.?]*$/i;
 const RE_CONCEITUAL = /\b(o que [ée]|o q [ée]|que [ée]|qual (a|o|as|os)?\s*(diferen[çc]a|melhor|sentido)|por qu[êe]|pra que serve|para que serve|como funciona|como (fa[çc]o|posso|se faz|fazer)|explica|explique|me explica|significa|vale a pena|devo usar|qual usar|prefere)\b/i;
+// "o que você faz?", "o que vc sabe fazer?" — é pergunta sobre ele, não pedido.
+// Sem esta linha o "faz" batia no verbo e virava tarefa.
+const RE_SOBRE_ELE = /\bo que (voc[êe]|vc|tu)\s+(faz|sabe|consegue|pode|[ée])\b|\bquem [ée] voc[êe]\b|\bcomo voc[êe] funciona\b/i;
+
+// Satisfação: "ficou bom", "tá bom assim", "pode parar" — o usuário está
+// dizendo que ACABOU, não pedindo mais trabalho. Sem isto, no meio de uma
+// tarefa a régua abaixada mandava um elogio de volta para o agente.
+const RE_SATISFEITO = /^\s*(t[áa]|ta|ficou|est[áa]|ta[' ]?)?\s*(bom|[óo]timo|legal|show|massa|perfeito|lindo|maneiro|isso)\b(\s+(assim|mesmo|ent[ãa]o|demais))?[\s!.]*$|^\s*(pode parar|chega|s[óo] isso|era isso|nada mais)\b/i;
+
+// Continuação forte: sozinhas já significam "siga com o que estava fazendo".
+const RE_CONTINUACAO = /^\s*(refa[çz]a?|refaz|de novo|novamente|outra vez|mais uma vez|continu[ae]|prossiga|segue|siga|vai|manda|tenta( de novo| outra vez)?|tente( de novo| outra vez)?|repete|repita)\b/i;
+
+// Continuação fraca: só vale quando o turno anterior foi tarefa.
+// "agora …", "e o …?", "também …", "mais …", "sem …", "com …".
+const RE_CONTINUACAO_FRACA = /^\s*(agora|depois|ent[ãa]o|e (o|a|os|as|no|na)\b|tamb[ée]m|mais|menos|sem|com|s[óo]|apenas|troca|muda)\b/i;
 
 /**
  * Decide o modo de um pedido.
- * Devolve { modo: 'primocode'|'chat', motivo: string }.
+ *
+ * @param {string} texto  o que o usuário digitou
+ * @param {{ultimoModo?: string}} ctx  contexto da conversa; `ultimoModo` é o
+ *        modo que o pedido ANTERIOR usou de fato ('primocode' | 'chat').
+ * @returns {{modo:'primocode'|'chat', motivo:string}}
+ *
  * O motivo existe para o CLI mostrar por que escolheu — automode que decide em
  * silêncio parece defeito na primeira vez que erra.
  */
-function escolherModo(texto) {
+function escolherModo(texto, ctx = {}) {
     const t = String(texto || '').trim();
     if (!t) return { modo: 'chat', motivo: 'nada a fazer' };
 
+    const noMeioDeUmaTarefa = (ctx && ctx.ultimoModo) === 'primocode';
+
     // Cumprimento é chat mesmo que traga um verbo depois ("oi, tudo bem?").
     if (RE_SAUDACAO.test(t)) return { modo: 'chat', motivo: 'cumprimento' };
+    if (RE_SATISFEITO.test(t)) return { modo: 'chat', motivo: 'está satisfeito' };
 
-    // Pergunta conceitual ganha do verbo: "como faço para criar um site?" é
-    // dúvida, não pedido de execução.
+    // Pergunta sobre ele mesmo, e pergunta conceitual, ganham do verbo:
+    // "como faço para criar um site?" é dúvida, não pedido de execução.
+    if (RE_SOBRE_ELE.test(t)) return { modo: 'chat', motivo: 'pergunta sobre ele' };
     if (RE_CONCEITUAL.test(t)) return { modo: 'chat', motivo: 'pergunta conceitual' };
 
+    // "refaz", "de novo", "continua" — retomada, com ou sem contexto.
+    if (RE_CONTINUACAO.test(t)) return { modo: 'primocode', motivo: 'retoma a tarefa' };
+
+    // Pistas diretas.
     if (RE_ARTEFATO.test(t)) return { modo: 'primocode', motivo: 'cita arquivo ou caminho' };
     if (RE_VERBO.test(t)) return { modo: 'primocode', motivo: 'pede uma ação' };
+    if (RE_PECA.test(t)) return { modo: 'primocode', motivo: 'fala de algo para criar' };
     if (RE_DESEJO.test(t)) return { modo: 'primocode', motivo: 'expressa o que quer que exista' };
     if (RE_FERRAMENTA.test(t)) return { modo: 'primocode', motivo: 'menciona ferramenta ou máquina' };
     if (RE_PASTA.test(t)) return { modo: 'primocode', motivo: 'fala de arquivo ou projeto' };
 
+    // No meio de uma tarefa a régua abaixa: conversa não repete o objeto a cada
+    // frase, e o custo de errar aqui é o agente perder o fio.
+    if (noMeioDeUmaTarefa) {
+        if (RE_CONTINUACAO_FRACA.test(t)) return { modo: 'primocode', motivo: 'continua o que estava fazendo' };
+        // Pergunta curta no meio do trabalho costuma ser sobre o trabalho
+        // ("e não dá pra deixar rodando?"), não papo novo.
+        if (t.split(/\s+/).length <= 12) return { modo: 'primocode', motivo: 'segue a tarefa em andamento' };
+    }
+
     return { modo: 'chat', motivo: 'sem pista de tarefa' };
 }
 

package/lib/referencia.js

@@ -29,6 +29,33 @@ const net = require('net');
 const tls = require('tls');
 const { URL } = require('url');
 
+// Achado de segurança: redirect sem checar destino é SSRF — uma fonte de
+// busca (conteúdo de terceiro, não confiável) pode responder com um Location
+// pra localhost ou pro metadado de nuvem (169.254.169.254), e pegar() seguia
+// sem checar host nenhum. Bloqueia loopback/link-local/rede privada antes de
+// abrir a conexão, tanto na URL original quanto em cada redirect seguido.
+function hostBloqueado(hostname) {
+    const h = String(hostname || '').toLowerCase();
+    if (h === 'localhost' || h.endsWith('.localhost')) return true;
+    const versao = net.isIP(h);
+    if (versao === 4) {
+        const partes = h.split('.').map(Number);
+        const [a, b] = partes;
+        if (a === 127 || a === 10 || a === 0) return true;                 // loopback, privada, "esta rede"
+        if (a === 169 && b === 254) return true;                          // link-local — inclui metadado de nuvem
+        if (a === 172 && b >= 16 && b <= 31) return true;                  // privada
+        if (a === 192 && b === 168) return true;                          // privada
+        return false;
+    }
+    if (versao === 6) {
+        if (h === '::1' || h === '::') return true;                       // loopback / unspecified
+        if (h.startsWith('fc') || h.startsWith('fd')) return true;        // unique local (fc00::/7)
+        if (h.startsWith('fe80:') || h.startsWith('fe8') || h.startsWith('fe9') || h.startsWith('fea') || h.startsWith('feb')) return true; // link-local
+        return false;
+    }
+    return false; // hostname comum (DNS) — não dá pra saber o IP sem resolver
+}
+
 const TIMEOUT_MS = 12000;
 const MAX_POR_FONTE = 4;
 const MAX_TEXTO = 4500;
@@ -72,6 +99,7 @@ function pegar(url, { timeout = TIMEOUT_MS, saltos = 0 } = {}) {
         // 5 saltos cobre qualquer doc real; sem teto, um redirect em loop
         // (A→B→A→...) trava essa fonte — e a pesquisa inteira — para sempre.
         if (saltos > 5) return resolve(null);
+        if (hostBloqueado(alvo.hostname)) return resolve(null);
         const cliente = alvo.protocol === 'http:' ? http : https;
 
         const opcoes = {

package/lib/studio.js

@@ -191,8 +191,43 @@ const atualizar = ({ id, titulo, doc }) => comStudio(async () => {
     return { ok: true, ...r };
 });
 
+// ── Mídia: a imagem de fundo e a música do usuário ───────────────────────
+// Sem isto o agente não tinha como pôr foto de fundo nem trilha própria: a
+// API pede base64, e ele não ia montar data URI na mão dentro de um curl.
+const TIPOS_MIDIA = {
+    '.png': 1, '.jpg': 1, '.jpeg': 1, '.gif': 1, '.webp': 1, '.svg': 1, '.avif': 1,
+    '.mp3': 1, '.m4a': 1, '.wav': 1, '.ogg': 1, '.aac': 1, '.flac': 1, '.opus': 1, '.weba': 1,
+    '.mp4': 1, '.webm': 1, '.mov': 1,
+};
+
+const midiaListar = () => comStudio(async () => ({ ok: true, midia: await pedir('GET', '/api/midia') }));
+
+const midiaEnviar = ({ arquivo, nome }) => comStudio(async () => {
+    if (!arquivo) return { ok: false, error: 'Diga o caminho do arquivo (arquivo: "foto.jpg").' };
+    const caminho = path.resolve(arquivo);
+    if (!fs.existsSync(caminho)) return { ok: false, error: `Arquivo não existe: ${arquivo}` };
+
+    const ext = path.extname(caminho).toLowerCase();
+    if (!TIPOS_MIDIA[ext]) {
+        return { ok: false, error: `Formato não aceito: ${ext}`, aceitos: Object.keys(TIPOS_MIDIA).join(' ') };
+    }
+    const bytes = fs.statSync(caminho).size;
+    if (bytes > 60 * 1024 * 1024) return { ok: false, error: `Arquivo tem ${(bytes / 1048576).toFixed(1)} MB; o limite é 60 MB.` };
+
+    const tipo = { '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.gif': 'image/gif',
+        '.webp': 'image/webp', '.svg': 'image/svg+xml', '.avif': 'image/avif', '.mp3': 'audio/mpeg',
+        '.m4a': 'audio/mp4', '.wav': 'audio/wav', '.ogg': 'audio/ogg', '.aac': 'audio/aac',
+        '.flac': 'audio/flac', '.opus': 'audio/opus', '.weba': 'audio/webm', '.mp4': 'video/mp4',
+        '.webm': 'video/webm', '.mov': 'video/quicktime' }[ext] || 'application/octet-stream';
+
+    const dados = `data:${tipo};base64,` + fs.readFileSync(caminho).toString('base64');
+    const r = await pedir('POST', '/api/midia', { nome: nome || path.basename(caminho), dados }, 120000);
+    return { ok: true, ...r, comoUsar: `Use "${r.url}" em fundo.imagem, em src de uma imagem, ou em trilha.src.` };
+});
+
 module.exports = {
     BASE, PORTA, CASA,
     garantirNoAr, estaNoAr, prepararCasa, pythonCmd,
     manual, ferramentas, spec, listar, ler, criar, atualizar,
+    midiaListar, midiaEnviar,
 };

package/lib/tools.js

@@ -10,7 +10,7 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
-const { exec } = require('child_process');
+const { exec, execFile } = require('child_process');
 const browser = require('./browser');
 const desktop = require('./desktop');
 const referencia = require('./referencia');
@@ -165,19 +165,41 @@ async function runShell(command, timeout = 60000, cwd) {
     });
 }
 
-async function openInBrowser(target) {
+// `target` vem do modelo (args.target) — que por sua vez pode ter lido de uma
+// página não confiável (prompt injection via pesquisar_referencia/browser_read).
+// 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).
+function openInBrowser(target) {
     const p = os.platform();
-    const cmd = p === 'darwin' ? `open "${target}"` : p === 'win32' ? `start "" "${target}"` : `xdg-open "${target}"`;
-    const r = await runShell(cmd);
-    return r.ok ? { ok: true, opener: cmd.split(' ')[0] } : { ok: false, error: r.stderr || 'falhou ao abrir' };
+    const [cmd, args, opener] = p === 'darwin' ? ['open', [target], 'open']
+        : p === 'win32' ? ['cmd.exe', ['/c', 'start', '', target], 'start']
+        : ['xdg-open', [target], 'xdg-open'];
+    return new Promise((resolve) => {
+        execFile(cmd, args, { timeout: 10000 }, (error, stdout, stderr) => {
+            resolve(error ? { ok: false, error: (stderr || error.message || '').toString() } : { ok: true, opener });
+        });
+    });
 }
 
 async function runInNewTerminal(command, cwd) {
     const p = os.platform();
+    const pastaAlvo = cwd || '.';
+    // pastaAlvo normalmente é a pasta do projeto, mas pode vir de input do
+    // modelo — sem checar, um valor malicioso quebra pra fora do "cd" embutido
+    // no comando que abre o terminal (AppleScript/cmd/x-terminal-emulator),
+    // que reinterpreta a string inteira como shell (achado de segurança).
+    // Recusa em vez de tentar escapar certo em três dialetos de shell ao
+    // mesmo tempo (osascript, cmd.exe, sh) — "command" continua livre de
+    // propósito, é o próprio contrato desta tool (abrir terminal com um
+    // comando de shell de verdade).
+    if (/["'`;&|$\\]/.test(pastaAlvo)) {
+        return { ok: false, error: `Pasta com caractere não permitido: ${pastaAlvo}` };
+    }
     let cmd;
-    if (p === 'darwin') cmd = `osascript -e 'tell application "Terminal" to do script "cd ${cwd || '.'} && ${command}"'`;
-    else if (p === 'win32') cmd = `start cmd /k "cd /d ${cwd || '.'} && ${command}"`;
-    else cmd = `x-terminal-emulator -e "bash -c 'cd ${cwd || '.'} && ${command}; exec bash'"`;
+    if (p === 'darwin') cmd = `osascript -e 'tell application "Terminal" to do script "cd ${pastaAlvo} && ${command}"'`;
+    else if (p === 'win32') cmd = `start cmd /k "cd /d ${pastaAlvo} && ${command}"`;
+    else cmd = `x-terminal-emulator -e "bash -c 'cd ${pastaAlvo} && ${command}; exec bash'"`;
     const r = await runShell(cmd);
     return r.ok ? { ok: true, opener: cmd.split(' ')[0] } : { ok: false, error: r.stderr || 'falhou' };
 }
@@ -476,6 +498,11 @@ async function despachar(name, args, ctx) {
                 return studio.atualizar({ id: args.id, titulo: args.titulo, doc: args.doc });
             case 'studio_listar':
                 return studio.listar();
+            case 'studio_midia':
+                // Sem arquivo, lista o que já foi enviado; com arquivo, envia.
+                return args.arquivo
+                    ? studio.midiaEnviar({ arquivo: resolveInProject(args.arquivo, projectDir), nome: args.nome })
+                    : studio.midiaListar();
 
             case 'desktop_double_click':
                 return desktop.doubleClick(args.x, args.y);

package/lib/ui.js

@@ -4,7 +4,6 @@
 
 'use strict';
 
-const readline = require('readline');
 
 // ── Paleta ───────────────────────────────────────────────────────────────
 // Vem do design system do produto (product-plan/design-system): primária cyan,
@@ -264,39 +263,6 @@ class Spinner {
     }
 }
 
-// Barra de progresso estilo Claude Code — silenciosa, elegante
-class ProgressBar {
-    constructor(label = 'Instalando') {
-        this.label = label;
-        this.width = 30;
-        this.progress = 0;
-        this.timer = null;
-        this.done = false;
-    }
-    start() {
-        process.stdout.write(`  ${c.muted(this.label)} [`);
-        this.timer = setInterval(() => {
-            if (this.done) return;
-            this.progress = Math.min(this.progress + 1, this.width);
-            const filled = '█'.repeat(this.progress);
-            const empty = '░'.repeat(this.width - this.progress);
-            process.stdout.write(`\r  ${c.muted(this.label)} [${c.brand(filled)}${c.dim(empty)}] ${c.muted(Math.round((this.progress/this.width)*100) + '%')}`);
-        }, 200);
-        return this;
-    }
-    tick() {
-        this.progress = Math.min(this.progress + 2, this.width);
-        const filled = '█'.repeat(this.progress);
-        const empty = '░'.repeat(this.width - this.progress);
-        process.stdout.write(`\r  ${c.muted(this.label)} [${c.brand(filled)}${c.dim(empty)}] ${c.muted(Math.round((this.progress/this.width)*100) + '%')}`);
-    }
-    stop() {
-        this.done = true;
-        if (this.timer) { clearInterval(this.timer); this.timer = null; }
-        process.stdout.write(`\r  ${c.muted(this.label)} [${c.ok('██████████ DONE ██████████')}] ${c.ok('100%')}\n`);
-    }
-}
-
 function actionHeader(name, args) {
     const nice = {
         read_file:'Read', write_file:'Write', edit_file:'Edit', multi_edit:'MultiEdit',
@@ -422,38 +388,5 @@ function friendlyError(raw) {
     return clean.length > 200 ? clean.slice(0, 200) + '…' : clean || 'Algo deu errado.';
 }
 
-function toolLine(text) { return `  ${c.dim('⎿')} ${c.muted(text)}`; }
-
-function toolResult(result) {
-    if (!result) return '';
-    if (result.ok === false) return c.err(`  ✗ ${result.error || 'failed'}`);
-    if (result.created !== undefined) return c.ok(`  ${result.created?'created':'updated'} · ${fmtBytes(result.bytes||0)}`);
-    return '';
-}
-
-function fmtBytes(n) {
-    if (n < 1024) return `${n} B`;
-    if (n < 1024*1024) return `${(n/1024).toFixed(1)} KB`;
-    return `${(n/(1024*1024)).toFixed(1)} MB`;
-}
-
-function renderMarkdown(text) {
-    return text.replace(/\*\*([^*]+)\*\*/g,'$1').replace(/__([^_]+)__/g,'$1').replace(/`([^`]+)`/g,'$1').replace(/^#{1,6}\s+/gm,'');
-}
-
-// Pergunta Yes/No — aguarda resposta real do usuário
-function askYesNo(question) {
-    return new Promise((resolve) => {
-        const rl = readline.createInterface({
-            input: process.stdin,
-            output: process.stdout,
-        });
-        rl.question(`${c.brand('?')} ${question} ${c.muted('(Y/n)')} `, (answer) => {
-            rl.close();
-            const a = (answer || '').trim().toLowerCase();
-            resolve(a === 'y' || a === 'yes' || a === '');
-        });
-    });
-}
 
-module.exports = { c, mascot, welcomeBox, Spinner, ProgressBar, actionHeader, toolLine, toolResult, fmtBytes, renderMarkdown, askYesNo, friendlyError, visibleWidth, stripAnsi, truncate, padRight };
+module.exports = { c, mascot, welcomeBox, Spinner, actionHeader, friendlyError, visibleWidth, stripAnsi, truncate, padRight };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "8.1.0",
+  "version": "8.2.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/ferramentas/corte.md

@@ -60,6 +60,39 @@ livre de direitos, ou uma das trilhas geradas acima.
 
 ---
 
+## Narração
+
+A voz que fala por cima do vídeo. Vai **na cena**, e o estúdio narra sozinho
+na hora de tocar — sem gravar nada, sem arquivo:
+
+```json
+{ "layout": "centro", "duracao": 6,
+  "narracao": "O texto que a voz vai falar nesta cena.",
+  "elementos": [ ... ] }
+```
+
+Ajuste da voz no **documento** (opcional):
+
+```json
+"voz": { "velocidade": 1, "tom": 1, "volume": 1, "lang": "pt-BR" }
+```
+
+Regras que fazem diferença:
+
+- **Escreva para o ouvido, não para o olho.** A narração NÃO repete o texto da
+  tela: a tela dá o título, a voz dá o argumento. Repetir os dois é o erro mais
+  comum, e soa a leitura de slide.
+- **Caiba na duração.** Fale ~2,5 palavras por segundo: uma cena de 6s aguenta
+  ~15 palavras. Texto mais longo que a cena é cortado no meio.
+- **Uma ideia por cena**, em uma ou duas frases curtas. Ponto final ajuda a voz
+  a respirar.
+- Para o vídeo ficar mudo de propósito, é só não pôr `narracao` em cena nenhuma.
+
+O usuário também pode gravar a própria voz pelo editor; aí a cena ganha
+`narracaoAudio` com o arquivo, e ela tem prioridade sobre a voz sintetizada.
+
+---
+
 ## Transições
 
 Na cena, `transicao` define como ela **entra**:

package/studio/server.py

@@ -395,6 +395,24 @@ class Handler(SimpleHTTPRequestHandler):
         except Exception:
             return {}
 
+    # Achado de segurança: POST/PUT/DELETE sem checagem de Origin é CSRF — uma
+    # página de terceiro (aberta no MESMO navegador, sem relação nenhuma com o
+    # Studio) consegue disparar um fetch() com Content-Type: text/plain (que
+    # não exige preflight de CORS) contra http://127.0.0.1:7777 e o pedido
+    # chega igual a um legítimo. Bloqueia quando o Origin existe e não é o
+    # próprio servidor — sem Origin nenhum (cliente não-navegador, como o CLI
+    # do PrimoCode via http nativo do Node) continua liberado, já que isso
+    # nunca é o vetor de um navegador sendo usado contra o usuário.
+    def origem_ok(self):
+        origem = self.headers.get("Origin")
+        if not origem:
+            return True
+        esperados = {
+            "http://127.0.0.1:%d" % PORTA,
+            "http://localhost:%d" % PORTA,
+        }
+        return origem in esperados
+
     # -------------------------------------------------------------- rotas --
 
     @seguro
@@ -502,6 +520,8 @@ class Handler(SimpleHTTPRequestHandler):
 
     @seguro
     def do_POST(self):
+        if not self.origem_ok():
+            return self.js({"erro": "origem não permitida"}, 403)
         rota = urlparse(self.path).path
         if rota == "/api/midia":
             corpo, status = guardar_midia(self.corpo())
@@ -527,6 +547,8 @@ class Handler(SimpleHTTPRequestHandler):
 
     @seguro
     def do_PUT(self):
+        if not self.origem_ok():
+            return self.js({"erro": "origem não permitida"}, 403)
         m = re.fullmatch(r"/api/arquivos/([^/]+)", urlparse(self.path).path)
         if not m:
             return self.js({"erro": "não encontrado"}, 404)
@@ -547,6 +569,8 @@ class Handler(SimpleHTTPRequestHandler):
 
     @seguro
     def do_DELETE(self):
+        if not self.origem_ok():
+            return self.js({"erro": "origem não permitida"}, 403)
         rota = urlparse(self.path).path
         m = re.fullmatch(r"/api/midia/([^/]+)", rota)
         if m:

package/studio/web/tool.html

@@ -65,6 +65,10 @@
   document.getElementById("btn-pdf").innerHTML = svgIcone("tela");
   document.getElementById("btn-baixar").innerHTML = svgIcone("baixar");
 </script>
+<script src="/js/audio.js"></script>
+<script src="/js/narracao.js"></script>
+<script src="/js/midia.js"></script>
+<script src="/js/exportar.js"></script>
 <script src="/js/editor.js"></script>
 </body>
 </html>

package/studio/web/view.html

@@ -15,6 +15,8 @@
 <script src="/js/render.js"></script>
 <script src="/js/render-prosa.js"></script>
 <script src="/js/render-grade.js"></script>
+<script src="/js/audio.js"></script>
+<script src="/js/narracao.js"></script>
 <script src="/js/player.js"></script>
 </body>
 </html>