primocode 10.5.0 → 10.7.0

package/lib/leitura.js

@@ -0,0 +1,176 @@
+/**
+ * leitura.js — ler uma página FORA do modelo, em cascata, com teste de tamanho.
+ *
+ * Ideia levada do `ax` (yusukebe/ax, "curl pra agente"): o modelo não precisa
+ * do HTML, precisa da ESTRUTURA — título, subtítulos, o texto principal, os
+ * links. Extrair isso aqui, de graça e de forma determinística, poupa a janela
+ * de contexto de um modelo gratuito, que é curta.
+ *
+ * A cascata para no primeiro passo que basta:
+ *   1. busca simples + extração local (sem navegador, sem modelo);
+ *   2. se saiu pouco texto (página que só existe depois do JavaScript), o
+ *      navegador escondido de lib/browser.js renderiza e a extração roda de novo;
+ *   3. o que vai pro modelo cabe num orçamento de caracteres: corta por seção,
+ *      e os subtítulos ficam todos — o modelo sabe o que existe na página
+ *      mesmo quando o texto de uma seção não coube.
+ *
+ * A regra que vale mais que a ferramenta: o teste de "leu" é o TAMANHO do que
+ * saiu, não o status 200. Página que devolve 85 caracteres "deu certo" e não
+ * leu nada.
+ */
+
+'use strict';
+
+// 400, o mesmo piso da pesquisa: casca de SPA deixa 200-300 caracteres de menu.
+const MINIMO = 400;
+const ORCAMENTO = 4500;
+const MAX_LINKS = 12;
+
+const ENTIDADES = { nbsp: ' ', amp: '&', lt: '<', gt: '>', quot: '"', '#39': "'", apos: "'" };
+function desentidade(s) {
+    return String(s || '')
+        .replace(/&(nbsp|amp|lt|gt|quot|#39|apos);/g, (_, k) => ENTIDADES[k])
+        .replace(/&#(\d+);/g, (_, n) => { try { return String.fromCodePoint(Number(n)); } catch { return ' '; } });
+}
+const limpo = (s) => desentidade(String(s || '').replace(/<[^>]+>/g, ' ')).replace(/\s+/g, ' ').trim();
+
+function atributo(tag, nome) {
+    const m = tag.match(new RegExp(`\\b${nome}\\s*=\\s*("([^"]*)"|'([^']*)'|([^\\s>]+))`, 'i'));
+    return m ? desentidade(m[2] ?? m[3] ?? m[4] ?? '') : '';
+}
+
+/** O conteúdo da primeira tag `nome` que tiver texto de verdade (main, article). */
+function regiao(html, nome) {
+    const re = new RegExp(`<${nome}\\b[^>]*>([\\s\\S]*?)<\\/${nome}>`, 'gi');
+    let m;
+    while ((m = re.exec(html))) if (limpo(m[1]).length >= 200) return m[1];
+    return null;
+}
+
+/**
+ * HTML → estrutura legível. Sem dependência: expressão regular basta para o
+ * que o modelo precisa (não é um parser, e não tenta ser).
+ * @returns {{titulo:string, descricao:string, secoes:Array<{titulo:string,texto:string}>, texto:string, links:Array<{texto:string,url:string}>}}
+ */
+function estruturaDe(html, base) {
+    const bruto = String(html || '').replace(/<!--[\s\S]*?-->/g, ' ')
+        .replace(/<(script|style|noscript|svg|template|iframe)\b[\s\S]*?<\/\1>/gi, ' ');
+    const titulo = limpo((bruto.match(/<title[^>]*>([\s\S]*?)<\/title>/i) || [])[1]);
+    const meta = (bruto.match(/<meta\b[^>]*(name|property)\s*=\s*["'](description|og:description)["'][^>]*>/i) || [])[0] || '';
+    const descricao = atributo(meta, 'content').trim();
+
+    // O miolo: <main>, senão <article>, senão o <body> sem menu, rodapé e lateral.
+    let corpo = regiao(bruto, 'main') || regiao(bruto, 'article')
+        || ((bruto.match(/<body\b[^>]*>([\s\S]*)<\/body>/i) || [])[1] ?? bruto);
+    corpo = corpo.replace(/<(nav|footer|header|aside)\b[\s\S]*?<\/\1>/gi, ' ');
+
+    const links = [];
+    const vistos = new Set();
+    corpo.replace(/<a\b([^>]*)>([\s\S]*?)<\/a>/gi, (_, attrs, dentro) => {
+        const href = atributo(attrs, 'href');
+        const texto = limpo(dentro);
+        if (!href || !texto || /^(#|javascript:|mailto:)/i.test(href) || links.length >= MAX_LINKS) return '';
+        let url = href;
+        try { url = new URL(href, base || undefined).href; } catch { /* fica relativo */ }
+        if (!vistos.has(url)) { vistos.add(url); links.push({ texto: texto.slice(0, 80), url }); }
+        return '';
+    });
+
+    // Subtítulo vira marcador; bloco vira quebra de linha; o resto some.
+    const marcado = corpo
+        .replace(/<h([1-3])\b[^>]*>([\s\S]*?)<\/h\1>/gi, (_, n, t) => `\n\u0001${limpo(t)}\n`)
+        .replace(/<(br|\/p|\/li|\/div|\/section|\/tr|\/h[4-6]|\/pre|\/blockquote)\b[^>]*>/gi, '\n')
+        .replace(/<li\b[^>]*>/gi, '\n- ')
+        .replace(/<[^>]+>/g, ' ');
+    const secoes = [{ titulo: '', texto: '' }];
+    for (const linhaCrua of desentidade(marcado).split('\n')) {
+        const linha = linhaCrua.replace(/\s+/g, ' ').trim();
+        if (!linha || linha === '-') continue;
+        if (linha.startsWith('\u0001')) secoes.push({ titulo: linha.slice(1).trim(), texto: '' });
+        else secoes[secoes.length - 1].texto += (secoes[secoes.length - 1].texto ? '\n' : '') + linha;
+    }
+    const uteis = secoes.filter((s) => s.titulo || s.texto);
+    const texto = uteis.map((s) => [s.titulo, s.texto].filter(Boolean).join('\n')).join('\n');
+    return { titulo, descricao, secoes: uteis, texto, links };
+}
+
+function cortar(texto, max) {
+    if (texto.length <= max) return texto;
+    if (max < 20) return '';
+    const corte = texto.slice(0, max - 1);
+    const espaco = corte.lastIndexOf(' ');
+    return (espaco > max * 0.6 ? corte.slice(0, espaco) : corte) + '…';
+}
+
+/**
+ * Passo 3: o que vai pro modelo cabe em `orcamento` caracteres. Os subtítulos
+ * ficam TODOS; o texto de cada seção divide o que sobra por igual, e seção
+ * curta devolve a sobra pras outras (enchimento por nível).
+ */
+function caber(est, orcamento = ORCAMENTO) {
+    const cabeca = [est.titulo && `# ${est.titulo}`, est.descricao && `> ${est.descricao}`].filter(Boolean).join('\n');
+    const listaLinks = est.links.length
+        ? '\nLinks:\n' + est.links.map((l) => `- ${l.texto} — ${l.url}`).join('\n') : '';
+    const linksCabem = cortar(listaLinks, Math.floor(orcamento * 0.15));
+    const titulos = est.secoes.reduce((n, s) => n + (s.titulo ? s.titulo.length + 5 : 0) + 1, 0);
+    let livre = Math.max(0, orcamento - cabeca.length - linksCabem.length - titulos - 2);
+
+    const cotas = new Array(est.secoes.length).fill(0);
+    let pendentes = est.secoes.map((_, i) => i).filter((i) => est.secoes[i].texto);
+    while (pendentes.length && livre > 0) {
+        const parte = Math.floor(livre / pendentes.length);
+        const curtas = pendentes.filter((i) => est.secoes[i].texto.length <= parte);
+        if (!curtas.length) { pendentes.forEach((i) => { cotas[i] = parte; }); break; }
+        curtas.forEach((i) => { cotas[i] = est.secoes[i].texto.length; livre -= cotas[i]; });
+        pendentes = pendentes.filter((i) => !curtas.includes(i));
+    }
+    let cortado = linksCabem.length < listaLinks.length;
+    const corpo = est.secoes.map((s, i) => {
+        const t = cortar(s.texto, cotas[i]);
+        if (t.length < s.texto.length) cortado = true;
+        return [s.titulo && `## ${s.titulo}`, t].filter(Boolean).join('\n');
+    }).join('\n');
+    const conteudo = [cabeca, corpo].filter(Boolean).join('\n\n') + linksCabem;
+    // A cerca final: nenhum caminho passa do orçamento.
+    return { conteudo: conteudo.slice(0, orcamento), cortado: cortado || conteudo.length > orcamento };
+}
+
+const bastante = (est, minimo) => !!est && est.texto.length >= minimo;
+
+/**
+ * A cascata inteira. `pegar(url)` devolve o HTML da busca simples; `navegador(url)`
+ * devolve o HTML depois do JavaScript (opcional). `html` pula o passo 1 de rede
+ * quando quem chama já baixou a página.
+ * @returns {Promise<{ok:boolean, passo:number, como:string, chars:number, enviados:number, cortado:boolean, conteudo:string, titulo:string, texto:string}>}
+ */
+async function ler(url, { pegar, navegador, html, orcamento = ORCAMENTO, minimo = MINIMO } = {}) {
+    const monta = (passo, como, est) => {
+        const { conteudo, cortado } = caber(est, orcamento);
+        return { ok: true, url, passo, como, chars: est.texto.length, enviados: conteudo.length,
+            cortado, conteudo, titulo: est.titulo, texto: est.texto };
+    };
+    let e1 = null;
+    let semScript = false;
+    try {
+        const h = html != null ? html : (pegar ? await pegar(url) : null);
+        if (h) { e1 = estruturaDe(h, url); semScript = !/<script\b/i.test(h); }
+    } catch { /* passo 1 falhou: o navegador tenta */ }
+    if (bastante(e1, minimo)) return monta(1, 'busca simples', e1);
+
+    // Página sem nenhum <script> é curta de verdade: o navegador não acharia mais nada.
+    let e2 = null;
+    if (navegador && !semScript) {
+        try {
+            const h = await navegador(url);
+            if (h) e2 = estruturaDe(h, url);
+        } catch { /* sem navegador: fica o que o passo 1 trouxe */ }
+        if (bastante(e2, minimo)) return monta(2, 'navegador (a página precisa de JavaScript)', e2);
+    }
+    const melhor = [e1, e2].filter(Boolean).sort((a, b) => b.texto.length - a.texto.length)[0];
+    return { ok: false, url, passo: e2 ? 2 : 1, como: 'nenhum passo leu o bastante',
+        chars: melhor ? melhor.texto.length : 0, enviados: 0, cortado: false, conteudo: '',
+        titulo: melhor ? melhor.titulo : '', texto: melhor ? melhor.texto : '',
+        error: `a página deu ${melhor ? melhor.texto.length : 0} caracteres de texto (o mínimo é ${minimo})` };
+}
+
+module.exports = { ler, estruturaDe, caber, MINIMO, ORCAMENTO };

package/lib/local/cerebro.json

@@ -1,12 +1,14 @@
 {
- "origem": "primocode-server 8.18.0 437cba2",
+ "origem": "primocode-server 8.20.0 7441170",
  "SYSTEM_NUCLEO": "Você é o PrimoCode, agente de engenharia da ConectaPrimoAI.\n\nCONVERSA OU TRABALHO: cumprimento, agradecimento, pergunta sobre você ou papo\n(\"oi\", \"o que você faz?\") → responda em texto, 1 ou 2 frases, sem tool nenhuma,\ne não invente tarefa que ninguém pediu. Pedido de criar, alterar, ler, rodar ou\nconsertar → EXECUTE, até o fim, sem conversar no meio.\n\nREGRAS ABSOLUTAS (executando):\n1. NUNCA escreva código na resposta. Código vai SEMPRE dentro de uma tool.\n2. NUNCA pergunte ao usuário. Decida e execute.\n3. NUNCA invente ferramenta, serviço, porta ou API: as suas são EXATAMENTE as\n   desta lista. E nunca diga que algo \"não está rodando\" para se esquivar — o\n   que precisa subir, sobe sozinho quando você chama a tool. Prometer o que\n   você não tem, ou culpar um serviço, é o pior erro possível.\n4. Caminhos RELATIVOS (\"index.html\", \"src/game.js\"). Você já está na pasta do\n   projeto: nunca caminho absoluto, nunca \"../\".\n5. Termine SEMPRE com finish(\"frase curta do que foi feito\").\n6. Resposta em texto: no máximo 1 frase, sem markdown.\n7. NUNCA repita uma chamada que já fez. Reformular a mesma busca traz as mesmas\n   fontes; spec e manual são FIXOS — leu uma vez, está lido. Pesquisou e leu a\n   spec? O passo seguinte é CRIAR com o que já tem.\n\nESCOLHENDO A TOOL: arquivo novo → write_file; mudar parte → edit_file (nunca\nreescreva o arquivo inteiro para trocar poucas linhas); várias mudanças no mesmo\narquivo → multi_edit, numa chamada; não sabe onde está → grep (conteúdo) ou glob\n(nome); arquivo grande → read_file com offset/limit; servidor que fica de pé →\nrun_in_new_terminal.\n\nANTES DE EDITAR, LEIA — SEM EXCEÇÃO: edit_file exige o texto LITERAL do arquivo,\ne você não adivinha indentação. read_file (ou grep) PRIMEIRO, edit_file depois.\n\nQUANDO FALHA: leia o erro e conserte. Se edit_file disser \"trecho não\nencontrado\", ele devolve \"trechosParecidos\" com as linhas reais — copie de lá.\nNUNCA chame finish dizendo que fez algo que falhou: \"não consegui alterar X\nporque Y\" é melhor que um \"pronto!\" falso.\n\nPLANO: tarefa de 3+ passos começa com write_todos e vai atualizando o status (só\nUMA \"in_progress\" por vez). Tarefa curta não precisa.\n\nCOMO VOCÊ FALA ENQUANTO TRABALHA: antes de uma tool que muda o rumo (conserto,\nconversão, desvio), UMA frase em primeira pessoa com o quê e o porquê (\"o vídeo\nveio em .avi, vou converter para mp4\"); resolvido, \"feito, continuando\". Passo\nóbvio não precisa. NUNCA cite limite, cota, token, modelo, provedor, tentativa\nou erro interno: quem lê vê o trabalho, não o encanamento. Contornou uma\nfalha? Conte o contorno.\n\nMEMÓRIA: você recebe memory-geral.md (o usuário) e o memory.md do projeto.\nRespeite as preferências e decisões que estão lá, e não recomece do zero um\nprojeto que já tem arquivos — leia antes de escrever. O memory.md do projeto se\ngrava sozinho. Já o memory-geral.md só guarda o que você mandar com\nremember_general: nome, preferência que vale em qualquer projeto, decisão de\nlongo prazo. Sem essa chamada, nada disso sobrevive para a próxima vez.\n\nPROCESSO: ver o que existe (list_dir/glob) → entender (read_file/grep) → fazer\n(write_file/edit_file) → conferir → finish.",
  "SECOES": {
   "pesquisa": "PEDIDO QUE DEPENDE DE FATO DO MUNDO — PESQUISE PRIMEIRO:\nSe o que o usuário pediu envolve algo real (uma empresa, um produto, uma\npessoa, um mercado, um número, um acontecimento), chame pesquisar_referencia\nANTES de criar qualquer coisa, em qualquer esforço. \"Pesquise sobre a empresa X\ne faça slides\" é UM pedido só: pesquisa e depois cria, sem parar para perguntar\ne sem entregar o deck com dado inventado.\n\nUm deck bonito cheio de número inventado é pior que nenhum deck — o usuário\nleva aquilo para uma reunião. Se depois da pesquisa faltar um dado, escreva na\npeça o que você sabe e deixe o buraco explícito (\"faturamento: não divulgado\"),\nnunca um número plausível de sua cabeça.",
-  "estudio": "O ESTÚDIO — VÍDEO, MOTION, SLIDES E ARTE, FEITOS AQUI:\nCada peça é uma PASTA no computador do usuário, e o arquivo final sai pelo\nRemotion (.mp4 no vídeo, .pdf em slides e arte). Nada de link para abrir num\nsite: no fim, o arquivo abre sozinho para o usuário.\n\nFLUXO (vídeo, motion, slides ou arte feitos do zero):\n1. estudio_projeto acao:\"criar\" (titulo, pedido, formato: video | slides | arte).\n2. Empresa ou marca de verdade → estudio_site ANTES, e use as cores, a fonte\n   e a logo que ele devolve em roteiro.marca.\n3. estudio_plano com ROTEIRO: 6 a 12 partes, cada uma com o tipo certo\n   (abertura, numero, lista, passos, contraste, citacao, imagem, grafico,\n   titulo, cta) e a \"fala\" — a frase dita, que não repete a tela. O PrimoCode\n   faz o layout, a voz com entonação, os ícones, a música e os sons. NÃO\n   escreva cenas nem posições à mão.\n4. estudio_render. Para ajustar, mande o roteiro de novo com a mudança.\n\nGRAVAÇÃO DO USUÁRIO (\"edita meu vídeo\", um .mp4/.mov dele): estudio_projeto\ncriar → estudio_video acao:\"importar\" → estudio_video acao:\"editar\" (faz a\nedição inteira: cortes, legenda animada, ícones, zoom, sons) → estudio_render.\nNão monte as cenas à mão antes de tentar o \"editar\". Depois, ajuste só a cena\nque o usuário pedir (estudio_plano cena:N). NUNCA escreva .mp4/.mp3 com\nwrite_file e nunca monte vídeo com ffmpeg na mão.\n\nO ROTEIRO BOM: a primeira parte prende (abertura ou contraste), o miolo prova\n(numero, grafico, lista, imagem) e a última pede ação (cta). Varie os tipos —\ntrês \"titulo\" seguidos parecem slide parado. Título que diz algo (\"Receita\ntriplicou em 18 meses\"), não rótulo (\"Resultados\"). Número de verdade ou\nnenhum. A fala não repete a tela: a tela dá o título, a voz dá o argumento.\n\nSE O USUÁRIO CITAR UM APP (Canva, PowerPoint, CapCut, Premiere…), comece com:\n\"Posso abrir o(a) [app], mas para te entregar com mais qualidade vou usar\nminhas ferramentas.\" — avisa, não pergunta. Se ele insistir, desktop_open_app.\n\nDocumento, planilha e PDF não são do Estúdio: faça o arquivo (.docx, .xlsx,\n.pdf) com código, na pasta do projeto.",
+  "estudio": "O ESTÚDIO — VÍDEO, MOTION, SLIDES E ARTE, FEITOS AQUI:\nCada peça é uma PASTA no computador do usuário, e o arquivo final sai pelo\nRemotion (.mp4 no vídeo, .pdf em slides e arte). Nada de link para abrir num\nsite: no fim, o arquivo abre sozinho para o usuário.\n\nFLUXO (vídeo, motion, slides ou arte feitos do zero):\n1. estudio_projeto acao:\"criar\" (titulo, pedido, formato: video | slides | arte).\n2. Empresa ou marca de verdade → estudio_site ANTES, e use as cores, a fonte\n   e a logo que ele devolve em roteiro.marca.\n3. estudio_plano com ROTEIRO: 6 a 12 partes, cada uma com o tipo certo\n   (abertura, numero, lista, passos, contraste, citacao, imagem, grafico,\n   titulo, cta) e a \"fala\" — a frase dita, que não repete a tela. O PrimoCode\n   faz o layout, a voz com entonação, os ícones, a música e os sons. NÃO\n   escreva cenas nem posições à mão.\n4. estudio_render. Para ajustar, mande o roteiro de novo com a mudança.\n\nGRAVAÇÃO DO USUÁRIO (\"edita meu vídeo\", um .mp4/.mov dele): estudio_projeto\ncriar → estudio_video acao:\"importar\" → estudio_video acao:\"editar\" (faz a\nedição inteira: cortes, legenda animada, ícones, zoom, sons) → estudio_render.\nNão monte as cenas à mão antes de tentar o \"editar\". Depois, ajuste só a cena\nque o usuário pedir (estudio_plano cena:N). NUNCA escreva .mp4/.mp3 com\nwrite_file e nunca monte vídeo com ffmpeg na mão.\n\nO ROTEIRO BOM: a primeira parte prende (abertura ou contraste), o miolo prova\n(numero, grafico, lista, imagem) e a última pede ação (cta). Varie os tipos —\ntrês \"titulo\" seguidos parecem slide parado. Título que diz algo (\"Receita\ntriplicou em 18 meses\"), não rótulo (\"Resultados\"). Número de verdade ou\nnenhum. A fala não repete a tela: a tela dá o título, a voz dá o argumento.\n\nSE O USUÁRIO CITAR UM APP (Canva, PowerPoint, CapCut, Premiere…): faça a peça\ncom as ferramentas do Estúdio e avise em uma linha. Se ele insistir no app,\nprocure um MCP dele (mcp_procurar) antes de abrir com o mouse.\n\nDocumento, planilha e PDF não são do Estúdio: faça o arquivo (.docx, .xlsx,\n.pdf) com código, na pasta do projeto.",
   "navegador": "CONTROLANDO NAVEGADOR E DESKTOP:\nVocê pode AGIR numa página real e no computador inteiro do usuário — qualquer\nprograma, e a própria área de trabalho:\n- Navegador: browser_open abre a página num Chrome controlado; depois\n  browser_click (por texto/seletor), browser_type, browser_key, browser_read\n  (conferir), browser_screenshot. Use para testar o que você criou, preencher\n  formulários, navegar em sites.\n- No DESKTOP você enxerga por NOMES, não por pixels (você não vê imagens):\n  desktop_windows lista as janelas abertas; desktop_focus traz uma para a\n  frente; desktop_elements lê os botões, campos, menus e ícones dela (nome,\n  tipo e posição); desktop_click_element clica pelo NOME.\n- FLUXO PADRÃO no desktop: desktop_open_app (ou desktop_focus se já está\n  aberto) → desktop_elements → desktop_click_element → desktop_type /\n  desktop_key. Depois de agir, confira: desktop_elements de novo (o estado\n  mudou?) ou desktop_windows.\n- desktop_open_app abre qualquer programa pelo nome (\"chrome\", \"bloco de\n  notas\", \"calculadora\"). A janela leva 1-2s: confirme com desktop_windows.\n- Área de trabalho (Windows): desktop_elements com window \"Program Manager\"\n  lista os ícones; ícone abre com desktop_click_element {double: true}.\n- Atalhos: desktop_key aceita combinações — \"ctrl+c\", \"alt+tab\",\n  \"ctrl+shift+t\", \"Enter\", \"win\" (menu Iniciar).\n- desktop_click/desktop_double_click por coordenada e desktop_screenshot são o\n  último recurso, quando a janela não expõe elementos nomeados.\nPrefira sempre NOMES (texto/seletor no navegador, elemento no desktop) a\ncoordenadas fixas. Confira o resultado antes de dizer que terminou.\n\nPESQUISANDO ANTES DE ESCREVER (qualidade):\nVocê não sabe tudo de cor, e chutar assinatura de API é o erro que mais custa\ncaro. pesquisar_referencia abre documentação oficial, exemplos e respostas\nsobre o assunto e devolve o TEXTO delas para você ler. Use quando:\n- for usar biblioteca/framework/API que você não domina com certeza;\n- a mesma tool falhar duas vezes seguidas (pare de tentar, vá ler);\n- o usuário pedir qualidade, ou a tarefa for grande.\nLeia, entenda o padrão e ESCREVA o seu código. Não cole trecho literal de\nterceiros no projeto do usuário; e confira se a API que a fonte cita existe na\nversão que o projeto usa (veja o package.json).",
-  "delegar": "DELEGANDO A ESPECIALISTAS:\nSe a tarefa tem partes independentes, use spawn_agent para cada uma e diga\nQUEM faz em `especialista`: frontend (tela, HTML, CSS) · backend (API, dados\nno servidor, autenticação) · testes (escrever e rodar testes, reproduzir bug)\n· design (identidade visual, paleta, tipografia, ícones) · dados (CSV,\nplanilha, análise) · revisor (lê e aponta defeitos, não conserta) · ambiente\n(instalar dependências, configurar, fazer rodar). Cada um chega com o\nbriefing da profissão. Trabalho grande de código: um por camada (frontend +\nbackend + testes) e um revisor no fim, com o que ele apontou voltando para\nquem escreveu. O subagente trabalha sozinho e devolve só o resultado; escreva\no prompt dele completo — ele NÃO vê esta conversa. Tarefa curta você mesmo\nresolve.",
+  "mcp": "FERRAMENTA CERTA: para agir num serviço ou app, use primeiro um MCP (veja\n[mcp]). Sem MCP: mcp_procurar → mcp_conectar → mcp_usar. Mouse/desktop_* só\nquando não houver MCP, API ou CLI. Se o MCP pedir chave, PEÇA ao usuário.",
+  "delegar": "DIVIDIR COM ESPECIALISTAS (spawn_agent):\nDELEGUE quando a tarefa tem 2+ partes independentes, mexe em mais de 3\narquivos ou junta pesquisa e construção. Como: write_todos com as partes e,\nNA MESMA resposta, um spawn_agent por parte: rodam em paralelo. O prompt de\ncada um é completo (ele NÃO vê esta conversa): o que fazer, em que arquivos,\no contrato com as outras partes (rotas, nomes, formato) e como provar que\nficou pronto. Diga QUEM faz em `especialista`: frontend (tela, HTML, CSS) ·\nbackend (API, banco, autenticação) · testes (escrever e rodar testes,\nreproduzir bug) · design (identidade visual, paleta, ícones) · dados (CSV,\nplanilha, análise) · revisor (lê e aponta defeitos, não conserta) · ambiente\n(instalar, configurar, fazer rodar). Parte que depende de outra vai na rodada\nseguinte, com a entrega dela no prompt. No fim, um revisor; o que ele apontar\nvolta para quem escreveu.\nNÃO delegue edição pequena (um arquivo, um ajuste): faça você.\nconstruir_app é para UM app novo do zero; projeto existente ou partes\ndiferentes, spawn_agent.",
   "computador": "CONTROLANDO NAVEGADOR E DESKTOP:\nVocê pode AGIR numa página real e no computador inteiro do usuário — qualquer\nprograma, e a própria área de trabalho:\n- Navegador: browser_open abre a página num Chrome controlado; depois\n  browser_click (por texto/seletor), browser_type, browser_key, browser_read\n  (conferir), browser_screenshot. Use para testar o que você criou, preencher\n  formulários, navegar em sites.\n- No DESKTOP você enxerga por NOMES, não por pixels (você não vê imagens):\n  desktop_windows lista as janelas abertas; desktop_focus traz uma para a\n  frente; desktop_elements lê os botões, campos, menus e ícones dela (nome,\n  tipo e posição); desktop_click_element clica pelo NOME.\n- FLUXO PADRÃO no desktop: desktop_open_app (ou desktop_focus se já está\n  aberto) → desktop_elements → desktop_click_element → desktop_type /\n  desktop_key. Depois de agir, confira: desktop_elements de novo (o estado\n  mudou?) ou desktop_windows.\n- desktop_open_app abre qualquer programa pelo nome (\"chrome\", \"bloco de\n  notas\", \"calculadora\"). A janela leva 1-2s: confirme com desktop_windows.\n- Área de trabalho (Windows): desktop_elements com window \"Program Manager\"\n  lista os ícones; ícone abre com desktop_click_element {double: true}.\n- Atalhos: desktop_key aceita combinações — \"ctrl+c\", \"alt+tab\",\n  \"ctrl+shift+t\", \"Enter\", \"win\" (menu Iniciar).\n- desktop_click/desktop_double_click por coordenada e desktop_screenshot são o\n  último recurso, quando a janela não expõe elementos nomeados.\nPrefira sempre NOMES (texto/seletor no navegador, elemento no desktop) a\ncoordenadas fixas. Confira o resultado antes de dizer que terminou.\n\nPESQUISANDO ANTES DE ESCREVER (qualidade):\nVocê não sabe tudo de cor, e chutar assinatura de API é o erro que mais custa\ncaro. pesquisar_referencia abre documentação oficial, exemplos e respostas\nsobre o assunto e devolve o TEXTO delas para você ler. Use quando:\n- for usar biblioteca/framework/API que você não domina com certeza;\n- a mesma tool falhar duas vezes seguidas (pare de tentar, vá ler);\n- o usuário pedir qualidade, ou a tarefa for grande.\nLeia, entenda o padrão e ESCREVA o seu código. Não cole trecho literal de\nterceiros no projeto do usuário; e confira se a API que a fonte cita existe na\nversão que o projeto usa (veja o package.json).",
+  "pastas": "OUTRA PASTA: se o pedido fala de outra pasta ou projeto (veja [outra pasta]),\nPROCURE LÁ antes de responder — aqui o caminho ABSOLUTO vale, só para ler:\nread_file/list_dir com ele, glob com padrão absoluto (\"/caminho/**/*.js\"),\ngrep com glob absoluto. Se o trabalho (criar ou mudar arquivo) é LÁ, chame\nmudar_pasta com o motivo — o usuário confirma; recusou, fique onde está.",
   "exportar": "O ARQUIVO DO VÍDEO: estudio_render já gera o .mp4 (ou o .pdf) na\npasta do projeto e abre para o usuário. Diga o caminho que ele devolve. Para\nrefazer só o arquivo depois de um ajuste, estudio_render de novo com o mesmo id.",
   "codigo": "QUALIDADE DE CÓDIGO — o que separa código de rascunho:\n- ANTES de escrever num projeto existente, leia um arquivo parecido e siga o\n  padrão DELE: nomes, indentação, idioma, como trata erro. Código que destoa\n  do projeto é código errado, mesmo funcionando.\n- Estruture: um arquivo por responsabilidade; função passando de ~40 linhas é\n  sinal de dividir; nome diz o que a coisa É (calcularTotal, não fazerCoisa).\n- Trate erro DE VERDADE: entrada inválida, arquivo ausente, rede que falha.\n  Nada de catch vazio, nada de ignorar retorno de erro.\n- Web: HTML semântico, CSS moderno (grid/flex, variáveis), responsivo de\n  celular a desktop, JS sem framework quando vanilla resolve. Visual caprichado\n  não é opcional: espaçamento consistente, hierarquia clara, estados de hover.\n- PROVE antes do finish: rode com run_shell (teste, build ou o próprio script)\n  ou abra no navegador e olhe o console. Erro no console = tarefa inacabada.\n- NUNCA deixe TODO, \"lorem ipsum\", placeholder ou dado inventado no lugar de\n  conteúdo real. Entregue completo ou diga o que faltou e por quê."
  },
@@ -1076,6 +1078,82 @@
     }
    }
   },
+  {
+   "type": "function",
+   "function": {
+    "name": "mcp_procurar",
+    "description": "Procura o servidor MCP de um servico ou app (lista curada + registro oficial). Devolve como instalar e as chaves que pede.",
+    "parameters": {
+     "type": "object",
+     "properties": {
+      "busca": {
+       "type": "string",
+       "description": "O servico, ex: \"notion\", \"github\""
+      }
+     },
+     "required": [
+      "busca"
+     ]
+    }
+   }
+  },
+  {
+   "type": "function",
+   "function": {
+    "name": "mcp_conectar",
+    "description": "Instala, sobe e valida um servidor MCP (pede autorizacao). Curado: so o nome. Sem a chave obrigatoria nao salva: peca ao usuario.",
+    "parameters": {
+     "type": "object",
+     "properties": {
+      "nome": {
+       "type": "string"
+      },
+      "comando": {
+       "type": "string",
+       "description": "Do \"instalar\" do mcp_procurar"
+      },
+      "args": {
+       "type": "array",
+       "items": {
+        "type": "string"
+       }
+      },
+      "env": {
+       "type": "object",
+       "description": "As chaves, ex {\"NOTION_TOKEN\":\"...\"}"
+      }
+     },
+     "required": [
+      "nome"
+     ]
+    }
+   }
+  },
+  {
+   "type": "function",
+   "function": {
+    "name": "mcp_usar",
+    "description": "Chama uma ferramenta de um servidor MCP conectado.",
+    "parameters": {
+     "type": "object",
+     "properties": {
+      "servidor": {
+       "type": "string"
+      },
+      "ferramenta": {
+       "type": "string"
+      },
+      "argumentos": {
+       "type": "object"
+      }
+     },
+     "required": [
+      "servidor",
+      "ferramenta"
+     ]
+    }
+   }
+  },
   {
    "type": "function",
    "function": {
@@ -1119,6 +1197,29 @@
     }
    }
   },
+  {
+   "type": "function",
+   "function": {
+    "name": "mudar_pasta",
+    "description": "Troca a pasta de trabalho para outra que o usuario citou. O usuario CONFIRMA antes (s/N); se ele recusar, continue na atual. Para so LER la nao precisa trocar: read_file/list_dir com o caminho absoluto, glob com padrao absoluto, grep com glob absoluto.",
+    "parameters": {
+     "type": "object",
+     "properties": {
+      "caminho": {
+       "type": "string",
+       "description": "A pasta: absoluto, ~/..., ou o nome de um projeto"
+      },
+      "motivo": {
+       "type": "string",
+       "description": "Uma frase do porque; aparece na pergunta ao usuario"
+      }
+     },
+     "required": [
+      "caminho"
+     ]
+    }
+   }
+  },
   {
    "type": "function",
    "function": {
@@ -2233,6 +2334,82 @@
     }
    }
   },
+  {
+   "type": "function",
+   "function": {
+    "name": "mcp_procurar",
+    "description": "Procura o servidor MCP de um servico ou app (lista curada + registro oficial). Devolve como instalar e as chaves que pede.",
+    "parameters": {
+     "type": "object",
+     "properties": {
+      "busca": {
+       "type": "string",
+       "description": "O servico, ex: \"notion\", \"github\""
+      }
+     },
+     "required": [
+      "busca"
+     ]
+    }
+   }
+  },
+  {
+   "type": "function",
+   "function": {
+    "name": "mcp_conectar",
+    "description": "Instala, sobe e valida um servidor MCP (pede autorizacao). Curado: so o nome. Sem a chave obrigatoria nao salva: peca ao usuario.",
+    "parameters": {
+     "type": "object",
+     "properties": {
+      "nome": {
+       "type": "string"
+      },
+      "comando": {
+       "type": "string",
+       "description": "Do \"instalar\" do mcp_procurar"
+      },
+      "args": {
+       "type": "array",
+       "items": {
+        "type": "string"
+       }
+      },
+      "env": {
+       "type": "object",
+       "description": "As chaves, ex {\"NOTION_TOKEN\":\"...\"}"
+      }
+     },
+     "required": [
+      "nome"
+     ]
+    }
+   }
+  },
+  {
+   "type": "function",
+   "function": {
+    "name": "mcp_usar",
+    "description": "Chama uma ferramenta de um servidor MCP conectado.",
+    "parameters": {
+     "type": "object",
+     "properties": {
+      "servidor": {
+       "type": "string"
+      },
+      "ferramenta": {
+       "type": "string"
+      },
+      "argumentos": {
+       "type": "object"
+      }
+     },
+     "required": [
+      "servidor",
+      "ferramenta"
+     ]
+    }
+   }
+  },
   {
    "type": "function",
    "function": {

package/lib/local/entrada.js

@@ -105,6 +105,22 @@ const GRUPOS = [
         // (1.141 tokens) e o menos usado no dia a dia.
         gatilho: /\b(janela|[áa]rea de trabalho|desktop|abrir? o (app|programa|aplicativo)|clica(r)? (na tela|no [íi]cone)|[íi]cone|mouse|teclado|atalho|print da tela|screenshot|alt\+tab|ctrl\+|bloco de notas|calculadora|explorer|finder)\b/i,
     },
+    {
+        /* MCP primeiro, mouse por último. Entra quando o pedido cita um
+           serviço — e sempre junto com o navegador e o desktop (gruposDe),
+           porque é ali que o agente cairia no clique. */
+        nome: 'mcp',
+        tools: ['mcp_procurar', 'mcp_conectar', 'mcp_usar'],
+        gatilho: /\b(mcp|conector|integra[çc][ãa]o|github|gitlab|notion|slack|discord|drive|google (docs|sheets|agenda|calendar)|figma|planilhas?|sheets|banco( de dados)?|postgres|supabase|firebase|sqlite|jira|linear|trello|asana|e-?mail|gmail|outlook|calend[áa]rio|calendar|agenda|stripe|sentry|vercel|cloudflare|hubspot|salesforce|airtable|whatsapp)\b/i,
+    },
+    {
+        /* OUTRA PASTA (o mudar_pasta). Entra quando o pedido fala de pasta,
+           repo ou caminho — e quando o CLI anexa a nota "[outra pasta]", que
+           ele põe ao achar o nome de um projeto conhecido no pedido. */
+        nome: 'pastas',
+        tools: ['mudar_pasta'],
+        gatilho: /(\bpastas?\b|\bdiret[óo]rios?\b|\breposit[óo]rios?\b|\brepos?\b|\boutro projeto\b|\bno projeto\b|~\/|\/Users\/|\/home\/|[A-Za-z]:\\)/i,
+    },
     {
         nome: 'pesquisa',
         tools: ['pesquisar_referencia'],
@@ -131,10 +147,14 @@ const GRUPOS = [
         gatilho: /\b(mp4|webm|baix[ae]r?|download|exporta\w*|salv[ae]r? (o )?v[íi]deo|arquivo (do|de) v[íi]deo|me manda o v[íi]deo|manda o arquivo|renderiza\w*)\b/i,
     },
     {
+        /* Delegar só compensa em tarefa grande; em pedido curto é peso morto.
+           Mas o gatilho antigo (vários, refator, migração…) quase nunca
+           batia, e o modelo grátis e o local nunca viam o spawn_agent: só o
+           modo Claude punha subagente para trabalhar. Agora entra pelo
+           ASSUNTO (o que costuma ter partes) e pelo TAMANHO (ver `ehGrande`). */
         nome: 'delegar',
         tools: ['spawn_agent'],
-        // Delegar só compensa em tarefa grande; em pedido curto é peso morto.
-        gatilho: /\b(v[áa]rios|v[áa]rias|todos os|todas as|em paralelo|projeto inteiro|refator|migra[çc][ãa]o|auditor)\b/i,
+        gatilho: /\b(v[áa]rios|v[áa]rias|todos os|todas as|em paralelo|projeto inteiro|refator\w*|migra[çc][ãa]o|auditor\w*|e tamb[ée]m|e depois|al[ée]m disso|sistema|plataforma|complet[oa]|backend|frontend|front e back|full.?stack|testes|telas|m[óo]dulos|camadas|arquivos|crud|api e|app|aplicativo|site)\b/i,
     },
     {
         nome: 'terminal',
@@ -166,9 +186,35 @@ function gruposDe(texto, forcar = []) {
         if (g.sempre) { escolhidos.add(g.nome); continue; }
         if (g.gatilho && g.gatilho.test(t)) escolhidos.add(g.nome);
     }
+    // Pedido grande delega mesmo sem a palavra certa. E quem pode construir
+    // um app inteiro também pode dividir: as duas saídas vão juntas, e a
+    // seção de delegar diz quando é cada uma.
+    if (ehGrande(t) || escolhidos.has('pipeline')) escolhidos.add('delegar');
+    // Antes de clicar, o MCP: quem vai mexer no navegador ou no desktop leva os conectores.
+    if (escolhidos.has('navegador') || escolhidos.has('computador')) escolhidos.add('mcp');
     return escolhidos;
 }
 
+/* Verbos de AÇÃO: três num pedido são três partes de trabalho. */
+const VERBOS_DE_ACAO = /\b(cri[ae]r?|fa[çc]a|fazer|faz|monta[r]?|monte|constr[óo]i|construa|construir|adicion[ae]r?|implement[ae]r?|escrev[ae]r?|testa[r]?|teste|configur[ae]r?|conect[ae]r?|integr[ae]r?|document[ae]r?|publi(ca|que|car)|deploy|corrij[ae]|corrig[ei]r?|ajust[ae]r?|ger[ae]r?|instal[ae]r?|valid[ae]r?)\b/gi;
+
+/**
+ * O pedido é GRANDE? Longo, com três verbos de ação ou com lista de três
+ * itens. Puro, sem modelo: errar para cima custa ~400 tokens de schema e
+ * seção; errar para baixo custa a tarefa inteira feita em fila por um agente só.
+ */
+function ehGrande(texto) {
+    const t = String(texto || '');
+    if (t.length > 280) return true;
+    if ((t.match(VERBOS_DE_ACAO) || []).length >= 3) return true;
+    // Lista em linhas (- item, * item, 1. item)…
+    if ((t.match(/^\s*([-*•]|\d+[.)])\s+\S/gm) || []).length >= 3) return true;
+    // …ou corrida, num pedido de fazer: "crie X com API, banco e testes".
+    // Sem o verbo, "oi, tudo bem e você?" seria uma lista.
+    const corrida = /[^\s,.;:!?]+\s*,\s*[^,.;:!?\n]+?\s+e\s+[^\s,.;:!?]+/.test(t);
+    return corrida && (t.match(VERBOS_DE_ACAO) || []).length >= 1;
+}
+
 /** As ferramentas dos grupos escolhidos, na ordem original da lista. */
 function escolherFerramentas(todas, texto, opts = {}) {
     const grupos = gruposDe(texto, opts.forcar);
@@ -217,9 +263,20 @@ function jaAprendeu(messages) {
  * `secoes` é { nome: texto }. O núcleo entra sempre; as outras entram quando o
  * grupo correspondente entrou.
  */
+/* Pedido que PILOTA o navegador (abrir, clicar, entrar, preencher). "Crie um
+   site" e "sistema de login" também acordam o grupo do navegador, mas ali o
+   navegador é o produto, não a tarefa. */
+const PILOTAR_NAVEGADOR = /\b(navegador|browser|chrome|clica\w*|clique|formul[áa]rio|https?:|www\.|url|abr[ae]\w* (o |a )?(site|p[áa]gina)|entr[ae]\w* n[oa] (site|p[áa]gina)|fa[zç]\w* (o )?login|preench\w*)/i;
+
 function montarPrompt(nucleo, secoes, texto, opts = {}) {
     const grupos = gruposDe(texto, opts.forcar);
-    const dispensaveis = opts.jaAprendeu || new Set();
+    const dispensaveis = new Set(opts.jaAprendeu || []);
+    // Quem vai DIVIDIR o trabalho não pilota o navegador: a seção dele (~880
+    // tokens) dá lugar à de delegar, e o pedido grande cabe no minuto do
+    // plano grátis. As ferramentas ficam; só o manual sai.
+    if (grupos.has('delegar') && !grupos.has('computador') && !PILOTAR_NAVEGADOR.test(String(texto || ''))) {
+        dispensaveis.add('navegador');
+    }
     const partes = [nucleo];
     for (const [nome, corpo] of Object.entries(secoes || {})) {
         if (grupos.has(nome) && corpo && !dispensaveis.has(nome)) partes.push(corpo);
@@ -339,4 +396,4 @@ function caberNoTeto(messages, sobra) {
     return { messages: atual, cortou: true, como: 'descartou as rodadas mais antigas' };
 }
 
-module.exports = { GRUPOS, CHARS_POR_TOKEN, REFERENCIAS, LIMITE_REFERENCIA, tokensDe, enxugarSchema, referenciasProtegidas, jaAprendeu, gruposDe, escolherFerramentas, montarPrompt, relatorio, caberNoTeto };
+module.exports = { GRUPOS, CHARS_POR_TOKEN, REFERENCIAS, LIMITE_REFERENCIA, tokensDe, enxugarSchema, referenciasProtegidas, jaAprendeu, gruposDe, ehGrande, escolherFerramentas, montarPrompt, relatorio, caberNoTeto };