primocode 10.13.0 → 10.14.0

package/lib/hooks.js

@@ -0,0 +1,72 @@
+/**
+ * hooks.js — comandos seus que rodam ANTES e DEPOIS de cada ferramenta.
+ *
+ * Arquivo: ~/.primocode/hooks.json (vale em tudo) e <projeto>/.primocode/hooks.json:
+ *
+ *   { "PreToolUse":  [{ "matcher": "run_shell|write_file", "command": "./checar.sh" }],
+ *     "PostToolUse": [{ "matcher": "write_file|edit_file", "command": "npx prettier --write ." }] }
+ *
+ * O comando recebe o evento em JSON no stdin ({evento, ferramenta, argumentos,
+ * resultado, pasta}). No PreToolUse, sair com código 2 BLOQUEIA a ferramenta e o
+ * stderr vira o motivo que o agente lê. Qualquer outro código só avisa. Sem
+ * `matcher`, vale para toda ferramenta. O contrato é o mesmo dos hooks
+ * documentados do Claude Code (code.claude.com/docs/en/hooks); o código é nosso.
+ */
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const EVENTOS = ['PreToolUse', 'PostToolUse'];
+const PRAZO_MS = 10000;
+
+function ler(arquivo) {
+    try {
+        const j = JSON.parse(fs.readFileSync(arquivo, 'utf8'));
+        return j && typeof j === 'object' ? j : {};
+    } catch { return {}; }
+}
+
+/** Os hooks de um evento: os da casa primeiro, depois os do projeto. */
+function carregar(evento, projectDir) {
+    const arquivos = [path.join(os.homedir(), '.primocode', 'hooks.json')];
+    if (projectDir) arquivos.push(path.join(projectDir, '.primocode', 'hooks.json'));
+    const out = [];
+    for (const a of arquivos) {
+        const lista = ler(a)[evento];
+        if (!Array.isArray(lista)) continue;
+        for (const h of lista) if (h && typeof h.command === 'string' && h.command.trim()) out.push(h);
+    }
+    return out;
+}
+
+function casa(matcher, nome) {
+    if (!matcher || matcher === '*') return true;
+    try { return new RegExp(`^(?:${matcher})$`).test(nome); } catch { return false; }
+}
+
+/**
+ * Roda os hooks do evento. Devolve { bloqueado, motivo, avisos[] }.
+ * Só o PreToolUse bloqueia.
+ */
+function rodar(evento, { nome, args, resultado, projectDir }) {
+    const saida = { bloqueado: false, motivo: '', avisos: [] };
+    if (!EVENTOS.includes(evento)) return saida;
+    const entrada = JSON.stringify({ evento, ferramenta: nome, argumentos: args || {}, resultado, pasta: projectDir });
+    for (const h of carregar(evento, projectDir)) {
+        if (!casa(h.matcher, nome)) continue;
+        const r = spawnSync(h.command, { shell: true, input: entrada, cwd: projectDir || process.cwd(), encoding: 'utf8', timeout: h.timeout ? h.timeout * 1000 : PRAZO_MS });
+        const err = String(r.stderr || '').trim();
+        if (evento === 'PreToolUse' && r.status === 2) {
+            saida.bloqueado = true;
+            saida.motivo = err || `bloqueado pelo hook: ${h.command}`;
+            return saida;
+        }
+        if (r.error || r.status !== 0) saida.avisos.push(`hook "${h.command.slice(0, 40)}" ${r.error ? 'falhou: ' + r.error.message : 'saiu com ' + r.status}${err ? ' — ' + err.slice(0, 120) : ''}`);
+    }
+    return saida;
+}
+
+module.exports = { EVENTOS, carregar, casa, rodar };

package/lib/local/cerebro.json

