primocode 10.14.0 → 10.15.0

package/LICENSES/robo.txt

@@ -0,0 +1,19 @@
+Robô 3D da tela do Primo (voz/primo_voz/vendor/RobotExpressive.glb)
+
+Modelo: RobotExpressive, de Tomás Laulhé (https://www.patreon.com/quaternius). CC0 1.0 (domínio público).
+Modificações de Don McCurdy: três morph targets de expressão, conversão com FBX2GLTF, materiais deduplicados.
+Fonte: https://github.com/mrdoob/three.js/tree/r170/examples/models/gltf/RobotExpressive (README conferido na tag r170).
+Aqui as cores dos materiais são trocadas em tempo de execução (branco/grafite + ciano); o arquivo .glb é o original.
+
+three.js r170 + GLTFLoader (voz/primo_voz/vendor/three-robo.min.js, bundle mínimo gerado com esbuild)
+Licença MIT, Copyright 2010-2024 three.js authors. Texto completo: voz/primo_voz/vendor/three.LICENSE.txt
+
+--- Robô do Spline (voz.json: "robo": "spline", o padrão; "expressive" volta ao RobotExpressive acima) ---
+
+Cena: "AI Robotics Landing Page" (template da comunidade v0/Spline)
+  https://v0.app/templates/ai-robotics-landing-page-iArz1CoDHnf
+  https://prod.spline.design/kZDDjO5HuC9GJUM2/scene.splinecode  (baixada em tempo de execução, precisa de internet; não vai no repo)
+Licença da cena: [VERIFICAR] — confirmar com o autor/Spline antes de uso comercial. Uso atual: pedido do Joel, uso interno.
+Runtime: @splinetool/runtime 1.12.95 (voz/primo_voz/vendor/spline-runtime.min.js, bundle IIFE gerado com esbuild; local, sem CDN).
+  O pacote npm não declara campo "license" [VERIFICAR] — o Joel informou MIT; conferir no repositório splinetool antes de redistribuir.
+Sem internet ou cena lenta (> 6 s): cai no RobotExpressive (CC0).

package/README.md

@@ -1,4 +1,4 @@
-# PrimoCode v10.14.0
+# PrimoCode v10.15.0
 
 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 v10.14.0
+ ▐▛███▜▌   Primo Code v10.15.0
 ▝▜█████▛▘  Bem-vindo de volta, Joel
   ▘▘ ▝▝    ~/primocode  · /dir <pasta> muda
 ```
@@ -17,6 +17,10 @@ está no limite de pedidos, o próximo atende. Você não vê o erro, e não pag
 Personalize o mascote (`primo`, `fox`, `cat`) e o nome com que ele te chama —
 veja `/mascot` e `/name`.
 
+## Primo (voz)
+
+`/voice` abre a tela do Primo: agenda, clima, música, máquina e um robô 3D no centro. Diga **"Primo"** para chamar; ele fala frase a frase e você pode interromper. Na primeira vez cria `~/.primocode/voz-venv` sozinho (`primocode doutor` mostra o estado). Robô offline: `"robo":"expressive"` em `~/.primocode/voz.json`.
+
 ## Novidades da 10.14
 
 - **Vídeo de motion de ponta a ponta** (EffectCraft, 68 receitas, voz, trilha, prévia e editor por comando). Detalhes no `CHANGELOG.md`.

package/bin/primocode.js

@@ -212,7 +212,9 @@ const SLASH_COMANDOS = [
     ['/chats', 'suas conversas salvas, as mesmas do app e do celular'],
     ['/logout', 'desconecta este computador da conta'],
     ['!comando', 'roda direto no shell, sem passar pelo agente (o campo fica âmbar)'],
-    ['/voice', 'liga o microfone: você fala, ele faz, e a resposta sai em voz alta'],
+    ['/voice', 'liga o Primo: diga "Primo, ..."; ele faz e responde em voz alta, com a tela dele (robô, agenda, clima, música)'],
+    ['/voice painel', 'só o painel do Primo (ESC esconde)'],
+    ['/voice nome <Nome>', 'dá outro nome ao assistente (vira a palavra de ativação)'],
     ['/voice parar', 'desliga o modo voz e fecha o microfone'],
     ['/skills', 'o que ele sabe fazer bem — ligue e desligue'],
     ['/marketplace', 'a tela das skills: navegue, ligue, crie'],
@@ -1619,6 +1621,7 @@ let chatEmVoo = null;
 /* O ouvinte de voz em segundo plano.
    Um por sessão: dois processos disputando o mesmo microfone dão um vazio
    intermitente que parece defeito de hardware e não é. */
+let vozPainel = null;      // /voice painel: só o HUD
 let vozEmEspera = null;   // a sessão do /voice: { processo, falar, calar }
 /* Por onde a fala entra no terminal. Nasce no main(), junto da fila — é lá
    que moram o `busy`, a fila e o `ask` pendente. */
@@ -2474,8 +2477,26 @@ async function handleSlash(text) {
 
                Desligar é o primeiro caso de propósito: quem quer fechar o
                microfone quer AGORA, sem esbarrar em checagem de dependência. */
-            if (/^(parar|stop|off|sair)$/i.test((rest || '').trim())) {
-                if (!vozEmEspera) { console.log(c.muted('  O modo voz não está ligado.')); break; }
+            const argVoz = (rest || '').trim();
+            // Só o painel (HUD em tela cheia no Mac; quadro no terminal fora dele).
+            if (/^painel$/i.test(argVoz)) {
+                const py = vozModo.python();
+                if (!py) { console.log(c.err('  O painel precisa do Python 3.')); break; }
+                if (vozPainel) { try { vozPainel.processo.kill(); } catch {} vozPainel = null; }
+                vozPainel = vozModo.abrirPainel({ python: py });
+                console.log(c.muted(vozPainel.tela ? '  Tela do Primo aberta — ESC esconde.' : '  Sem o painel gráfico aqui: rode `primocode voz painel` num terminal separado.'));
+                break;
+            }
+            // /voice nome <Nome>: a pessoa dá o nome ao assistente (e a palavra de ativação passa a ser ele).
+            const mNome = argVoz.match(/^nome\s+(.{2,20})$/i);
+            if (mNome) {
+                const salvo = vozModo.definirNome(mNome[1]);
+                console.log(salvo ? c.ok(`  Fechado: o assistente agora se chama ${salvo}. Vale na próxima vez que ligar o /voice.`) : c.err('  Nome inválido (1 ou 2 palavras, até 20 letras).'));
+                break;
+            }
+            if (/^(parar|stop|off|sair)$/i.test(argVoz)) {
+                if (vozPainel) { try { vozPainel.processo.kill(); } catch {} vozPainel = null; }
+                if (!vozEmEspera) { console.log(c.muted(vozPainel === null ? '  Modo voz e painel fechados.' : '  O modo voz não está ligado.')); break; }
                 try { vozEmEspera.processo.kill(); } catch {}
                 vozEmEspera = null;
                 console.log(c.muted('  Modo voz desligado. O microfone fechou.'));
@@ -2508,10 +2529,12 @@ async function handleSlash(text) {
                     console.log('  ' + c.bold(c.brand('🎙 Modo voz ligado')) + c.muted(' — é só falar. A resposta sai em voz alta.'));
                     console.log('  ' + c.dim('Falar por cima corta a voz · digitar continua valendo · /voice parar desliga'));
                 },
+                aoParar: () => { try { require('../lib/act.js').interromper(); } catch { /* nada rodando */ } },
                 aoOuvir: (texto) => { if (entradaDeVoz) entradaDeVoz(texto); },
                 mostrar: (texto) => console.log('  ' + c.dim(texto)),
             });
             vozEmEspera = sessao;
+            require('../lib/voz-ponte').escutar((nome, args) => sessao.ferramenta(nome, args));
             sessao.pronto.then((r) => {
                 if (vozEmEspera === sessao) vozEmEspera = null;
                 if (r && !r.ok) console.log(c.err(`  o modo voz fechou: ${r.error}`));
@@ -2883,6 +2906,25 @@ async function main() {
         process.exit(require('../lib/skills.js').main(process.argv.slice(3)));
     }
     // `primocode planos`: a tabela comparativa, sem abrir a sessão.
+    // `primocode voz nome <Nome>` / `primocode voz painel`: o Primo sem abrir a sessão.
+    if (process.argv[2] === 'voz') {
+        const vz = require('../lib/voz.js');
+        const [sub, ...resto] = process.argv.slice(3);
+        if (sub === 'nome') {
+            const n = vz.definirNome(resto.join(' '));
+            console.log(n ? `Fechado: o assistente agora se chama ${n}.` : 'Uso: primocode voz nome <Nome>  (1 ou 2 palavras)');
+            process.exit(n ? 0 : 1);
+        }
+        if (sub === 'painel') {
+            const py = vz.python();
+            if (!py) { console.log('O painel precisa do Python 3.'); process.exit(1); }
+            const r = vz.abrirPainel({ python: py });
+            r.processo.on('close', () => process.exit(0));
+            return;
+        }
+        console.log('Uso: primocode voz nome <Nome> | primocode voz painel (o resto é /voice dentro da sessão)');
+        process.exit(0);
+    }
     if (['doutor', 'doctor', 'preparar'].includes(process.argv[2])) {
         process.exit(await require('../lib/preparar.js').main(process.argv.slice(2)));
     }
@@ -3129,6 +3171,7 @@ async function main() {
                 }
             } catch (e) {
                 fala.problema(e);
+                if (vozEmEspera && vozEmEspera.estado) vozEmEspera.estado('erro');
             }
             // Pedido falado (ou tarefa que recebeu recado falado): a resposta
             // final sai em voz alta, resumida. O detalhe fica na tela.

package/lib/act.js

@@ -13,6 +13,8 @@
 const { c, Spinner, PENSANDO } = require('./ui');
 const fala = require('./fala');
 const especialistas = require('./especialistas');
+const limites = require('./limites');
+let avisouParalelo = false;
 const tools = require('./tools');
 const api = require('./api');
 const cfg = require('./config');
@@ -844,6 +846,7 @@ async function runAct(userPrompt, opts) {
     let paradoPorTravar = null;
     /* Anota ANTES de agir (lib/auditoria.js): recusado também fica no livro. */
     const anotar = (tc, decisao, motivo) => {
+        if (decisao !== 'recusada' && decisao !== 'negada') require('./voz-ponte').ferramenta(tc.name, tc.arguments);
         const id = auditoria.antes({ agente: rotulo, ferramenta: tc.name, args: tc.arguments, decisao, motivo });
         const falhou = auditoria.problema();
         if (falhou) console.log(c.warn(`⚠ ${falhou}`));
@@ -1322,8 +1325,12 @@ async function runAct(userPrompt, opts) {
         const spawns = toolCalls.filter((tc) => tc.name === 'spawn_agent');
         const resultadosSpawn = new Map();
         if (spawns.length && !PARAR) garantirPasta();
-        if (spawns.length > 1 && !PARAR) {
-            const juntos = spawns.slice(0, 8);
+        /* O plano decide quantos subagentes rodam JUNTOS (lib/limites.js; grátis e
+           Primo: um de cada vez, o resto continua em fila). Nunca recusa: só diz o porquê. */
+        const par = spawns.length > 1 ? await limites.paralelo() : null;
+        if (par) { const av = par.aviso(spawns.length); if (av && !avisouParalelo) { avisouParalelo = true; console.log(`  ${av}`); } }
+        if (spawns.length > 1 && par.max > 1 && !PARAR) {
+            const juntos = spawns.slice(0, par.max);
             fala.paralelo(juntos.length, profundidade);
             const ids = juntos.map((tc) => anotar(tc, 'permitida'));
             const rs = await Promise.all(juntos.map((tc) =>

package/lib/estudio/cota.js

@@ -19,7 +19,7 @@ const zlib = require('zlib');
 const { spawnSync } = require('child_process');
 
 const LOCAL = { ok: true, offline: true, liberado: true, plano: 'local', restam: null, usados: 0,
-    recursos: { videosMes: 0, resolucao: 2160, marcaDagua: false } };
+    recursos: { videosMes: 0, resolucao: 2160, marcaDagua: false, narracaoPremium: true, clubeCompleto: true, scriptsAE: true, subagentes: 7, kitsMarca: 0, versoesEditor: 0 } };
 
 /** Pergunta (acao "checar") ou conta (acao "gastar") no servidor. */
 async function consultar(acao = 'checar', { buscar = fetch, servidor, token, prazo = 6000 } = {}) {
@@ -33,6 +33,7 @@ async function consultar(acao = 'checar', { buscar = fetch, servidor, token, pra
         });
         const j = await r.json();
         if (!r.ok || !j || !j.recursos) return LOCAL;
+        require('../limites.js').guardar(j);
         return j;
     } catch { return LOCAL; }
 }
@@ -137,14 +138,20 @@ function aplicar(arquivo, recursos, { rodar = spawnSync, dim = dimensoes } = {})
 async function comCota(render, deps = {}) {
     const c = await (deps.consultar || consultar)('checar');
     if (!c.liberado) return { ok: false, error: mensagemLimite(c), cota: { plano: c.plano, restam: 0, upgrade: c.upgrade } };
+    const lim = require('../limites.js');
+    lim.guardar(c); lim.pegarAvisos();
     const r = await render();
+    const extra = lim.pegarAvisos();
     if (!r || !r.ok) return r;
     const a = c.offline ? { ok: true, mudou: false } : (deps.aplicar || aplicar)(r.video, c.recursos);
     if (!c.offline) await (deps.consultar || consultar)('gastar');
     const restam = c.restam == null ? null : Math.max(0, c.restam - 1);
     return { ...r, plano: { id: c.plano, restam, resolucao: c.recursos.resolucao, marcaDagua: !!(a.mudou && c.recursos.marcaDagua) },
-        ...(c.offline ? { aviso: 'sem rede: modo local, sem cota nem marca d\'água.' }
-            : restam === 0 ? { aviso: 'Foi o seu último vídeo do mês. Veja os planos com: primocode planos' } : {}) };
+        ...((() => {
+            const a = [...(c.offline ? ['sem rede: modo local, sem cota nem marca d\'água.'] : []),
+                ...(!c.offline && restam === 0 ? ['Foi o seu último vídeo do mês. Veja os planos com: primocode planos'] : []), ...extra];
+            return a.length ? { aviso: a.join(' ') } : {};
+        })()) };
 }
 
 module.exports = { LOCAL, consultar, mensagemLimite, pngMarca, filtros, aplicar, comCota };

package/lib/estudio/editor.js

@@ -249,6 +249,11 @@ async function editar(args = {}, { pasta, deps = {} } = {}) {
         return { ok: true, versao: v.n, video, versoes: lista(), nota: `voltou para a v${v.n}; a próxima mudança vira a v${ix.versoes.reduce((m, x) => Math.max(m, x.n), 0) + 1}.` };
     }
 
+    // O plano limita as edições guardadas por vídeo (grátis 3). Prévia e a versão original não contam.
+    const gastas = indice(pasta).versoes.filter((v) => !v.previa && v.resumo !== 'original').length;
+    const lim = await (deps.cabeMais ? deps.cabeMais(gastas) : require('../limites.js').cabeMais('versoesEditor', gastas));
+    if (!lim.ok && !args.previa) return { ok: false, error: lim.error + ' Dá para voltar a uma versão (voltar_para) ou ver as prévias.' };
+
     const spec = ler(ARQ(pasta));
     const mudancas = Array.isArray(args.mudancas) ? args.mudancas : [];
     if (!mudancas.length && !args.final) return { ok: false, error: 'mudancas está vazio (ou use final:true para renderizar a prévia em qualidade final).' };

package/lib/estudio/index.js

@@ -508,7 +508,7 @@ async function ferramentaMidia(args) {
     if (args.id && !p) return semProjeto(args.id);
 
     if (acao === 'projetos') return require('./projetos.js').procurar({ termo: args.termo, categoria: args.categoria, limite: args.limite });
-    if (acao === 'projeto') return require('./projetos.js').ver(args.nome || args.id_item || args.termo);
+    if (acao === 'projeto') return require('./projetos.js').ver(args.nome || args.id_item || args.termo, { c: await require('../limites.js').situacao() });
 
     if (acao === 'fontes') {
         if (args.conferir) return assets.conferirFonte(args.conferir);
@@ -712,8 +712,10 @@ async function ferramentaMotion(args) {
     if (!args.id || !p) return semProjeto(args.id);
     let receita = null;
     if (args.receita) {
-        const r = require('./projetos.js').ver(args.receita);
+        const r = require('./projetos.js').ver(args.receita, { c: await require('../limites.js').situacao() });
         if (!r.ok) return r;
+        // Grátis vê o resumo da receita, não monta a partir dela: diz o porquê em vez de renderizar pela metade.
+        if (r.bloqueado) return { ok: false, error: r.aviso, projeto: r.projeto };
         receita = r.projeto;
     }
     return require('./cota.js').comCota(() => renderMotion(args, p, receita));
@@ -1204,6 +1206,11 @@ function vazamentoNoComeco(lista, palavras, direcao = '') {
 }
 
 async function narrarComGemini(lista, mp3, { voz, direcao } = {}) {
+    /* A narração premium é do Pro em diante (lib/limites.js). Sem ela a corrente
+       segue para a voz local (Kokoro/Edge) e o aviso explica o porquê. */
+    const lim = require('../limites.js');
+    const prem = await lim.exigir('narracaoPremium');
+    if (!prem.ok) { lim.avisar(prem.error + ' A narração saiu com a voz local.'); return { ok: false, error: prem.error }; }
     try {
         const cfg = require('../config').loadConfig();
         const api = require('../api');

package/lib/estudio/projetos.js

@@ -47,11 +47,23 @@ function procurar({ termo, categoria, limite = 10 } = {}) {
 }
 
 /** A receita inteira, pelo id (ou, na falta, o melhor palpite do texto). */
-function ver(id) {
+function ver(id, { c } = {}) {
     const q = sem(id).trim();
     if (!q) return { ok: false, error: 'diga o id da receita (acao:"projetos" lista).' };
     const p = todos().find((x) => x.id === q) || procurar({ termo: q, limite: 1 }).projetos.map((x) => todos().find((y) => y.id === x.id))[0];
     if (!p) return { ok: false, error: `não há receita "${id}".`, ids: todos().map((x) => x.id) };
+    // O plano decide (lib/limites.js): grátis vê o resumo; sem scriptsAE a receita vem sem os scripts.
+    if (c && c.recursos) {
+        const lim = require('../limites.js');
+        if (!c.recursos.clubeCompleto) {
+            const { id: i, titulo, categoria, resumo, indicado, estilo, ficha } = p;
+            return { ok: true, bloqueado: true, projeto: { id: i, titulo, categoria, resumo, indicado, estilo, ficha }, aviso: lim.bloqueio('clubeCompleto', c) };
+        }
+        if (p.scripts_ae && !c.recursos.scriptsAE) {
+            const { scripts_ae: _, ...resto } = p;
+            return { ok: true, projeto: resto, scripts_ae_bloqueado: lim.bloqueio('scriptsAE', c) };
+        }
+    }
     // Os scripts do After Effects ficam em disco: a resposta leva o caminho, e o agente lê só o que precisar.
     if (p.scripts_ae) p.scripts_ae = { ...p.scripts_ae, caminho: path.join(__dirname, 'dados', 'projetos-ae', p.id.replace(/^clube-/, '')) };
     return { ok: true, projeto: p };

package/lib/limites.js

@@ -0,0 +1,100 @@
+/**
+ * limites.js — o que o plano libera, aplicado de verdade na CLI.
+ *
+ * A tabela mora em server/lib/planos.js; o servidor responde o plano da pessoa
+ * em POST /api/video/cota (recursos + o catálogo enxuto). Aqui ficam:
+ *   - situacao(): o plano agora, guardado 5 min na memória do processo;
+ *   - o MODO LOCAL generoso (sem rede, servidor mudo ou campo que o servidor
+ *     ainda não manda): nada é barrado. Errar para o lado de quem trabalha;
+ *   - bloqueio(): a mensagem curta e honesta — o quê, em que plano você está,
+ *     qual plano libera e o comando para assinar. Nunca barra sem dizer o porquê.
+ */
+
+'use strict';
+
+const GENEROSO = { videosMes: 0, resolucao: 2160, marcaDagua: false, narracaoPremium: true, clubeCompleto: true,
+    scriptsAE: true, prioridade: 0, subagentes: 7, kitsMarca: 0, versoesEditor: 0 };
+const MAX_PARALELO = 8;
+const VALIDADE = 5 * 60000;
+
+let cache = null;
+const avisos = [];
+
+/** Completa o que o servidor não mandou com o generoso (campo novo, servidor velho). */
+function completar(c) {
+    const r = { ...GENEROSO };
+    for (const [k, v] of Object.entries((c && c.recursos) || {})) if (v !== undefined && v !== null) r[k] = v;
+    return { ...(c || {}), recursos: r };
+}
+
+function guardar(c) { cache = { em: Date.now(), c: completar(c) }; }
+function esquecer() { cache = null; }
+
+/** Nos testes (node test/x.test.js) ninguém bate no servidor de verdade: vale o modo local. */
+const emTeste = () => /\.test\.m?js$/.test(String(process.argv[1] || '')) || process.env.PRIMOCODE_LIMITES === 'local';
+
+/** O plano agora: {plano, recursos, planos, offline}. Nunca lança. */
+async function situacao(deps = {}) {
+    if (cache && Date.now() - cache.em < VALIDADE) return cache.c;
+    if (emTeste() && !deps.consultar) return completar(require('./estudio/cota.js').LOCAL);
+    let c;
+    try { c = await (deps.consultar || require('./estudio/cota.js').consultar)('checar'); } catch { c = require('./estudio/cota.js').LOCAL; }
+    guardar(c);
+    return cache.c;
+}
+const recursos = async (deps) => (await situacao(deps)).recursos;
+
+const reais = (n) => `R$ ${Number(n).toFixed(2).replace('.', ',')}`;
+
+/* Cada recurso: o que o plano ganha ao passar, e o texto de quando bate. */
+const RECURSOS = {
+    narracaoPremium: { de: (r) => !!r.narracaoPremium, texto: 'A narração premium (voz do Gemini)', libera: 'a narração premium' },
+    clubeCompleto: { de: (r) => !!r.clubeCompleto, texto: 'A receita completa do Clube (etapas e prompt)', libera: 'as receitas completas do Clube' },
+    scriptsAE: { de: (r) => !!r.scriptsAE, texto: 'Os scripts de After Effects modelo', libera: 'os scripts de After Effects modelo' },
+    kitsMarca: { n: (r) => r.kitsMarca, texto: (r) => `Você já tem ${r.kitsMarca} kit${r.kitsMarca > 1 ? 's' : ''} de marca, o limite do plano`, libera: (r) => (r.kitsMarca ? `${r.kitsMarca} kits de marca` : 'kits de marca sem teto') },
+    versoesEditor: { n: (r) => r.versoesEditor, texto: (r) => `Este vídeo já tem ${r.versoesEditor} edições, o limite do plano`, libera: (r) => (r.versoesEditor ? `${r.versoesEditor} edições por vídeo` : 'edições sem teto') },
+    subagentes: { n: (r) => r.subagentes + 1, texto: (r) => `Seu plano roda ${r.subagentes + 1} subagente${r.subagentes ? 's juntos' : ' por vez'}`, libera: (r) => (r.subagentes ? `${r.subagentes + 1} subagentes juntos` : 'subagentes em paralelo') },
+};
+
+/** O primeiro plano acima do atual que libera `chave` (ou null). */
+function quemLibera(chave, c) {
+    const def = RECURSOS[chave], lista = c.planos || [];
+    const i = lista.findIndex((p) => p.id === c.plano);
+    return lista.slice(i + 1).find((p) => (def.de ? def.de(p.recursos) : (def.n(p.recursos) === 0 || def.n(p.recursos) > def.n(c.recursos)))) || null;
+}
+
+/** A mensagem de limite: curta, com o motivo, o degrau que libera e o comando. */
+function bloqueio(chave, c) {
+    const def = RECURSOS[chave], r = c.recursos;
+    const nome = ((c.planos || []).find((p) => p.id === c.plano) || {}).nome || c.plano;
+    const p = quemLibera(chave, c);
+    const texto = typeof def.texto === 'function' ? def.texto(r) : `${def.texto} não vêm no plano ${nome}`;
+    const libera = typeof def.libera === 'function' ? def.libera(p ? p.recursos : r) : def.libera;
+    return `${texto} (plano ${nome}).`
+        + (p ? ` O ${p.nome} (${reais(p.preco)}/mês) libera ${libera}.` : '')
+        + ' Veja e assine: primocode planos (ou primocode.web.app/planos).';
+}
+
+/** Libera o que é só ligado/desligado. {ok:true} ou {ok:false, error}. */
+async function exigir(chave, deps) {
+    const c = await situacao(deps);
+    return RECURSOS[chave].de(c.recursos) ? { ok: true } : { ok: false, error: bloqueio(chave, c) };
+}
+
+/** Limite numérico: `usados` já é o que existe; passa se o teto é 0 (sem teto) ou se ainda cabe mais um. */
+async function cabeMais(chave, usados, deps) {
+    const c = await situacao(deps), teto = RECURSOS[chave].n(c.recursos);
+    return !teto || usados < teto ? { ok: true } : { ok: false, error: bloqueio(chave, c) };
+}
+
+/** Quantos subagentes rodam juntos na mesma rodada (o principal fica de fora). */
+async function paralelo(deps) {
+    const c = await situacao(deps);
+    return { max: Math.min(MAX_PARALELO, c.recursos.subagentes + 1), aviso: (n) => (n > c.recursos.subagentes + 1 ? bloqueio('subagentes', c) : null) };
+}
+
+/** Avisos que o resultado da ferramenta leva ao fim da vez (ex.: narração premium trocada pela local). */
+function avisar(msg) { if (msg && !avisos.includes(msg)) avisos.push(msg); }
+function pegarAvisos() { return avisos.splice(0); }
+
+module.exports = { GENEROSO, MAX_PARALELO, situacao, recursos, guardar, esquecer, completar, bloqueio, quemLibera, exigir, cabeMais, paralelo, avisar, pegarAvisos, RECURSOS };

package/lib/marca-kit.js

@@ -280,6 +280,9 @@ async function main(argv, { perguntar, dizer = console.log, pasta = process.cwd(
     const aqui = resto.includes('aqui');
     switch (op) {
         case 'criar': {
+            // O plano limita quantos kits se guarda (grátis 1): diz o porquê antes de perguntar qualquer coisa.
+            const lim = await (deps && deps.cabeMais ? deps.cabeMais(listar().length) : require('./limites.js').cabeMais('kitsMarca', listar().length));
+            if (!lim.ok) { dizer(lim.error); return 1; }
             const t = perguntar ? null : perguntarNoTerminal();
             try {
                 const r = await criar({ perguntar: perguntar || t.ask, dizer, deps });

package/lib/planos.js

@@ -15,14 +15,14 @@
 const https = require('https');
 const http = require('http');
 
-const R = (videosMes, resolucao, marcaDagua, narracaoPremium, clubeCompleto, scriptsAE, prioridade, subagentes) =>
-    ({ videosMes, resolucao, marcaDagua, narracaoPremium, clubeCompleto, scriptsAE, prioridade, subagentes });
-const GRATIS = { id: 'free', nome: 'Grátis', preco: 0, recursos: R(3, 720, true, false, false, false, 0, 0), inclui: [] };
+const R = (videosMes, resolucao, marcaDagua, narracaoPremium, clubeCompleto, scriptsAE, prioridade, subagentes, kitsMarca, versoesEditor) =>
+    ({ videosMes, resolucao, marcaDagua, narracaoPremium, clubeCompleto, scriptsAE, prioridade, subagentes, kitsMarca, versoesEditor });
+const GRATIS = { id: 'free', nome: 'Grátis', preco: 0, recursos: R(3, 720, true, false, false, false, 0, 0, 1, 3), inclui: [] };
 const RESERVA = [
-    { id: 'primo', nome: 'Primo', preco: 69.9, recursos: R(15, 720, false, false, true, false, 0, 0), inclui: [] },
-    { id: 'pro', nome: 'Primo Pro', preco: 129.9, recursos: R(60, 1080, false, true, true, true, 1, 1), inclui: [] },
-    { id: 'max', nome: 'Primo Max', preco: 299.9, recursos: R(200, 2160, false, true, true, true, 2, 3), inclui: [] },
-    { id: 'studio', nome: 'Primo Studio', preco: 599.9, recursos: R(800, 2160, false, true, true, true, 3, 8), inclui: [] },
+    { id: 'primo', nome: 'Primo', preco: 69.9, recursos: R(15, 720, false, false, true, false, 0, 0, 5, 10), inclui: [] },
+    { id: 'pro', nome: 'Primo Pro', preco: 129.9, recursos: R(60, 1080, false, true, true, true, 1, 1, 20, 30), inclui: [] },
+    { id: 'max', nome: 'Primo Max', preco: 299.9, recursos: R(200, 2160, false, true, true, true, 2, 3, 100, 0), inclui: [] },
+    { id: 'studio', nome: 'Primo Studio', preco: 599.9, recursos: R(800, 2160, false, true, true, true, 3, 8, 0, 0), inclui: [] },
 ];
 
 function buscarPlanos(servidor, { timeout = 8000 } = {}) {
@@ -60,7 +60,9 @@ const LINHAS = [
     ['Projetos do Clube', (r) => (r.clubeCompleto ? 'completos' : 'resumo')],
     ['Scripts AE modelo', (r) => (r.scriptsAE ? '✓' : '—')],
     ['Prioridade na cadeia', (r) => (r.prioridade ? '●'.repeat(r.prioridade) : '—')],
-    ['Subagentes', (r) => (r.subagentes ? String(r.subagentes) : '—')],
+    ['Subagentes juntos', (r) => (r.subagentes ? String(r.subagentes) : 'em fila')],
+    ['Kits de marca', (r) => (r.kitsMarca == null || r.kitsMarca === 0 ? 'sem teto' : String(r.kitsMarca))],
+    ['Edições por vídeo', (r) => (r.versoesEditor == null || r.versoesEditor === 0 ? 'sem teto' : String(r.versoesEditor))],
 ];
 
 /**

package/lib/preparar.js

@@ -70,6 +70,8 @@ function estudioLinhas(dep = {}) {
     // marca ativa
     const mk = tenta(() => require('./marca-kit.js').ativa([process.cwd()]), null);
     poe(null, 'Marca ativa', mk ? (mk.nome || mk.slug || 'sim') : 'nenhuma — primocode marca criar <nome>');
+    // Primo (modo voz)
+    tenta(() => linhas.push(...require('./voz.js').linhasDoutor()), null);
     // MCP
     const mcp = tenta(() => Object.keys(require('./mcp.js').servidores()), []);
     poe(null, 'MCP', mcp.length ? mcp.join(', ') : 'nenhum servidor');

package/lib/voz-ponte.js

@@ -0,0 +1,15 @@
+/**
+ * voz-ponte.js — o aviso do agente para o modo voz, sem um depender do outro.
+ *
+ * O agente (lib/act.js) diz "comecei a ferramenta X" aqui; o /voice, se estiver
+ * ligado, se inscreve e repassa ao Primo (painel mostra "executando" e ele
+ * confirma em voz alta: "rodando os testes"). Sem /voice, ninguém escuta.
+ */
+'use strict';
+
+let ouvinte = null;
+
+module.exports = {
+    escutar: (fn) => { ouvinte = typeof fn === 'function' ? fn : null; },
+    ferramenta: (nome, args) => { if (ouvinte) { try { ouvinte(String(nome || ''), args || {}); } catch { /* o aviso nunca derruba o agente */ } } },
+};

package/lib/voz.js

@@ -63,8 +63,19 @@ function paraFalar(texto, { frases = 3, teto = 420 } = {}) {
     return (fala || t.slice(0, teto)).trim();
 }
 
-/** Onde está o Python 3. Mesmo problema do Estúdio, mesma cura. */
+/* O VENV DO PRIMO. As dependências opcionais (VAD, painel em tela cheia) moram
+ * em ~/.primocode/voz-venv, instaladas sob demanda: ninguém precisa quebrar o
+ * Python do sistema (PEP 668) nem perde nada se não instalar. */
+const VENV = path.join(os.homedir(), '.primocode', 'voz-venv');
+const venvPython = () => path.join(VENV, process.platform === 'win32' ? 'Scripts' : 'bin', process.platform === 'win32' ? 'python.exe' : 'python');
+
+/** Onde está o Python 3. O do venv do Primo ganha, se já existir. */
 function python() {
+    if (fs.existsSync(venvPython())) return venvPython();
+    return pythonDoSistema();
+}
+
+function pythonDoSistema() {
     const nomes = process.platform === 'win32'
         ? ['python', 'py', 'python3']
         : ['python3', 'python', '/opt/homebrew/bin/python3', '/usr/local/bin/python3', '/usr/bin/python3'];
@@ -223,7 +234,7 @@ function instalar(py, pacotes, aoFalar = () => {}) {
  * @param {()=>void} [op.aoPronto]              o microfone abriu
  * @returns {{processo, pronto: Promise, falar:(t:string)=>void, calar:()=>void}}
  */
-function abrir({ python: py, servidor, token, voz, aoOuvir, mostrar = () => {}, aoPronto = () => {} }) {
+function abrir({ python: py, servidor, token, voz, aoParar = () => {}, aoOuvir, mostrar = () => {}, aoPronto = () => {} }) {
     let p;
     const manda = (obj) => {
         try { p.stdin.write(JSON.stringify(obj) + '\n'); } catch { /* já fechou */ }
@@ -237,6 +248,7 @@ function abrir({ python: py, servidor, token, voz, aoOuvir, mostrar = () => {},
                 PRIMOCODE_SERVER: servidor,
                 PRIMOCODE_TOKEN: token || '',
                 PRIMOCODE_VOZ: voz || 'antonio',
+                PRIMOCODE_CWD: process.cwd(),
                 PYTHONUNBUFFERED: '1',
                 // O Whisper deixa um semáforo para o sistema recolher na saída,
                 // e o Python avisa disso no stderr. É inofensivo; o aviso não é.
@@ -254,6 +266,7 @@ function abrir({ python: py, servidor, token, voz, aoOuvir, mostrar = () => {},
                 try { msg = JSON.parse(linha); } catch { continue; }
                 if (msg.tipo === 'fim') { try { p.kill(); } catch {} return; }
                 if (msg.tipo === 'pronto') { try { aoPronto(); } catch {} continue; }
+                if (msg.tipo === 'parar') { try { aoParar(); } catch {} continue; }
                 if (msg.tipo === 'erro') { mostrar(String(msg.texto || ''), true); continue; }
                 if (msg.tipo === 'ouvi' && String(msg.texto || '').trim()) {
                     try { aoOuvir(String(msg.texto).trim()); } catch (e) { mostrar(e.message, true); }
@@ -276,7 +289,12 @@ function abrir({ python: py, servidor, token, voz, aoOuvir, mostrar = () => {},
     return {
         processo: p,
         pronto,
-        falar: (texto) => { const t = paraFalar(texto); if (t) manda({ tipo: 'falar', texto: t }); },
+        /* O texto vai BRUTO: quem resume é o Primo (voz/primo_voz/conversa.py) —
+           a voz diz o resumo, o painel mostra o resto (código, listas). */
+        falar: (texto) => { const t = String(texto || '').trim(); if (t) manda({ tipo: 'falar', texto: t, bruto: true }); },
+        // O agente começou uma ferramenta: o painel mostra "executando" e o Primo confirma ("rodando os testes").
+        ferramenta: (nome, args) => manda({ tipo: 'ferramenta', nome, args: args || {} }),
+        painel: (acao) => manda({ tipo: 'painel', acao }),
         calar: () => manda({ tipo: 'calar' }),
         // A bolinha na tela: 'esperando' quando o terminal termina sem falar.
         estado: (e) => manda({ tipo: 'estado', estado: e }),
@@ -303,7 +321,10 @@ function abrir({ python: py, servidor, token, voz, aoOuvir, mostrar = () => {},
  */
 const OPCIONAIS = () => [
     ['faster_whisper', 'faster-whisper', 'a transcrição local (Whisper)'],
+    ['pysilero_vad', 'pysilero-vad', 'o fim de fala preciso (Silero VAD)'],
     ...(process.platform === 'darwin' ? [
+        ['WebKit', 'pyobjc-framework-WebKit', 'o painel em tela cheia do Primo'],
+        ['EventKit', 'pyobjc-framework-EventKit', 'os compromissos de hoje do app Calendário'],
         ['Quartz', 'pyobjc-framework-Quartz', 'o cursor do Primo na tela'],
         ['Vision', 'pyobjc-framework-Vision', 'ler o texto da tela (clicar pelo nome em qualquer app)'],
     ] : []),
@@ -394,13 +415,23 @@ async function baixarWhisper(py) {
  * @returns {Promise<{ok:boolean, python?:string, esperando?:boolean,
  *                    avisos:string[], error?:string, comoResolver?:string}>}
  */
+async function criarVenv(aoFalar) {
+    if (fs.existsSync(venvPython())) return null;
+    const base = pythonDoSistema();
+    if (!base) return null;
+    aoFalar('criando o ambiente do Primo (~/.primocode/voz-venv)');
+    const r = await rodar(base, ['-m', 'venv', VENV], 5 * 60 * 1000);
+    return r.ok ? null : `não consegui criar o ambiente do Primo (${porqueOPipFalhou(r.saida)}) — uso o Python do sistema.`;
+}
+
 async function preparar(aoFalar = () => {}) {
+    const avisoVenv = await criarVenv(aoFalar);
     const py = python();
     if (!py) {
         return { ok: false, avisos: [], error: 'o modo voz precisa do Python 3, e não achei nenhum nesta máquina.',
             comoResolver: process.platform === 'darwin' ? 'brew install python' : 'instale em python.org e abra o terminal de novo' };
     }
-    const avisos = [];
+    const avisos = avisoVenv ? [avisoVenv] : [];
 
     // 1. sistema, depois 2. os obrigatórios pelo pip.
     let falta = faltando(py);
@@ -435,4 +466,43 @@ async function preparar(aoFalar = () => {}) {
     return { ok: true, python: py, avisos };
 }
 
-module.exports = { DICA_COMPUTADOR, paraFalar, conferir, instalar, preparar, porqueOPipFalhou, abrir, python, PASTA };
+/** `/voice painel`: só o HUD (sem microfone). Mac com PyObjC = tela cheia; senão, o quadro no terminal. */
+function abrirPainel({ python: py }) {
+    const mac = process.platform === 'darwin' && temModulo(py, 'WebKit');
+    const p = spawn(py, ['-m', mac ? 'primo_voz.hud' : 'primo_voz.painel_tui', ...(mac ? ['--livre'] : [])], {
+        cwd: PASTA, env: { ...process.env, PYTHONPATH: PASTA }, stdio: mac ? 'ignore' : ['pipe', 'inherit', 'inherit'],
+    });
+    return { processo: p, tela: mac };
+}
+
+/** Grava o nome do assistente em ~/.primocode/voz.json (o mesmo arquivo que voz/primo_voz/identidade.py lê). */
+function definirNome(nome) {
+    const limpo = String(nome || '').replace(/[^\p{L}\p{N} -]/gu, '').trim();
+    if (!limpo || limpo.split(/\s+/).length > 2 || limpo.length < 2 || limpo.length > 20) return null;
+    const arq = process.env.PRIMOCODE_VOZ_CONFIG || path.join(os.homedir(), '.primocode', 'voz.json');
+    let cfg = {};
+    try { cfg = JSON.parse(fs.readFileSync(arq, 'utf8')); } catch { /* primeira vez */ }
+    cfg.nome = limpo.split(/\s+/).map((w) => w[0].toUpperCase() + w.slice(1)).join(' ');
+    fs.mkdirSync(path.dirname(arq), { recursive: true });
+    fs.writeFileSync(arq, JSON.stringify(cfg, null, 2));
+    return cfg.nome;
+}
+
+/** As linhas do `primocode doutor` sobre o modo voz. */
+function linhasDoutor() {
+    const py = python();
+    if (!py) return [{ ok: false, item: 'Primo (voz)', detalhe: 'sem Python 3', conserto: 'brew install python' }];
+    const tem = (m) => temModulo(py, m);
+    const venv = fs.existsSync(venvPython());
+    const linha = (ok, item, detalhe, conserto) => ({ ok, item, detalhe, conserto: ok === false ? conserto : undefined });
+    return [
+        linha(venv ? true : null, 'Primo: ambiente', venv ? VENV : 'ainda não criado — /voice cria sozinho', undefined),
+        linha(tem('sounddevice') && tem('numpy'), 'Primo: microfone', 'sounddevice + numpy', '/voice instala; ou: ' + py + ' -m pip install sounddevice numpy'),
+        linha(tem('faster_whisper') ? true : null, 'Primo: Whisper local', tem('faster_whisper') ? 'instalado' : 'não instalado — usa o servidor'),
+        linha(tem('pysilero_vad') ? true : null, 'Primo: Silero VAD', tem('pysilero_vad') ? 'fim de fala preciso' : 'não instalado — usa o corte por volume'),
+        linha(process.platform === 'darwin' ? (tem('WebKit') ? true : null) : null, 'Primo: tela cheia',
+            process.platform !== 'darwin' ? 'só no Mac — aqui, painel no terminal' : tem('WebKit') ? 'pronto' : 'sem PyObjC WebKit — usa a orbe'),
+    ];
+}
+
+module.exports = { definirNome, VENV, abrirPainel, linhasDoutor, DICA_COMPUTADOR, paraFalar, conferir, instalar, preparar, porqueOPipFalhou, abrir, python, PASTA };