primocode 8.22.0 → 8.25.0

package/lib/act.js

@@ -349,6 +349,12 @@ async function runAct(userPrompt, opts) {
     // Quem já foi chamado, e quantas vezes. Ver lib/repeticao.js.
     const jaChamado = repeticao.novo();
     let voltasEmFalso = 0;
+    // Pesquisas que voltaram de mãos vazias. A partir da terceira, a tool
+    // para de rodar e devolve ORDEM DE SEGUIR: sem isto o agente entrava em
+    // ciclo — buscava, não achava, lia "tente outra consulta", buscava de
+    // novo — até a cota do minuto acabar e o modelo responder vazio. Foi
+    // assim que "crie um vídeo para a tostudy" morreu sem entregar nada.
+    let pesquisasSecas = 0;
     let rodadasParadas = 0;
 
     const messages = [];
@@ -515,9 +521,22 @@ async function runAct(userPrompt, opts) {
             // 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) {
+            if (!finalText && respostasVazias < 3 && !PARAR) {
                 respostasVazias++;
                 if (!subagent) console.log(ident(profundidade) + c.dim('  ⎿ o modelo respondeu vazio — tentando de novo'));
+                // Repetir o MESMO contexto costuma produzir o mesmo vazio: se
+                // o turno anterior já engasgou, o que falta é um empurrão
+                // curto e concreto. A partir da segunda vez, entra um pedido
+                // explícito de fechamento — barato em tokens (é justamente
+                // quando a cota está no fim) e suficiente para o modelo
+                // escrever a resposta ou chamar finish.
+                if (respostasVazias >= 2) {
+                    messages.push({
+                        role: 'user',
+                        content: 'Sua última resposta veio vazia. Não pesquise mais nem explique o processo: '
+                            + 'faça agora a entrega pedida com o que você já tem e finalize.',
+                    });
+                }
                 iteration--;
                 continue;
             }
@@ -616,6 +635,22 @@ async function runAct(userPrompt, opts) {
                 temPasta = true;
             }
 
+            if (tc.name === 'pesquisar_referencia' && pesquisasSecas >= 3) {
+                voltasEmFalso++;
+                console.log(ident(profundidade) + actionHeader(tc.name, tc.arguments));
+                console.log(ident(profundidade) + c.muted('  ⎿ ') + c.warn('3 pesquisas sem resultado — siga com o que já tem'));
+                messages.push({
+                    role: 'tool',
+                    tool_call_id: tc.id,
+                    content: 'PARE DE PESQUISAR. Três buscas seguidas não trouxeram fonte nenhuma; '
+                        + 'mais uma vai gastar a cota e devolver o mesmo nada. FAÇA AGORA a entrega '
+                        + 'pedida com o que você já sabe. Se faltar um fato específico (número, data, '
+                        + 'preço, nome de pessoa), NÃO invente: escreva a peça sem ele e avise o '
+                        + 'usuário no final, em uma linha, o que não deu para confirmar.',
+                });
+                continue;
+            }
+
             algoRodou = true;
             console.log(ident(profundidade) + actionHeader(tc.name, tc.arguments));
             const result = await tools.execute(tc.name, tc.arguments, { projectDir: pastaAtual });
@@ -626,6 +661,11 @@ async function runAct(userPrompt, opts) {
             // não corrige um teste quebrado noutro lugar; antes isto zerava
             // a lista inteira e o agente conseguia dizer "concluído" com uma
             // falha real ainda pendente.
+            if (tc.name === 'pesquisar_referencia') {
+                if (result && result.ok === false) pesquisasSecas++;
+                else pesquisasSecas = 0;      // achou fonte: o ciclo se rompeu
+            }
+
             if (result && result.ok === false) {
                 falhasPendentes.push({
                     tool: tc.name,

package/lib/catalogo.js

@@ -89,6 +89,8 @@ const GRUPOS = [
             { 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).' },
+            { tool: 'studio_analisar',  escreve: false, faz: 'ouve um vídeo já enviado e diz onde estão as pausas, para cortá-las',
+              args: 'arquivo: a URL "/midia/..." do vídeo. pausa (opcional): segundos a partir dos quais conta como pausa (padrão 0.6). Devolve "trechos": vire cada um numa cena com {"tipo":"clipe","de":...,"ate":...}.' },
         ],
     },
     {

package/lib/config.js

@@ -135,9 +135,31 @@ function findSimilarProject(projectName, minScore = 0.4) {
     return best;
 }
 
-function readGeneralMemory(limit = 2000) {
-    try { return fs.readFileSync(GENERAL_MEMORY, 'utf-8').slice(0, limit); }
+/* A memória geral como o modelo precisa vê-la: o começo E o fim.
+ *
+ * Isto lia os PRIMEIROS 2000 caracteres — que são o cabeçalho do template.
+ * As anotações vão para o FIM do arquivo, então tudo que o agente aprendia
+ * ficava fora do corte e nunca chegava ao modelo. O usuário via o sintoma
+ * exato: "nunca lembra do que fez no chat anterior". O arquivo enchia, a
+ * poda funcionava, e nada daquilo era lido.
+ *
+ * Agora vêm as duas pontas: o cabeçalho (o que a PESSOA escreveu sobre si,
+ * que é permanente) e as anotações mais recentes (o que o agente aprendeu,
+ * que é o que muda). O meio é o que se perde — e é o certo a perder. */
+function readGeneralMemory(limit = 2600) {
+    let texto;
+    try { texto = fs.readFileSync(GENERAL_MEMORY, 'utf-8'); }
     catch { return ''; }
+    if (texto.length <= limit) return texto;
+
+    const blocos = texto.split(/\n(?=### )/);
+    const cabeca = (blocos.shift() || '').slice(0, Math.floor(limit * 0.45));
+    let recente = '';
+    for (let i = blocos.length - 1; i >= 0; i--) {
+        if (cabeca.length + recente.length + blocos[i].length > limit) break;
+        recente = '\n' + blocos[i] + recente;
+    }
+    return cabeca + (recente ? '\n' + recente : '');
 }
 
 // Recebem o DIRETÓRIO de trabalho, não o nome do projeto: quando o PrimoCode
@@ -156,6 +178,34 @@ function appendProjectMemory(dir, entry) {
     } catch {}
 }
 
+/* O que o usuário JÁ criou no estúdio, para "lembra do vídeo tal" funcionar.
+ *
+ * A memória geral guarda "pedido → resultado" em texto corrido, e o id da
+ * peça se perdia no meio da frase. O dono pediu:
+ *
+ *   "Ter memória entre os chats. Ela lembrar do que fez no chat anterior.
+ *    Quando eu falar 'lembra do vídeo tal', ela vai lembrar. Na estrutura de
+ *    arquivos, eu quero que você crie para mim a partir de vídeos, não só de
+ *    código."
+ *
+ * Uma linha por peça, com tipo, título e id — que é o que o agente precisa
+ * para chamar studio_atualizar ou abrir de novo. Sem link: ele é derivável
+ * do id e ocuparia espaço em todo pedido seguinte, para sempre.
+ *
+ * A entrada é DEDUPLICADA por id: recriar ou atualizar a mesma peça não pode
+ * encher a memória de cópias — foi o que aconteceria num vídeo ajustado dez
+ * vezes numa tarefa só. */
+function lembrarCriacao({ ferramenta, titulo, id }) {
+    if (!id) return;
+    const linha = `- criou ${ferramenta || 'peça'} "${String(titulo || 'sem título').slice(0, 70)}" — id \`${id}\``;
+    try {
+        ensureStructure();
+        const texto = fs.existsSync(GENERAL_MEMORY) ? fs.readFileSync(GENERAL_MEMORY, 'utf-8') : '';
+        if (texto.includes(`\`${id}\``)) return;      // já anotada
+        appendGeneralMemory(linha);
+    } catch {}
+}
+
 // A contraparte de appendProjectMemory, para o que vale em TODOS os projetos
 // (nome do usuário, preferência, decisão de longo prazo). Existia a promessa
 // no prompt — "escreve aqui o que descobrir sobre você" — mas nenhuma função
@@ -240,4 +290,5 @@ module.exports = {
     ensureStructure, slugify, stripAccents,
     createProjectDir, getProjectDir, listProjects, findSimilarProject,
     readGeneralMemory, readProjectMemory, appendProjectMemory, appendGeneralMemory,
+    lembrarCriacao,
 };

package/lib/referencia.js

@@ -244,21 +244,116 @@ function relevante(cand, palavras) {
  * Foi o que salvou este caso — parisgroup.ai abre e tem o texto todo, enquanto
  * DuckDuckGo devolvia 202 e o Bing devolvia Paris, a cidade.
  *
- * Só dispara quando a consulta tem DUAS PALAVRAS COM INICIAL MAIÚSCULA
- * seguidas, que é como se escreve nome de empresa. "react hooks tutorial" não
- * dispara; "Paris Group" dispara.
+ * Reconhece nome de DUAS palavras com maiúscula ("Paris Group") e também de
+ * UMA palavra, mesmo em minúscula — que é como as pessoas digitam no meio de
+ * uma frase. Exigir duas maiúsculas custou caro: para "crie um vídeo para a
+ * tostudy, plataforma de aprendizagem com IA" a função devolvia lista vazia,
+ * o buscador não conhecia o nome, a pesquisa falhava — e o agente repetia
+ * buscas até a tarefa morrer, com tostudy.ai no ar o tempo todo.
  */
+
+// Palavras que aparecem em qualquer pedido e NUNCA são o nome da marca. Sem
+// esta peneira o chute viraria plataforma.com, aprendizagem.com, video.com.
+const NAO_E_MARCA = new Set([
+    'plataforma', 'plataformas', 'empresa', 'startup', 'site', 'oficial', 'aplicativo', 'app',
+    'aprendizagem', 'aprendizado', 'ensino', 'educacao', 'educacional', 'curso', 'cursos', 'escola',
+    'video', 'videos', 'reels', 'anuncio', 'campanha', 'marketing', 'institucional', 'apresentacao',
+    'inteligencia', 'artificial', 'brasil', 'brasileira', 'sobre', 'para', 'como', 'uma', 'que',
+    'crie', 'criar', 'faca', 'fazer', 'quero', 'preciso', 'estudo', 'estudos', 'tecnologia',
+    'software', 'sistema', 'servico', 'servicos', 'produto', 'produtos', 'negocio', 'digital',
+    'documentacao', 'tutorial', 'exemplo', 'exemplos', 'guia', 'referencia',
+]);
+
+function _slug(txt) {
+    return String(txt || '').normalize('NFD').replace(/[̀-ͯ]/g, '')
+        .toLowerCase().replace(/[^a-z0-9]/g, '');
+}
+
 function sitesProvaveis(consulta) {
-    const nome = /\b([A-ZÀ-Ý][\w\u00C0-\u024F]{1,})\s+([A-ZÀ-Ý][\w\u00C0-\u024F]{1,})\b/.exec(String(consulta || ''));
-    if (!nome) return [];
-    const slug = `${nome[1]}${nome[2]}`
-        .normalize('NFD').replace(/[\u0300-\u036f]/g, '').toLowerCase().replace(/[^a-z0-9]/g, '');
-    if (slug.length < 5) return [];
-    return ['com', 'ai', 'com.br', 'io', 'co'].map((tld) => ({
-        titulo: `${nome[1]} ${nome[2]} — site oficial`,
-        url: `https://www.${slug}.${tld}`,
-        nota: 'site provável da empresa',
+    const texto = String(consulta || '');
+    const marcas = [];
+
+    // Entre aspas é a forma de a pessoa dizer "o nome é ESTE". Vem primeiro.
+    const citado = /["“'”]([^"“'”]{3,40})["“'”]/.exec(texto);
+    if (citado) marcas.push({ rotulo: citado[1].trim(), slug: _slug(citado[1]) });
+
+    const duplo = /\b([A-ZÀ-Ý][\wÀ-ɏ]{1,})\s+([A-ZÀ-Ý][\wÀ-ɏ]{1,})\b/.exec(texto);
+    if (duplo) marcas.push({ rotulo: `${duplo[1]} ${duplo[2]}`, slug: _slug(duplo[1] + duplo[2]) });
+
+    // Marca de UMA palavra só é chutada quando a consulta dá SINAL de que
+    // fala de um negócio ("plataforma", "empresa", "app", "site"...) ou põe o
+    // nome entre aspas. Sem essa exigência, "react hooks tutorial" viraria
+    // react.com e "como fazer um bolo" viraria fazer.com — dez buscas
+    // inúteis para cada pesquisa técnica.
+    const SINAL_DE_MARCA = /\b(plataforma|empresa|startup|site|marca|neg[óo]cio|produto|servi[çc]o|app|aplicativo|institucional|cliente|fabricante|loja|ag[êe]ncia|ecommerce|e-commerce|saas)\b/i;
+    const temSinal = SINAL_DE_MARCA.test(texto) || !!citado;
+    if (temSinal) {
+        const util = (bruto) => {
+            const s = _slug(bruto);
+            return (s.length >= 4 && s.length <= 24 && !NAO_E_MARCA.has(s) && !/^\d+$/.test(s)) ? s : null;
+        };
+        // O nome vem quase sempre depois de artigo ou preposição: "um mouse
+        // DA multilaser", "vídeo para A tostudy". Pegar simplesmente a
+        // primeira palavra não-genérica escolhia o verbo do pedido
+        // ("anunciar") e chutava anunciar.ai.
+        const depoisDeArtigo = [...texto.matchAll(/\b(?:d[aeo]s?|[ao]|n[ao]s?|à)\s+([A-Za-zÀ-ÿ][\wÀ-ÿ-]{3,23})\b/gi)];
+        for (const m of depoisDeArtigo) {
+            const s = util(m[1]);
+            if (s) { marcas.push({ rotulo: m[1], slug: s }); break; }
+        }
+        // Só quando o artigo não entregou nada: senão o verbo do pedido
+        // ("anunciar") entraria junto e gastaria dez sondas à toa.
+        if (!marcas.length) {
+            for (const bruto of texto.split(/[\s,.;:!?()]+/)) {
+                const s = util(bruto);
+                if (s) { marcas.push({ rotulo: bruto, slug: s }); break; }
+            }
+        }
+    }
+
+    const vistos = new Set();
+    const saida = [];
+    for (const m of marcas.slice(0, 2)) {
+        if (!m.slug || m.slug.length < 4 || vistos.has(m.slug)) continue;
+        vistos.add(m.slug);
+        for (const tld of ['ai', 'com', 'com.br', 'io', 'co']) {
+            // Com e sem "www": um resolve onde o outro não, e quem decide é a
+            // hospedagem. Como estes candidatos passam pela sonda antes de
+            // entrar na fila de leitura, tentar os dois não custa vaga.
+            saida.push({ titulo: `${m.rotulo} — site oficial`, url: `https://${m.slug}.${tld}`, nota: 'site provável da empresa' });
+            saida.push({ titulo: `${m.rotulo} — site oficial`, url: `https://www.${m.slug}.${tld}`, nota: 'site provável da empresa' });
+        }
+    }
+    return saida;
+}
+
+/**
+ * Sonda os domínios chutados e devolve só os que responderam, com o HTML já
+ * na mão. Sem isto, dez chutes entrariam na fila de leitura e expulsariam os
+ * resultados de verdade do buscador — e a maioria deles nem existe.
+ */
+async function chutesVivos(chutes, limite = 2) {
+    if (!chutes.length) return { vivos: [], html: new Map() };
+    // 12 s, não 6: a sonda roda em paralelo e a home de uma empresa hoje pesa
+    // centenas de KB. Com 6 s o site CERTO chegava atrasado, era descartado
+    // como morto, e a pesquisa falhava com o site no ar — medido.
+    const respostas = await Promise.all(chutes.slice(0, 12).map(async (c) => {
+        const html = await pegar(c.url, { timeout: 12000 });
+        return html && html.length > 500 ? { cand: c, html } : null;
     }));
+    const vivos = [];
+    const html = new Map();
+    const dominios = new Set();
+    for (const r of respostas.filter(Boolean)) {
+        // www.x.ai e x.ai são o mesmo site: vale o primeiro que respondeu.
+        const raiz = r.cand.url.replace(/^https?:\/\/(www\.)?/, '').replace(/\/$/, '');
+        if (dominios.has(raiz)) continue;
+        dominios.add(raiz);
+        vivos.push(r.cand);
+        html.set(r.cand.url, r.html);
+        if (vivos.length >= limite) break;
+    }
+    return { vivos, html };
 }
 
 // Links que não são referência de nada — resultado de busca sujo.
@@ -460,7 +555,17 @@ async function pesquisar({ consulta, paginas = 3 }) {
     // O site provável da empresa vai NA FRENTE: quando a consulta nomeia um
     // negócio, o site dele é a melhor fonte que existe, e não depende de
     // buscador nenhum estar de bom humor.
-    const chutes = sitesProvaveis(termo);
+    // Os chutes de domínio são SONDADOS antes de entrar na fila: só os que
+    // respondem ocupam vaga. São dez palpites (5 TLDs x com/sem www) e a
+    // maioria não existe — enfileirar todos expulsaria os resultados reais
+    // do buscador. A sonda roda em paralelo e o HTML já volta aproveitado.
+    const palpites = sitesProvaveis(termo);
+    const { vivos, html: htmlChutes } = await chutesVivos(palpites);
+    // A sonda ORDENA, não faz porteiro. Ela é uma corrida contra o relógio
+    // contra home pesada e rede lenta, e perdê-la não pode significar perder
+    // o site certo: quando nada responde a tempo, os primeiros palpites vão
+    // para a fila mesmo assim e o laço de leitura tenta de novo, sem pressa.
+    const chutes = vivos.length ? vivos : palpites.slice(0, 3);
     const palavras = palavrasDaConsulta(termo);
     const brutos = [...chutes, ...web, ...so, ...docsConhecidas(termo)];
 
@@ -481,7 +586,15 @@ async function pesquisar({ consulta, paginas = 3 }) {
             provavelCausa: descartados
                 ? `Vieram ${descartados} link(s), mas nenhum era sobre "${termo}" — o buscador não achou o assunto e devolveu página aleatória. Fonte errada é pior que fonte nenhuma, então foram descartadas.`
                 : 'Os buscadores costumam recusar chamadas automáticas (bloqueio ou limite por excesso de buscas seguidas), e não a sua conexão.',
-            comoCorrigir: 'Tente OUTRA consulta, mais curta e específica. Se souber o site do assunto, vá direto nele com browser_open + browser_read — é o caminho mais confiável para fato de empresa.',
+            // "Tente outra consulta" era um convite ao ciclo: o agente
+            // reformulava a busca, falhava igual, e repetia até a cota acabar.
+            // A ordem agora é explícita — no máximo UMA nova tentativa, e por
+            // um caminho DIFERENTE (o site direto), senão segue sem a fonte.
+            comoCorrigir: 'NÃO repita esta busca com outras palavras — o buscador não conhece o assunto e '
+                + 'vai devolver o mesmo nada. Se souber (ou conseguir deduzir) o site, tente UMA vez '
+                + 'browser_open + browser_read nele. Se também não abrir, SIGA COM A TAREFA usando o que '
+                + 'você já sabe e avise ao usuário, no final, qual fato não deu para confirmar. Nunca invente '
+                + 'dado sobre empresa, número, data, preço ou pessoa.',
         };
     }
 
@@ -491,7 +604,9 @@ async function pesquisar({ consulta, paginas = 3 }) {
     const chutesLidos = [];
     for (const cand of candidatos) {
         if (lidas.length >= paginas) break;
-        const html = await pegar(cand.url);
+        // A sonda já baixou o HTML dos chutes: reaproveita em vez de pedir
+        // a mesma página duas vezes.
+        const html = htmlChutes.get(cand.url) || await pegar(cand.url);
         if (!html) continue;
         const texto = textoDe(html);
         if (texto.length < 200) continue;
@@ -502,7 +617,17 @@ async function pesquisar({ consulta, paginas = 3 }) {
         // da página, sim. Sem esta prova o agente escreveria sobre a errada.
         const ehChute = cand.nota === 'site provável da empresa';
         if (ehChute) {
-            const nota = quantoBate({ titulo: texto.slice(0, 4000), url: cand.url }, palavras);
+            let nota = quantoBate({ titulo: texto.slice(0, 4000), url: cand.url }, palavras);
+            // O NOME DA MARCA no domínio, confirmado no texto da página, já é
+            // prova — e é a prova mais forte que existe. Exigir duas palavras
+            // genéricas da consulta ("plataforma", "aprendizagem") reprovava o
+            // site certo: tostudy.ai abria, dizia "ToStudy" na primeira linha,
+            // e mesmo assim era descartado por não repetir o vocabulário do
+            // pedido. O agente então repetia buscas até a tarefa morrer.
+            const marca = (cand.url.match(/^https?:\/\/(?:www\.)?([a-z0-9-]+)\./i) || [])[1] || '';
+            const textoLimpo = texto.slice(0, 8000).normalize('NFD')
+                .replace(/[\u0300-\u036f]/g, '').toLowerCase().replace(/[^a-z0-9]/g, '');
+            if (marca.length >= 4 && textoLimpo.includes(marca.toLowerCase())) nota = Math.max(nota, 2);
             if (nota < Math.min(2, palavras.length)) continue;
             // Passar não basta: entre dois domínios do MESMO nome, fica o que
             // fala mais do assunto. parisgroup.ai e parisgroup.co os dois
@@ -532,8 +657,10 @@ async function pesquisar({ consulta, paginas = 3 }) {
             error: 'achei os links mas não consegui abrir nenhum',
             consulta: termo,
             links: candidatos.map((c) => c.url),
-            comoCorrigir: 'Tente browser_open + browser_read num desses links, ou pesquise com outras palavras. '
-                + 'Se nada abrir, diga ao usuário que não conseguiu confirmar os fatos — NUNCA invente dado sobre empresa, data, preço ou pessoa.',
+            comoCorrigir: 'Tente browser_open + browser_read num desses links — UMA vez. Não refaça a busca '
+                + 'com outras palavras: os links são estes mesmos. Se nada abrir, SIGA COM A TAREFA e diga ao '
+                + 'usuário, no final, que não conseguiu confirmar os fatos — NUNCA invente dado sobre empresa, '
+                + 'data, preço ou pessoa.',
         };
     }
 

package/lib/studio.js

@@ -412,9 +412,32 @@ const TIPOS_MIDIA = {
 
 const midiaListar = () => comStudio(async () => ({ ok: true, midia: await pedir('GET', '/api/midia') }));
 
+/* O caminho como ele chega quando a pessoa ARRASTA o arquivo para o terminal.
+ *
+ * "Eu quero que eu consiga arrastar os meus vídeos pra dentro do terminal."
+ * Arrastar, num terminal, cola o caminho — e cola do jeito do sistema: o
+ * macOS escapa espaço com barra invertida, o Windows põe aspas em volta, e
+ * alguns colam file:// na frente. `path.resolve` de qualquer um desses dá um
+ * caminho que não existe, e a resposta era "arquivo não existe" para um
+ * arquivo que está bem ali.
+ */
+function limparCaminho(bruto) {
+    let s = String(bruto || '').trim();
+    if ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'"))) {
+        s = s.slice(1, -1);
+    }
+    if (/^file:\/\//i.test(s)) {
+        try { s = decodeURIComponent(s.replace(/^file:\/\//i, '')); } catch { /* fica como está */ }
+    }
+    // Só desescapa o que o shell escapa; um "\" de caminho do Windows fica.
+    s = s.replace(/\\([ ()'"&!$`\\])/g, '$1');
+    if (s.startsWith('~/') || s === '~') s = path.join(os.homedir(), s.slice(1));
+    return s.trim();
+}
+
 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);
+    const caminho = path.resolve(limparCaminho(arquivo));
     if (!fs.existsSync(caminho)) {
         return {
             ok: false,
@@ -430,22 +453,113 @@ const midiaEnviar = ({ arquivo, nome }) => comStudio(async () => {
         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 ehVideo = ext === '.mp4' || ext === '.webm' || ext === '.mov';
+    const teto = ehVideo ? 2 * 1024 * 1024 * 1024 : 60 * 1024 * 1024;
+    if (bytes > teto) {
+        return { ok: false, error: `Arquivo tem ${(bytes / 1048576).toFixed(1)} MB; `
+            + `o limite é ${Math.round(teto / 1048576)} 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';
+    // O corpo vai em pedaços, direto do disco para o socket. Em base64 um
+    // vídeo de celular precisaria caber inteiro na memória três vezes — e o
+    // Node estourava antes de o estúdio ver um byte.
+    const r = await enviarArquivo(caminho, nome || path.basename(caminho));
+    const comoUsar = ehVideo
+        ? `Use "${r.url}" no "src" de um elemento {"tipo":"clipe"}. Para cortar as pausas, `
+          + 'escreva VÁRIOS clipes do mesmo src, cada um com "de" e "ate" em segundos.'
+        : `Use "${r.url}" em fundo.imagem, em src de uma imagem, ou em trilha.src.`;
+    return { ok: true, ...r, comoUsar };
+});
 
-    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.` };
+/* PUT /api/midia/<nome> com o arquivo cru no corpo. */
+function enviarArquivo(caminho, nome) {
+    return new Promise((resolve, reject) => {
+        const bytes = fs.statSync(caminho).size;
+        const req = http.request({
+            hostname: '127.0.0.1', port: PORTA, method: 'PUT',
+            path: '/api/midia/' + encodeURIComponent(nome),
+            // Vídeo grande copiando para o disco leva tempo; meia hora é
+            // folga para um arquivo de duas horas, e continua sendo um teto.
+            timeout: 30 * 60 * 1000,
+            headers: { 'X-Primo-Agente': '1', 'Content-Type': 'application/octet-stream',
+                'Content-Length': bytes },
+        }, (res) => {
+            let texto = '';
+            res.setEncoding('utf8');
+            res.on('data', (c) => { texto += c; });
+            res.on('end', () => {
+                let corpo = null;
+                try { corpo = JSON.parse(texto); } catch { /* texto cru serve */ }
+                if (res.statusCode >= 400) {
+                    return reject(new Error((corpo && corpo.erro) || texto.slice(0, 300)));
+                }
+                resolve(corpo || {});
+            });
+        });
+        req.on('timeout', () => { req.destroy(new Error('o envio demorou demais')); });
+        req.on('error', reject);
+        const leitura = fs.createReadStream(caminho);
+        leitura.on('error', (e) => { req.destroy(e); reject(e); });
+        leitura.pipe(req);
+    });
+}
+
+/* ── Ouvir o vídeo para achar as pausas ──────────────────────────────────
+ *
+ * "Ele vai cortar as pausas demoradas no vídeo."
+ *
+ * Cortar pausa exige saber onde a fala para, e nada aqui lê o áudio de um
+ * .mp4: o PrimoCode não tem dependência, e o Python da máquina lê WAV e mais
+ * nada. ffmpeg resolveria e seria mais uma instalação de 80 MB para quem só
+ * quer editar um vídeo.
+ *
+ * Quem decodifica MP4, MOV e webm já está aberto na mesa. A conta roda numa
+ * aba que abre, trabalha e se fecha; aqui a gente espera a resposta.
+ *
+ * `abrir` é injetado (é a função de abrir navegador do tools.js) para esta
+ * camada não passar a conhecer o sistema operacional.
+ */
+const analisarAudio = ({ arquivo, pausa, abrir }) => comStudio(async () => {
+    if (!arquivo) return { ok: false, error: 'Diga qual mídia analisar (arquivo: "/midia/x.mp4").' };
+    const tarefa = await pedir('POST', '/api/analise', { arquivo, pausa });
+    if (abrir) { try { abrir(`${BASE}${tarefa.pagina}`); } catch { /* segue e expira */ } }
+
+    // Um vídeo de meia hora leva alguns segundos para decodificar; três
+    // minutos é folga com sobra, e continua sendo um teto — sem ele um
+    // navegador que nunca abriu deixaria a tarefa pendurada para sempre.
+    const prazo = Date.now() + 180000;
+    while (Date.now() < prazo) {
+        await new Promise((ok) => setTimeout(ok, 700));
+        const estado = await pedir('GET', `/api/analise/${tarefa.id}`, null, 8000).catch(() => null);
+        if (!estado) continue;
+        if (estado.estado === 'erro') {
+            return { ok: false, error: (estado.resultado && estado.resultado.erro) || 'a análise falhou' };
+        }
+        if (estado.estado === 'pronto') {
+            const r = estado.resultado || {};
+            return {
+                ok: true,
+                duracao: r.duracao,
+                cortado: r.cortado,
+                pausas: r.pausas,
+                trechos: r.trechos,
+                comoUsar: `${(r.trechos || []).length} trecho(s) sem pausa. Escreva UMA CENA por trecho, `
+                    + `cada uma com {"tipo":"clipe","src":"${arquivo}","de":<início>,"ate":<fim>}. `
+                    + 'NÃO escreva "duracao" nessas cenas: a cena já dura o trecho.',
+            };
+        }
+    }
+    return {
+        ok: false,
+        error: 'A aba de análise não respondeu em 3 minutos. Ela precisa do navegador aberto. '
+            + 'Siga sem o corte automático: escreva os trechos que o usuário pedir, ou use o vídeo inteiro '
+            + 'num clipe só (sem "de"/"ate").',
+    };
 });
 
 module.exports = {
     BASE, PORTA, CASA,
     garantirNoAr, estaNoAr, prepararCasa, pythonCmd,
     manual, ferramentas, spec, listar, ler, criar, atualizar, versoesDe,
-    midiaListar, midiaEnviar,
+    midiaListar, midiaEnviar, analisarAudio,
 };

package/lib/tools.js

@@ -172,6 +172,8 @@ async function runShell(command, timeout = 60000, cwd) {
 // `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;
+// Uma rodada de melhoria por tarefa (ver o aviso em studio_criar).
+let melhorouStudio = false;
 
 function openInBrowser(target) {
     const p = os.platform();
@@ -513,6 +515,13 @@ async function despachar(name, args, ctx) {
                 // 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.
+                // Fica anotado na memória geral: é assim que "lembra do
+                // vídeo tal" funciona na conversa seguinte. O id é o que
+                // permite reabrir ou ajustar sem recriar.
+                if (r && r.ok !== false && r.id) {
+                    cfg.lembrarCriacao({ ferramenta: r.ferramenta || args.ferramenta,
+                        titulo: r.titulo || args.titulo, id: r.id });
+                }
                 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
@@ -523,7 +532,24 @@ async function despachar(name, args, ctx) {
                         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.';
+                        // O estúdio revisa a peça e devolve o que ficou
+                        // monótono (mesmo fundo em tudo, transição repetida,
+                        // sem trilha). Sem este ramo o aviso mandaria "chame
+                        // finish, não ajuste" — e a revisão morreria ali, que
+                        // é justamente o "fica tudo genérico".
+                        //
+                        // UMA rodada de conserto, e acabou: mais que isso
+                        // vira o agente polindo sozinho enquanto o usuário
+                        // espera.
+                        if (Array.isArray(r.podeMelhorar) && r.podeMelhorar.length && !melhorouStudio) {
+                            melhorouStudio = true;
+                            r.aviso = 'JÁ ABERTO no navegador. Antes de finalizar, faça UMA correção: '
+                                + `use studio_atualizar no id "${r.id}" mandando SÓ as chaves que mudam, `
+                                + 'para resolver os pontos de "podeMelhorar". Depois chame finish. '
+                                + 'Não crie outro arquivo e não repita esta correção.';
+                        } else {
+                            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.`;
@@ -544,6 +570,14 @@ async function despachar(name, args, ctx) {
                 return args.arquivo
                     ? studio.midiaEnviar({ arquivo: resolveInProject(args.arquivo, projectDir), nome: args.nome })
                     : studio.midiaListar();
+            case 'studio_analisar':
+                // Ouvir o vídeo para achar as pausas. A conta acontece no
+                // navegador (é quem sabe decodificar MP4 sem instalar nada) —
+                // por isso passa a função de abrir, e por isso demora alguns
+                // segundos em vez de responder na hora.
+                return studio.analisarAudio({
+                    arquivo: args.arquivo, pausa: args.pausa, abrir: openInBrowser,
+                });
 
             case 'desktop_double_click':
                 return desktop.doubleClick(args.x, args.y);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "8.22.0",
+  "version": "8.25.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": {
@@ -8,7 +8,7 @@
   },
   "scripts": {
     "start": "node bin/primocode.js",
-    "test": "node test/tools.test.js && node test/ui.test.js && node test/modo.test.js && node test/pasta.test.js && node test/catalogo.test.js && node test/desktop.test.js && node test/effort.test.js && node test/claude-engine.test.js && node test/regressao.test.js && node test/memoria-conversa.test.js && node test/repeticao.test.js && node test/referencia.test.js && node test/parar.test.js && node test/continuar.test.js && node test/studio-spec.test.js && node test/studio-versoes.test.js && node test/voz.test.js && node test/editor.test.js && node test/estudio-projeto.test.js && node test/vocabulario.test.js"
+    "test": "node test/tools.test.js && node test/ui.test.js && node test/modo.test.js && node test/pasta.test.js && node test/catalogo.test.js && node test/desktop.test.js && node test/effort.test.js && node test/claude-engine.test.js && node test/regressao.test.js && node test/memoria-conversa.test.js && node test/repeticao.test.js && node test/referencia.test.js && node test/parar.test.js && node test/continuar.test.js && node test/studio-spec.test.js && node test/studio-versoes.test.js && node test/voz.test.js && node test/editor.test.js && node test/estudio-projeto.test.js && node test/vocabulario.test.js && node test/video-export.test.js && node test/monotonia.test.js && node test/clipe.test.js && node test/midia-envio.test.js && node test/pausas.test.js"
   },
   "engines": {
     "node": ">=18.17.0"