@@ -1,6 +1,6 @@
 {
- "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.",
+ "origem": "primocode-server 8.20.0 6015327",
+ "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), nunca list_dir (o mapa já está aqui); servidor de pé → run_in_new_terminal.\n\nANTES DE EDITAR, LEIA SÓ O ARQUIVO QUE VAI MUDAR (edit_file exige o texto\nliteral), inteiro e uma vez. Nada de ler outros \"para entender\".\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 — veja o mapa 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: ache o alvo (mapa ou grep) → leia só ele → faça → confira → finish.\nCriar do zero: escreva direto, sem ler nada.",
  "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…): 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.",
@@ -10,7 +10,7 @@
   "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ê."
+  "codigo": "QUALIDADE DE CÓDIGO — o que separa código de rascunho:\n- Siga o padrão do arquivo que está mudando: nomes, indentação, idioma, erro.\n  Código que destoa 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ê."
  },
  "SYSTEM_SUB": "Você é um subagente do PrimoCode. Recebeu UMA tarefa e trabalha sozinho.\n\n- Você não vê a conversa do usuário. Sua instrução é tudo que existe.\n- Execute com as tools. Não peça confirmação, não converse.\n- Caminhos sempre relativos à pasta do projeto.\n- Ao terminar, chame finish() com um resumo objetivo do que fez ou descobriu.\n  Esse resumo é a ÚNICA coisa que o agente principal vai receber — então\n  inclua o que ele precisa saber (arquivos mexidos, o que você achou, números).",
  "SYSTEM_CHAT": "Você é PrimoCode Chat. Responda em português do Brasil.\n\nREGRAS:\n- Respostas CURTAS. Máximo 3 linhas.\n- Sem markdown: sem **bold**, sem #, sem `crase`.\n- Escreva como pessoa, não como manual.\n- NÃO crie arquivos. NÃO execute comandos. Só converse.",
@@ -599,7 +599,7 @@
    "type": "function",
    "function": {
     "name": "estudio_midia",
-    "description": "Procura e BAIXA para o projeto imagem, icone, som, trilha e efeito, e lista fontes. Nunca audio de YouTube/Spotify.",
+    "description": "Midia do projeto: imagem, icone (qualquer colecao do Iconify), som, trilha, efeito, fontes; referencia (a imagem que a pessoa mandou), print e logo do site; cenarios do 3D e salvar_cenario (so com o sim da pessoa); projetos (receitas completas, termo/categoria) e projeto (a receita, nome). Nunca audio de YouTube/Spotify.",
     "parameters": {
      "type": "object",
      "properties": {
@@ -614,7 +614,14 @@
         "som",
         "trilha",
         "efeito",
-        "fontes"
+        "fontes",
+        "referencia",
+        "print",
+        "logo",
+        "cenarios",
+        "salvar_cenario",
+        "projetos",
+        "projeto"
        ]
       },
       "termo": {
@@ -626,10 +633,26 @@
       },
       "nome": {
        "type": "string",
-       "description": "icones: \"lucide:zap\" baixa"
+       "description": "icones: \"lucide:zap\" baixa; salvar_cenario: o nome"
       },
       "transparente": {
        "type": "boolean"
+      },
+      "arquivo": {
+       "type": "string",
+       "description": "referencia: caminho da imagem"
+      },
+      "url": {
+       "type": "string",
+       "description": "print/logo: o site"
+      },
+      "cenario": {
+       "type": "object",
+       "description": "salvar_cenario: {lugar, ceu, chao, parede, luz, acento, hora, elementos}"
+      },
+      "autorizado": {
+       "type": "boolean",
+       "description": "salvar_cenario: true so depois do sim da pessoa"
       }
      },
      "required": [
@@ -638,6 +661,165 @@
     }
    }
   },
+  {
+   "type": "function",
+   "function": {
+    "name": "estudio_ae",
+    "description": "After Effects (EffectCraft): roda um JSX e renderiza video-ae.mp4. Leia a skill after-effects.",
+    "parameters": {
+     "type": "object",
+     "properties": {
+      "id": {
+       "type": "string"
+      },
+      "script": {
+       "type": "string",
+       "description": "JSX"
+      },
+      "comp": {
+       "type": "string",
+       "description": "Nome da comp"
+      },
+      "fontes": {
+       "type": "array",
+       "items": {
+        "type": "object"
+       },
+       "description": "[{familia, peso}]"
+      },
+      "audio": {
+       "type": "string"
+      },
+      "conferir": {
+       "type": "array",
+       "items": {
+        "type": "number"
+       },
+       "description": "Segundos dos quadros"
+      }
+     },
+     "required": [
+      "id",
+      "script",
+      "comp"
+     ]
+    }
+   }
+  },
+  {
+   "type": "function",
+   "function": {
+    "name": "estudio_motion",
+    "description": "A MAQUINA DE MOTION: voce so preenche o JSON (assunto, formato, marca, cenas) e ela monta no After Effects, poe os sons no tempo, mixa a -14 LUFS e confere os quadros. Prefira esta a escrever JSX. Tipos de cena: gancho{titulo,sub} celular{titulo,tela,toques[]} numero{valor,rotulo} lista{titulo,itens[]} antes_depois{antes,depois} icones{titulo,itens[]} citacao{texto,autor} cta{titulo,botao}. Marque a palavra-chave com *asteriscos*. Sem cenas, ela monta o roteiro padrao do assunto.",
+    "parameters": {
+     "type": "object",
+     "properties": {
+      "id": {
+       "type": "string"
+      },
+      "assunto": {
+       "type": "string",
+       "description": "O tema do video"
+      },
+      "receita": {
+       "type": "string",
+       "description": "id de estudio_midia acao:\"projetos\": segue o formato e a duracao da ficha"
+      },
+      "formato": {
+       "type": "string",
+       "enum": [
+        "9:16",
+        "1:1",
+        "16:9"
+       ]
+      },
+      "duracao": {
+       "type": "number",
+       "description": "Segundos (6 a 60); padrao 15"
+      },
+      "marca": {
+       "type": "object",
+       "description": "{cores:{fundo,destaque,tinta}, fontes:{titulo,texto,destaque}}; sem marca a paleta sai do assunto"
+      },
+      "cenas": {
+       "type": "array",
+       "items": {
+        "type": "object"
+       },
+       "description": "[{tipo, dur, ...campos do tipo}]; de 1 a 2,5 s por cena e no minimo 5 cenas para 15 s"
+      },
+      "voz": {
+       "type": "string",
+       "description": "O texto a narrar; opcional"
+      },
+      "trilha": {
+       "type": "string",
+       "description": "O que buscar de trilha livre (\"upbeat lofi\"); opcional"
+      },
+      "formatos": {
+       "type": "array",
+       "items": {
+        "type": "string",
+        "enum": [
+         "9:16",
+         "1:1",
+         "16:9"
+        ]
+       },
+       "description": "Versoes extras no pacote entrega/ (fundo desfocado, nunca estica)"
+      },
+      "entrega": {
+       "type": "boolean",
+       "description": "Pacote pra postar (mp4, capa, legenda .srt, post.txt); padrao true"
+      }
+     },
+     "required": [
+      "id"
+     ]
+    }
+   }
+  },
+  {
+   "type": "function",
+   "function": {
+    "name": "estudio_editar",
+    "description": "EDITOR POR COMANDO: muda um video que o estudio_motion fez, sem refazer do zero, e guarda versoes (v1, v2...). id_video = o id do projeto. mudancas = lista de {op,...} (cena conta de 1): texto {cena:2,campo:'titulo',valor:'X'} ou {de,para}; cor {fundo,destaque,tinta em #hex} ou {paleta:'nome'}; fonte {titulo,texto,destaque}; ritmo {fator:0.8} (<1 mais rapido, >1 mais lento); duracao {cena,segundos} ou {total}; remover {cena}; mover {cena,para}; duplicar {cena,para?}; trilha {valor:false} (sem musica) ou {valor:'lofi calmo'}; volume {alvo:'voz'|'trilha'|'sfx',db:-6}; formato {valor:'16:9'}. Exemplos: 'deixa mais rapido' -> [{op:'ritmo',fator:0.8}]; 'tira a musica' -> [{op:'trilha',valor:false}]; 'troca o titulo da cena 2 por Oi' -> [{op:'texto',cena:2,valor:'Oi'}]; 'voz mais alta' -> [{op:'volume',alvo:'voz',db:4}]; 'faz em horizontal' -> [{op:'formato',valor:'16:9'}]. previa:true renderiza rascunho em segundos; final:true renderiza a versao atual em qualidade final; voltar_para:N volta a uma versao; listar:true mostra as versoes. Com narracao o tempo e da voz: ritmo/duracao/remover/mover/duplicar nao valem.",
+    "parameters": {
+     "type": "object",
+     "properties": {
+      "id_video": {
+       "type": "string",
+       "description": "id do projeto do video"
+      },
+      "mudancas": {
+       "type": "array",
+       "items": {
+        "type": "object"
+       },
+       "description": "[{op:'texto'|'cor'|'fonte'|'ritmo'|'duracao'|'remover'|'mover'|'duplicar'|'trilha'|'volume'|'formato', ...}]"
+      },
+      "previa": {
+       "type": "boolean",
+       "description": "rascunho rapido (meia resolucao, sem mix final)"
+      },
+      "final": {
+       "type": "boolean",
+       "description": "render em qualidade final da versao atual"
+      },
+      "voltar_para": {
+       "type": "number",
+       "description": "numero da versao (1, 2...)"
+      },
+      "listar": {
+       "type": "boolean"
+      }
+     },
+     "required": [
+      "id_video"
+     ]
+    }
+   }
+  },
   {
    "type": "function",
    "function": {
@@ -723,7 +905,7 @@
    "type": "function",
    "function": {
     "name": "estudio_render",
-    "description": "Vira o arquivo (.mp4 no video, .pdf em slides e arte) e abre para o usuario.",
+    "description": "Vira o arquivo (.mp4 no video, .pdf em slides e arte) e abre para o usuario. motor:\"hyperframes\" + html:\"<pasta>\" renderiza uma composicao HTML (index.html, GSAP/CSS/three.js) que voce escreveu; ela le midia/ do projeto.",
     "parameters": {
      "type": "object",
      "properties": {
@@ -733,6 +915,17 @@
       "paginas": {
        "type": "boolean",
        "description": "Forca paginas paradas"
+      },
+      "motor": {
+       "type": "string",
+       "enum": [
+        "remotion",
+        "hyperframes"
+       ]
+      },
+      "html": {
+       "type": "string",
+       "description": "hyperframes: a pasta com index.html"
       }
      },
      "required": [
@@ -1886,7 +2079,7 @@
    "type": "function",
    "function": {
     "name": "estudio_midia",
-    "description": "Procura e BAIXA para o projeto imagem, icone, som, trilha e efeito, e lista fontes. Nunca audio de YouTube/Spotify.",
+    "description": "Midia do projeto: imagem, icone (qualquer colecao do Iconify), som, trilha, efeito, fontes; referencia (a imagem que a pessoa mandou), print e logo do site; cenarios do 3D e salvar_cenario (so com o sim da pessoa); projetos (receitas completas, termo/categoria) e projeto (a receita, nome). Nunca audio de YouTube/Spotify.",
     "parameters": {
      "type": "object",
      "properties": {
@@ -1901,7 +2094,14 @@
         "som",
         "trilha",
         "efeito",
-        "fontes"
+        "fontes",
+        "referencia",
+        "print",
+        "logo",
+        "cenarios",
+        "salvar_cenario",
+        "projetos",
+        "projeto"
        ]
       },
       "termo": {
@@ -1913,10 +2113,26 @@
       },
       "nome": {
        "type": "string",
-       "description": "icones: \"lucide:zap\" baixa"
+       "description": "icones: \"lucide:zap\" baixa; salvar_cenario: o nome"
       },
       "transparente": {
        "type": "boolean"
+      },
+      "arquivo": {
+       "type": "string",
+       "description": "referencia: caminho da imagem"
+      },
+      "url": {
+       "type": "string",
+       "description": "print/logo: o site"
+      },
+      "cenario": {
+       "type": "object",
+       "description": "salvar_cenario: {lugar, ceu, chao, parede, luz, acento, hora, elementos}"
+      },
+      "autorizado": {
+       "type": "boolean",
+       "description": "salvar_cenario: true so depois do sim da pessoa"
       }
      },
      "required": [
@@ -1925,6 +2141,165 @@
     }
    }
   },
+  {
+   "type": "function",
+   "function": {
+    "name": "estudio_ae",
+    "description": "After Effects (EffectCraft): roda um JSX e renderiza video-ae.mp4. Leia a skill after-effects.",
+    "parameters": {
+     "type": "object",
+     "properties": {
+      "id": {
+       "type": "string"
+      },
+      "script": {
+       "type": "string",
+       "description": "JSX"
+      },
+      "comp": {
+       "type": "string",
+       "description": "Nome da comp"
+      },
+      "fontes": {
+       "type": "array",
+       "items": {
+        "type": "object"
+       },
+       "description": "[{familia, peso}]"
+      },
+      "audio": {
+       "type": "string"
+      },
+      "conferir": {
+       "type": "array",
+       "items": {
+        "type": "number"
+       },
+       "description": "Segundos dos quadros"
+      }
+     },
+     "required": [
+      "id",
+      "script",
+      "comp"
+     ]
+    }
+   }
+  },
+  {
+   "type": "function",
+   "function": {
+    "name": "estudio_motion",
+    "description": "A MAQUINA DE MOTION: voce so preenche o JSON (assunto, formato, marca, cenas) e ela monta no After Effects, poe os sons no tempo, mixa a -14 LUFS e confere os quadros. Prefira esta a escrever JSX. Tipos de cena: gancho{titulo,sub} celular{titulo,tela,toques[]} numero{valor,rotulo} lista{titulo,itens[]} antes_depois{antes,depois} icones{titulo,itens[]} citacao{texto,autor} cta{titulo,botao}. Marque a palavra-chave com *asteriscos*. Sem cenas, ela monta o roteiro padrao do assunto.",
+    "parameters": {
+     "type": "object",
+     "properties": {
+      "id": {
+       "type": "string"
+      },
+      "assunto": {
+       "type": "string",
+       "description": "O tema do video"
+      },
+      "receita": {
+       "type": "string",
+       "description": "id de estudio_midia acao:\"projetos\": segue o formato e a duracao da ficha"
+      },
+      "formato": {
+       "type": "string",
+       "enum": [
+        "9:16",
+        "1:1",
+        "16:9"
+       ]
+      },
+      "duracao": {
+       "type": "number",
+       "description": "Segundos (6 a 60); padrao 15"
+      },
+      "marca": {
+       "type": "object",
+       "description": "{cores:{fundo,destaque,tinta}, fontes:{titulo,texto,destaque}}; sem marca a paleta sai do assunto"
+      },
+      "cenas": {
+       "type": "array",
+       "items": {
+        "type": "object"
+       },
+       "description": "[{tipo, dur, ...campos do tipo}]; de 1 a 2,5 s por cena e no minimo 5 cenas para 15 s"
+      },
+      "voz": {
+       "type": "string",
+       "description": "O texto a narrar; opcional"
+      },
+      "trilha": {
+       "type": "string",
+       "description": "O que buscar de trilha livre (\"upbeat lofi\"); opcional"
+      },
+      "formatos": {
+       "type": "array",
+       "items": {
+        "type": "string",
+        "enum": [
+         "9:16",
+         "1:1",
+         "16:9"
+        ]
+       },
+       "description": "Versoes extras no pacote entrega/ (fundo desfocado, nunca estica)"
+      },
+      "entrega": {
+       "type": "boolean",
+       "description": "Pacote pra postar (mp4, capa, legenda .srt, post.txt); padrao true"
+      }
+     },
+     "required": [
+      "id"
+     ]
+    }
+   }
+  },
+  {
+   "type": "function",
+   "function": {
+    "name": "estudio_editar",
+    "description": "EDITOR POR COMANDO: muda um video que o estudio_motion fez, sem refazer do zero, e guarda versoes (v1, v2...). id_video = o id do projeto. mudancas = lista de {op,...} (cena conta de 1): texto {cena:2,campo:'titulo',valor:'X'} ou {de,para}; cor {fundo,destaque,tinta em #hex} ou {paleta:'nome'}; fonte {titulo,texto,destaque}; ritmo {fator:0.8} (<1 mais rapido, >1 mais lento); duracao {cena,segundos} ou {total}; remover {cena}; mover {cena,para}; duplicar {cena,para?}; trilha {valor:false} (sem musica) ou {valor:'lofi calmo'}; volume {alvo:'voz'|'trilha'|'sfx',db:-6}; formato {valor:'16:9'}. Exemplos: 'deixa mais rapido' -> [{op:'ritmo',fator:0.8}]; 'tira a musica' -> [{op:'trilha',valor:false}]; 'troca o titulo da cena 2 por Oi' -> [{op:'texto',cena:2,valor:'Oi'}]; 'voz mais alta' -> [{op:'volume',alvo:'voz',db:4}]; 'faz em horizontal' -> [{op:'formato',valor:'16:9'}]. previa:true renderiza rascunho em segundos; final:true renderiza a versao atual em qualidade final; voltar_para:N volta a uma versao; listar:true mostra as versoes. Com narracao o tempo e da voz: ritmo/duracao/remover/mover/duplicar nao valem.",
+    "parameters": {
+     "type": "object",
+     "properties": {
+      "id_video": {
+       "type": "string",
+       "description": "id do projeto do video"
+      },
+      "mudancas": {
+       "type": "array",
+       "items": {
+        "type": "object"
+       },
+       "description": "[{op:'texto'|'cor'|'fonte'|'ritmo'|'duracao'|'remover'|'mover'|'duplicar'|'trilha'|'volume'|'formato', ...}]"
+      },
+      "previa": {
+       "type": "boolean",
+       "description": "rascunho rapido (meia resolucao, sem mix final)"
+      },
+      "final": {
+       "type": "boolean",
+       "description": "render em qualidade final da versao atual"
+      },
+      "voltar_para": {
+       "type": "number",
+       "description": "numero da versao (1, 2...)"
+      },
+      "listar": {
+       "type": "boolean"
+      }
+     },
+     "required": [
+      "id_video"
+     ]
+    }
+   }
+  },
   {
    "type": "function",
    "function": {
@@ -2010,7 +2385,7 @@
    "type": "function",
    "function": {
     "name": "estudio_render",
-    "description": "Vira o arquivo (.mp4 no video, .pdf em slides e arte) e abre para o usuario.",
+    "description": "Vira o arquivo (.mp4 no video, .pdf em slides e arte) e abre para o usuario. motor:\"hyperframes\" + html:\"<pasta>\" renderiza uma composicao HTML (index.html, GSAP/CSS/three.js) que voce escreveu; ela le midia/ do projeto.",
     "parameters": {
      "type": "object",
      "properties": {
@@ -2020,6 +2395,17 @@
       "paginas": {
        "type": "boolean",
        "description": "Forca paginas paradas"
+      },
+      "motor": {
+       "type": "string",
+       "enum": [
+        "remotion",
+        "hyperframes"
+       ]
+      },
+      "html": {
+       "type": "string",
+       "description": "hyperframes: a pasta com index.html"
       }
      },
      "required": [
@@ -2471,4 +2857,4 @@
    }
   }
  ]
-}
+}