diff --git a/.claude/skills/cenaforge/CHANGELOG.md b/.claude/skills/cenaforge/CHANGELOG.md index 3fbee5c..e64a954 100644 --- a/.claude/skills/cenaforge/CHANGELOG.md +++ b/.claude/skills/cenaforge/CHANGELOG.md @@ -7,6 +7,50 @@ Versão semântica da **skill** (não do projeto): Mantido pelo subagente `cenaforge-skill-updater`. Entradas mais novas no topo. +## 1.51.0 — 18/11/2026 + +IA: três provedores (Claude Code, Codex, Gemini CLI), login ou chave de API no cofre e IA reserva. +- `references/ai.md` (novo): onde mexer (`panel/src/lib/ai.ts`, `agents.ts`, `app/api/ai/`, `ai-settings.tsx`, + `clipper/app/ai_settings.py`, `judge.py`), regras (só o painel escreve `data/ai/`, chave só no ambiente da chamada, + quando a reserva troca), estado verificado. Contrato completo em `doc/ia.md`. +- `references/panel.md`: banco v10 (`agent_runs.fallback_of`); "Agentes e modelos" com 3 provedores, reserva e + Configurações em subpáginas (`SETTINGS_SECTIONS`). +- `references/clipper.md`: juiz com `gemini` e reserva por chamada; chave só pelo cofre do painel. +- `references/gotchas.md`: seção "IA" com 168–172 (OAuth do Gemini encerrado, `CODEX_API_KEY`, terminal de login no + Windows, custo da DPAPI, CLI fora do PATH). O 167 já era do perfil de jogo (1.50.0); numeração ajustada. +- `references/tools.md`: Gemini CLI como candidata (não instalada aqui, nunca executada); `--version` de Claude e Codex. +- `SKILL.md`: versão, `description`, esquema v10, linha "IA" em "Onde mexer", invariante da chave de API. +- Evidência (reexecutada): `claude` 2.1.314, `codex-cli` 0.169.0, `gemini` ausente; `ai.test.ts` 21/21; `pnpm test:clipper` + 335 passed. Informado, não reexecutado: painel 104/104, ida e volta do cofre. Não verificado: Gemini com chave, `@arquivo` + de imagem no juiz, envelope de erro do `-o json`, UI no navegador. + +## 1.50.0 — 18/11/2026 + +Clipador: perfis de jogo bilíngues, missões e gatilhos de fim, cadastro de jogo pelo painel, semente do GTA VI. +- `references/clipper.md`: banco em v12; seção "Perfil do jogo" reescrita (`profile` pt × `profileAi` en, aliases, + `missions`, `end_triggers`, rotas novas `POST/DELETE /v1/games`, `translate`, `PUT ?lang=`, seções novas do refine, + sementes, proxy/timeouts); linhas de "Onde mexer" e de páginas; evidência. +- `references/panel.md`: `/clipper/games` em lista + modal (`clipper-game-dialog.tsx`, `clipper-game-parts.tsx`); + ícones dos subitens da sidebar. +- `references/gotchas.md`: novo 167 (serviço sem reiniciar, `profileAi: null`, alias, missões não oficiais do GTA VI). +- `SKILL.md`: versão, `description` (perfil bilíngue, missões, cadastro de jogo) e faixa de itens do Clipador. +- Evidência: conferido em `clipper/app/main.py`, `db.py` (v12), `judge.py` (`mission_lines`), `intel.py`, + `panel/src/lib/clipper.ts` e `doc/clipador/JOGOS.md`; `pnpm test:clipper` → 335 passed (reexecutado). Não verificado: + IA real, UI no navegador, banco real em v12, `pnpm typecheck`. + +## 1.49.0 — 18/11/2026 + +Clipador: interface em subpáginas, parar à mão pausa o monitor, idioma por fonte/sessão/canal. +- `references/clipper.md`: banco em v11; linha "Páginas `/clipper/*`" reescrita (grupo `(studio)`, provider, shell, páginas); + linha nova de pausa do monitor e idioma em "Onde mexer"; seção "Parar é parar e idioma"; evidência. +- `references/panel.md`: seção `/clipper` reescrita (tabela rota, conteúdo, arquivos; `clipper-studio.tsx` apagado, + `clipper-queue.tsx` e `clipper-sessions.tsx` reduzidos); esquema do painel v9 (`accounts.language`, `languages.ts`). +- `references/gotchas.md`: novo 166 (fonte que não volta a gravar depois de parar à mão; rotas novas exigem reiniciar o Clipador). +- `SKILL.md`: versão, `description`, linhas de página e de armadilhas. +- Evidência: conferido em `doc/clipador/REDESIGN.md`, `clipper-shell.tsx` (`CLIPPER_SECTIONS`), `clipper/app/db.py` (v11), + `main.py` (`StopIn`, `check_language`), `panel/src/lib/db.ts` (v9) e `languages.ts`; `pnpm test:clipper` → 287 passed + (reexecutado). Não verificado: páginas no navegador, banco real em v11, `pnpm typecheck` e testes do painel. + ## 1.48.0 — 17/11/2026 Cartoon: acabamento de ilustração dos personagens (detalhe de rosto/corpo, acessórios, enquadramento e textura). diff --git a/.claude/skills/cenaforge/SKILL.md b/.claude/skills/cenaforge/SKILL.md index b1c2f3f..60edd4b 100644 --- a/.claude/skills/cenaforge/SKILL.md +++ b/.claude/skills/cenaforge/SKILL.md @@ -1,11 +1,11 @@ --- name: cenaforge -description: Produz e altera vídeos narrativos do projeto CenaForge — cena 3D (rua) ou do documentário (2D: título, contador, mapa do litoral de SP, `kind: "doc2d"`; 3D da biblioteca de cenas `godot/library/`, ex.: ilha com farol de dia/entardecer/noite, náufragos no costão, `kind: "doc3d"`; peças `godot/kits/`: pessoa articulada com poses e barco; cena dentro de outra) descrita por JSON, animada por tempo de cena na Godot, gravada pelo Movie Maker e convertida em MP4 pelo FFmpeg. Use sempre que o pedido envolver criar, renderizar ou ajustar um vídeo, episódio ou cena (câmera, movimento, cenário, personagem, moto, luz, texto e opções A/B, áudio, resolução), validar um MP4, gerar narração (TTS: Edge, Piper, Kokoro, Google, Azure Speech) ou escolher/filtrar voz, clonar voz a partir de uma gravação (Chatterbox, com consentimento), vozes de personagem (RVC/Applio) ou transcrição com tempos para legenda (.srt) pelo serviço de voz local ou pela página Vozes do painel, histórias interativas com vertentes e votação A–D, lineares ou documentais (vídeo único sobre fatos reais, com fontes) e onde ficam as regras de roteiro (doc/roteiro/), leitor de roteiro do painel (trechos, narração × duração alvo, fontes), criar cena 3D nova na biblioteca (`template.gd` + `manifest.json`, guia `doc/godot/cenas.md`, tarefa "Cena no Godot" do agente), montagem do vídeo documental em MP4 no painel ("Gerar vídeo automático" num clique: plano por regras, fotos reais do Wikimedia Commons, narração e cenas 2D/3D da Godot; "Gerar de novo" por trecho e "Refazer tudo do zero"; estilo "Tudo em 3D" com cartão de foto real por cima e cartões de informação em sequência; estilo "Cartoon" (desenho 2D em Remotion, pacote `cartoon/`: lugares montados por peças a partir do texto, sem cenário pronto; biblioteca de personagens criados uma vez e reaproveitados entre histórias — aba "Personagens", elenco por história, agente "character" —; paleta da série, etiquetas, onomatopeias e legenda palavra por palavra; personagem com rig de expressões e ações de movimento combináveis, fala sincronizada com a narração, acabamento de ilustração: formato de cabeça, nariz, pálpebra, rugas, acessórios de profissão, enquadramento close/medium e textura de papel); ou manual: áudio por trecho com números por extenso, visual por trecho — foto com fundo desfocado, animação 2D, cena 3D da biblioteca, clipe ou cartela —, texto na tela, legenda e créditos, pelo FFmpeg), excluir história no painel (vai para data/trash/), escolha de agente e modelo (Claude/Codex) no painel, mensagem ou correção ao agente durante a execução (Corrigir agora / Enviar ao terminar), termos episódio × vídeo na interface, contas e dashboard (métricas simuladas) do painel, Clipador (cortes automáticos de live da Twitch/Kick/YouTube, verticais 9:16 ou horizontais 16:9 para YouTube, com duração configurável e mínimo garantido, qualidade de gravação configurável até 2K: chat e emotes, heurística, varredura da IA, juízes analista e editor pela CLI, contexto do jogo e perfil do jogo editável/refinável pela IA, webcam achada sem IA e layout do corte, rastreio de reação do rosto do streamer (YuNet, MediaPipe, expressões que reforçam o corte), legenda com hashtags do canal, do jogo e do momento, editor de cortes em tela cheia no padrão de editor de vídeo, com timeline de uma trilha por camada e projeto de edição feito pela IA (trechos com layout próprio e trecho mudo, câmera inteira e editável na Fonte, legenda animada editável arrastando, gancho em tarja animada, fontes empacotadas, textos, zoom, reenquadramento do jogo com keyframes, camadas inseridas (recorte da tela em destaque), chat da live na tela, narração, música, capa também no início, export pelo FFmpeg), retomada de live que caiu, cortes duplicados descartados (o rejeitado ou apagado não volta), render que falha, fila de aprovação com apagar corte (um, selecionados ou a aba inteira), relógio da gravação e cadência do resumo no cartão da sessão, prévia do editor igual ao render (legenda e recorte), "não sai corte" (live fria × regras) e fontes ligadas aos canais de publicação), publicação automática em YouTube, TikTok e Instagram (serviço Publicador, canais de publicação, conectar rede pela API oficial ou sessão logada, aprovação manual ou automática, horários bons e limite por dia, botão "Publicar" no corte aprovado, inclusive sem fonte ligada e com "Horário específico" por rede, ordenar a fila de cortes, capa que sumiu do dashboard, fila "Publicações", Configurações, job que falhou, pede login ou pede "Confira na rede", "Já saiu: informar o link" quando o vídeo foi ao ar mas o job falhou, YouTube Studio que "não confirmou" a publicação, hashtag do TikTok que não vira hashtag (legenda colada), botão "Publicar no " nos cartões de Publicações), números dos posts (views, curtidas, comentários) lidos das redes e mostrados no Dashboard (leitura automática a cada N horas, "Atualizar números agora"), chamar a API do painel por script (cabeçalhos `Origin` e JSON; criar história com agente por `POST /api/stories`), agente que parou no limite de uso ou morreu ao reiniciar o painel, instalar/subir o projeto (setup.bat, start.bat, pnpm dev), ou trocar/adicionar ferramentas de 3D, voz ou render neste repositório — mesmo que o usuário não diga "skill" nem "CenaForge". +description: Produz e altera vídeos narrativos do projeto CenaForge — cena 3D (rua) ou do documentário (2D: título, contador, mapa do litoral de SP, `kind: "doc2d"`; 3D da biblioteca de cenas `godot/library/`, ex.: ilha com farol de dia/entardecer/noite, náufragos no costão, `kind: "doc3d"`; peças `godot/kits/`: pessoa articulada com poses e barco; cena dentro de outra) descrita por JSON, animada por tempo de cena na Godot, gravada pelo Movie Maker e convertida em MP4 pelo FFmpeg. Use sempre que o pedido envolver criar, renderizar ou ajustar um vídeo, episódio ou cena (câmera, movimento, cenário, personagem, moto, luz, texto e opções A/B, áudio, resolução), validar um MP4, gerar narração (TTS: Edge, Piper, Kokoro, Google, Azure Speech) ou escolher/filtrar voz, clonar voz a partir de uma gravação (Chatterbox, com consentimento), vozes de personagem (RVC/Applio) ou transcrição com tempos para legenda (.srt) pelo serviço de voz local ou pela página Vozes do painel, histórias interativas com vertentes e votação A–D, lineares ou documentais (vídeo único sobre fatos reais, com fontes) e onde ficam as regras de roteiro (doc/roteiro/), leitor de roteiro do painel (trechos, narração × duração alvo, fontes), criar cena 3D nova na biblioteca (`template.gd` + `manifest.json`, guia `doc/godot/cenas.md`, tarefa "Cena no Godot" do agente), montagem do vídeo documental em MP4 no painel ("Gerar vídeo automático" num clique: plano por regras, fotos reais do Wikimedia Commons, narração e cenas 2D/3D da Godot; "Gerar de novo" por trecho e "Refazer tudo do zero"; estilo "Tudo em 3D" com cartão de foto real por cima e cartões de informação em sequência; estilo "Cartoon" (desenho 2D em Remotion, pacote `cartoon/`: lugares montados por peças a partir do texto, sem cenário pronto; biblioteca de personagens criados uma vez e reaproveitados entre histórias — aba "Personagens", elenco por história, agente "character" —; paleta da série, etiquetas, onomatopeias e legenda palavra por palavra; personagem com rig de expressões e ações de movimento combináveis, fala sincronizada com a narração, acabamento de ilustração: formato de cabeça, nariz, pálpebra, rugas, acessórios de profissão, enquadramento close/medium e textura de papel); ou manual: áudio por trecho com números por extenso, visual por trecho — foto com fundo desfocado, animação 2D, cena 3D da biblioteca, clipe ou cartela —, texto na tela, legenda e créditos, pelo FFmpeg), excluir história no painel (vai para data/trash/), escolha de agente e modelo (Claude Code, Codex ou Gemini CLI) no painel, IA (provedores, entrar com a conta ou chave de API no cofre, ordem e IA reserva quando uma cai por cota/login/rede, Configurações em subpáginas), mensagem ou correção ao agente durante a execução (Corrigir agora / Enviar ao terminar), termos episódio × vídeo na interface, contas e dashboard (métricas simuladas) do painel, Clipador (cortes automáticos de live da Twitch/Kick/YouTube, verticais 9:16 ou horizontais 16:9 para YouTube, com duração configurável e mínimo garantido, qualidade de gravação configurável até 2K: chat e emotes, heurística, varredura da IA, juízes analista e editor pela CLI, contexto do jogo e perfil do jogo bilíngue (português para ler, inglês para a IA) editável/refinável pela IA, com missões, gatilhos de fim de missão e outros nomes (aliases), cadastro e apagar jogo pelo painel, tradução do perfil e semente do GTA VI, webcam achada sem IA e layout do corte, rastreio de reação do rosto do streamer (YuNet, MediaPipe, expressões que reforçam o corte), legenda com hashtags do canal, do jogo e do momento, editor de cortes em tela cheia no padrão de editor de vídeo, com timeline de uma trilha por camada e projeto de edição feito pela IA (trechos com layout próprio e trecho mudo, câmera inteira e editável na Fonte, legenda animada editável arrastando, gancho em tarja animada, fontes empacotadas, textos, zoom, reenquadramento do jogo com keyframes, camadas inseridas (recorte da tela em destaque), chat da live na tela, narração, música, capa também no início, export pelo FFmpeg), interface em subpáginas (Cortes com modal, Sessões, Fontes, Jogos, Ajustes), parar a sessão à mão (pausa o monitor da fonte, "Religar"), idioma da fonte, da sessão e do canal de publicação (en-US, es-419), retomada de live que caiu, cortes duplicados descartados (o rejeitado ou apagado não volta), render que falha, fila de aprovação com apagar corte (um, selecionados ou a aba inteira), relógio da gravação e cadência do resumo no cartão da sessão, prévia do editor igual ao render (legenda e recorte), "não sai corte" (live fria × regras) e fontes ligadas aos canais de publicação), publicação automática em YouTube, TikTok e Instagram (serviço Publicador, canais de publicação, conectar rede pela API oficial ou sessão logada, aprovação manual ou automática, horários bons e limite por dia, botão "Publicar" no corte aprovado, inclusive sem fonte ligada e com "Horário específico" por rede, ordenar a fila de cortes, capa que sumiu do dashboard, fila "Publicações", Configurações, job que falhou, pede login ou pede "Confira na rede", "Já saiu: informar o link" quando o vídeo foi ao ar mas o job falhou, YouTube Studio que "não confirmou" a publicação, hashtag do TikTok que não vira hashtag (legenda colada), botão "Publicar no " nos cartões de Publicações), números dos posts (views, curtidas, comentários) lidos das redes e mostrados no Dashboard (leitura automática a cada N horas, "Atualizar números agora"), chamar a API do painel por script (cabeçalhos `Origin` e JSON; criar história com agente por `POST /api/stories`), agente que parou no limite de uso ou morreu ao reiniciar o painel, instalar/subir o projeto (setup.bat, start.bat, pnpm dev), ou trocar/adicionar ferramentas de 3D, voz ou render neste repositório — mesmo que o usuário não diga "skill" nem "CenaForge". --- # CenaForge — vídeo a partir de cena descrita por JSON -**Versão da skill: 1.48.0** (17/11/2026) — histórico em [CHANGELOG.md](CHANGELOG.md). +**Versão da skill: 1.51.0** (18/11/2026) — histórico em [CHANGELOG.md](CHANGELOG.md). Mantida pelo subagente `cenaforge-skill-updater` (ver "Manutenção" no fim). ## Regra zero @@ -59,7 +59,7 @@ outra, teste olhando o `inspect/`); detalhes em [references/panel.md](references | Opções do episódio (A–D) | `stories//.choices.json` | | Cena do episódio | `config/-.json` (ex.: `new_scene.py --id -ep02`) | | Assets da história / biblioteca | `stories//assets///` · `assets/library///` (cada um com `asset.json`) | -| Estado (episódios, vertentes, votos, canais de publicação, fila de publicação, métricas, execuções) | `data/cenaforge.db` (esquema v8; backup antes de migrar em `data/backups/`), gerido pelo painel (`panel/`, http://127.0.0.1:4500) — detalhes em [references/panel.md](references/panel.md) | +| Estado (episódios, vertentes, votos, canais de publicação, fila de publicação, métricas, execuções) | `data/cenaforge.db` (esquema v10; backup antes de migrar em `data/backups/`), gerido pelo painel (`panel/`, http://127.0.0.1:4500) — detalhes em [references/panel.md](references/panel.md) | | Serviço de voz | `voice/` (http://127.0.0.1:4510); clonagem em `voice/clone/worker.py` (127.0.0.1:4511, venv `voice/.venv-clone`); pesos e estado em `data/voice/` | | Clipador (cortes de live) | `clipper/` (http://127.0.0.1:4520); banco e blocos em `data/clipper/`, cortes em `output/clipper//` — ver [references/clipper.md](references/clipper.md) | | Publicador (envio às redes) | `publisher/` (http://127.0.0.1:4530); dados em `data/publisher/` — ver [references/publishing.md](references/publishing.md) | @@ -113,10 +113,11 @@ Interativa = 2–4 vertentes, mas o overlay só desenha `choiceA`/`choiceB`. Tab | Publicação nas redes (Publicador, despachante, canais de publicação, fila, Configurações) | `publisher/app/` · `panel/src/lib/` (`publisher.ts`, `publishing.ts`, `publishing-rules.ts`, `dispatcher.ts`, `settings.ts`) · `panel/src/instrumentation.ts` · botão "Publicar" do corte `components/clip-publish.tsx` · números dos posts: `publisher/app/platforms/stats.py` + `session/stats.py`, `panel/src/lib/metrics-sync.ts`, `metrics.ts`, `components/metrics-view.tsx`, `dashboard-controls.tsx` — tabela em [references/publishing.md](references/publishing.md) | `publisher/tests/` (`test_stats.py`), `panel/src/lib/publishing-*.test.ts`, `doc/publicacao/PLANO.md` se mudar o contrato | | Localizar executáveis / encoders | `scripts/lib/tools.ts` | [references/tools.md](references/tools.md) | | Painel: páginas, API, votação, agentes (prompt por provedor, lista de modelos `models()`, mensagem durante a execução `sendFollowUp`) | `panel/src/app/`, `panel/src/lib/` (`agents.ts`, `prompts.ts`, `decisions.ts`, `assets.ts`, `renders.ts`); console em `components/agent-console.tsx` | `panel/README.md`; `AGENTS.md` se mudar regra do Codex | +| IA: provedores (Claude/Codex/Gemini), login ou chave, cofre, IA reserva, Configurações → IA | `panel/src/lib/ai.ts` (+ `agents.ts`, `app/api/ai/`), `components/ai-settings.tsx`, `settings-shell.tsx`; juiz: `clipper/app/ai_settings.py`, `judge.py` — contrato `doc/ia.md`, resumo em [references/ai.md](references/ai.md) | `panel/src/lib/ai.test.ts`, `clipper/tests/test_ai_fallback.py` | | Painel: página Vozes (`/voices`) | servidor `panel/src/lib/voice.ts` + `panel/src/app/api/voice/*`; cliente `panel/src/components/voice-*.ts(x)` (`voice-client.ts` tipos e `uploadWithProgress`; `voice-cards.tsx` catálogo e filtros; `voice-clone-form.tsx`; `AzureForm` em `voice-studio.tsx`) | `voice/README.md` se mudar o contrato; largura de `Select`/`Input`: gotchas item 62 | | Regra de roteiro (idioma, overlay, ficção, documental, formato de `biblia.md`/`epNN.md`) | `doc/roteiro/comum.md`, `ficcao.md`, `documental.md` | nada no código; `.claude/agents/cenaforge-story-writer.md` só aponta para lá | | Painel: vertentes, votação A–D, contas, dashboard, excluir história (`deleteStory`), migração do banco | `branches.ts`, `decisions.ts`, `flow.ts`, `accounts.ts`, `metrics.ts`, `stories.ts`, `db.ts` em `panel/src/lib/` — ver [references/panel.md](references/panel.md) | `panel/README.md` | -| Clipador: captura e qualidade de gravação (`capture.py`), retomada de live, chat/emotes, heurística, duplicados, varredura, juízes, jogo, formato (vertical/horizontal), duração mínima (`fit_window`), layout/webcam, rastreio de reação (rosto), legenda, gancho/tarja e fontes (`assets/fonts/`), reenquadramento e camadas inseridas (`reframe.py`), render, apagar cortes (`clip_delete.py`, tabela `deleted_clips`), editor de cortes, página `/clipper`, canais nas contas | `clipper/app/` · `panel/src/lib/clipper.ts` (regex `ALLOWED`, métodos `METHODS` + timeout por rota) · `panel/src/components/clipper-*.tsx` e `clip-editor*.ts(x)` — tabela em [references/clipper.md](references/clipper.md) | `clipper/tests/`, `clipper/README.md`; peso novo em `clipper/models.lock.json` (URL imutável + sha256) | +| Clipador: captura e qualidade de gravação (`capture.py`), retomada de live, chat/emotes, heurística, duplicados, varredura, juízes, jogo, formato (vertical/horizontal), duração mínima (`fit_window`), layout/webcam, rastreio de reação (rosto), legenda, gancho/tarja e fontes (`assets/fonts/`), reenquadramento e camadas inseridas (`reframe.py`), render, apagar cortes (`clip_delete.py`, tabela `deleted_clips`), editor de cortes, páginas `/clipper/*` (grupo `(studio)`), pausa do monitor e idioma, canais nas contas | `clipper/app/` · `panel/src/lib/clipper.ts` (regex `ALLOWED`, métodos `METHODS` + timeout por rota) · `panel/src/components/clipper-*.tsx` (moldura `clipper-shell.tsx`, páginas em `panel/src/app/clipper/(studio)/`) e `clip-editor*.ts(x)` — tabela em [references/clipper.md](references/clipper.md) | `clipper/tests/`, `clipper/README.md`; peso novo em `clipper/models.lock.json` (URL imutável + sha256) | | Hashtags da legenda do corte (canal, jogo, momento) | `clipper/app/hashtags.py` (+ `judge.py`, `intel.py`, `worker.py`; painel `clipper-games.tsx`) — ver [references/clipper.md](references/clipper.md) | `clipper/tests/test_hashtags.py` | | Painel: leitor de roteiro (trechos, narração, fontes; página `/stories/[storyId]/episodes/[number]/roteiro`) | parser puro `panel/src/lib/script-doc.ts` (`parseScript`, `WORDS_PER_SECOND`) + `panel/src/components/script-reader.tsx` — ver [references/panel.md](references/panel.md) | formato do roteiro em `doc/roteiro/` (cabeçalho da tabela de trechos) | | Painel: montagem documental (um clique ou manual; estilo `mixed`/`3d`/`cartoon`; áudio, visual e cartão de foto por trecho → MP4) | estado/banco/modo automático/"Gerar de novo" `panel/src/lib/montage.ts`; FFmpeg **sem banco** `montage-ffmpeg.ts` (cartão, textos em sequência); plano do trecho (`planShot`, `planShot3d`) e render Godot **sem banco** `montage-godot.ts`; biblioteca `scene-library.ts`; fotos `image-search.ts`; fala por extenso `speech-text.ts`; UI `components/montage-editor.tsx`; rotas `app/api/episodes/[id]/montage/` — ver [references/panel.md](references/panel.md#montagem-documental) | `doc/roteiro/comum.md` e `documental.md` se mudar regra de narração/trecho | @@ -144,6 +145,8 @@ Interativa = 2–4 vertentes, mas o overlay só desenha `choiceA`/`choiceB`. Tab - **Subprocesso sem shell**, argumentos em lista; código ≠ 0, timeout ou cancelamento é falha. - **JSON nunca vira código**; campos desconhecidos são rejeitados. - **Identificadores em inglês; comentários, mensagens e textos de UI em português.** +- **Chave de API das IAs** só pelo cofre do painel (`data/ai/vault.bin`, DPAPI) e só no ambiente da chamada; nunca em + arquivo, log, prompt ou nesta skill; não troque o login global das CLIs (sem `codex login --with-api-key`). - **Publicação:** nunca marque `published` sem ID/URL remota; nada sai sem aprovação (humana ou automática ligada pelo usuário); modo sessão só com o usuário logando à mão — sem stealth, captcha ou senha automatizada. Agente não dispara envio real sem pedido do usuário: para testar, use as suítes (sem rede). Regras em [references/publishing.md](references/publishing.md). @@ -218,11 +221,11 @@ serviço de voz, Clipador, publicação ou Cartoon. As que mais custam caro: - 1º quadro da Godot sai incompleto (aquecimento de 3 quadros); `delta` não é 1/fps; resolução fixada na inicialização (`override.cfg`); `--write-movie` relativo falha em silêncio com código 0. - Regex em `node -e`/heredoc/Python sem string raw perde ou corrompe `\` e `` (itens 44 e 162): edite pelo Edit. -- Reiniciar o `pnpm panel` mata o agente em execução; limite de uso do Claude/Codex para a tarefa — continue no outro - provedor (131–135). +- Reiniciar o `pnpm panel` mata o agente em execução; limite de uso: a IA reserva recomeça a tarefa sozinha; sem ela, + continue à mão no outro provedor (131–135, 168–172; [references/ai.md](references/ai.md)). - **Correção que "não pegou" = serviço Python rodando código antigo (sem `--reload`): compare o início do processo com o `LastWriteTime` do arquivo antes de validar (143).** -- Publicação/modo sessão (137–155, 158–159), Cartoon (156, 157, 160–165) e Clipador (144): ver o item citado em gotchas. +- IA, login e chave (168–172). Publicação/modo sessão (137–155, 158–159), Cartoon (156, 157, 160–165) e Clipador (144, 166, 167): ver o item citado em gotchas. ## Manutenção desta skill diff --git a/.claude/skills/cenaforge/references/ai.md b/.claude/skills/cenaforge/references/ai.md new file mode 100644 index 0000000..f08cb1e --- /dev/null +++ b/.claude/skills/cenaforge/references/ai.md @@ -0,0 +1,44 @@ +# IA: três provedores, login/chave e IA reserva + +Fonte do contrato: **`doc/ia.md`** (arquivos, ambiente de cada chamada, o que conta como indisponível, Gemini +headless). Não duplique aqui; este arquivo diz onde mexer e o que não quebrar. Sempre pela **CLI oficial** +(`claude`, `codex`, `gemini`), nunca SDK/HTTP direto. + +## Onde mexer + +| Mudança | Arquivo(s) | Também atualizar | +|---|---|---| +| Configurações, cofre, detecção, instalação, login, teste, `providerEnv`, `isAvailabilityError`, pausa, `readyChain`/`nextFallback` | `panel/src/lib/ai.ts` | `panel/src/lib/ai.test.ts`, `doc/ia.md` | +| Agente do painel por provedor (`geminiArgs`, `normalizeGemini`, `--resume`, shell liberado), troca de IA ao cair | `panel/src/lib/agents.ts` (`prompts.ts`, `types.ts` para `AgentProvider`) | `ai.test.ts` (argumentos e eventos do Gemini) | +| Execução que continua outra que caiu | coluna `agent_runs.fallback_of` (migração v10 em `panel/src/lib/db.ts`), `followUpRunOf` (segue `resume_of` **e** `fallback_of`) | `publishing-db.test.ts` (conta de migrações) | +| API | `panel/src/app/api/ai/route.ts` (`GET/PUT /api/ai`), `.../ai/[provider]/route.ts` (`POST {action: install\|login\|verify\|test\|resume}`, `PUT/DELETE` = chave) | guarda `Origin`/JSON (gotchas, item 125) | +| Tela | `panel/src/components/ai-settings.tsx` em `panel/src/app/settings/ai/page.tsx`; seletor de provedor em `agent-console.tsx` e `story-composer.tsx` | — | +| Subpáginas de Configurações | `panel/src/app/settings/{ai,publishing,apps,browser,modes}/page.tsx` + `layout.tsx`; seções em `SETTINGS_SECTIONS` de `components/settings-shell.tsx` (o menu lateral `sidebar-nav.tsx` as lê como `children`); `/settings` redireciona para `/settings/ai` | seção nova = entrada em `SETTINGS_SECTIONS` + pasta | +| Juiz do Clipador (3 provedores, reserva por chamada) | `clipper/app/judge.py` (`_gemini`, `find_gemini`, `parse_gemini_output`), leitura de settings e cofre `clipper/app/ai_settings.py` (DPAPI por `ctypes`), `main.py`, `config.py`, `intel.py` | `clipper/tests/test_ai_fallback.py`, `conftest.py`, `clipper/README.md` | + +## Regras + +- **Só o painel escreve** `data/ai/settings.json` e `data/ai/vault.bin`; o Clipador só lê (relê por `mtime`). Cofre = + DPAPI `CurrentUser`, entropia `CenaForge.AI.vault.v1`; a chave nunca volta à tela (só "existe" + 4 últimos + caracteres). Nunca copie chave para skill, log ou prompt. +- Chave de API entra **só no ambiente da chamada** (`providerEnv`); não troque o login global da CLI. +- **Reserva:** erro de indisponibilidade (cota, 429, login, chave, rede, CLI fora, tempo) → a IA entra em pausa + (`cooldownMin`, em memória por processo) e a **mesma tarefa recomeça** na próxima IA pronta de `order`. Erro de + conteúdo (JSON/schema inválido) **não** troca. O juiz faz o mesmo por chamada. +- Gemini no agente: `-o stream-json --approval-mode auto_edit --skip-trust`, `--resume `, shell só os comandos de + `GEMINI_ALLOWED_SHELL` via `--allowed-tools run_shell_command(...)`. No juiz: `-o json --approval-mode plan`, prompt + pelo stdin, frames copiados para pasta temporária **fora do repo** (`@arquivo` respeita o `.gitignore`). +- Status de login: `claude auth status --json` (`loggedIn`, `authMethod`, `subscriptionType`); `codex login status` + (texto, "Logged in using ChatGPT"). +- Instalação: Claude pelo instalador nativo (`irm https://claude.ai/install.ps1 | iex`); Codex e Gemini por + `npm install -g`. O painel procura também em `~/.local/bin` e `%APPDATA%\npm`. + +## Estado verificado (18/11/2026) + +- Nesta máquina: `claude` 2.1.314 e `codex` 0.169.0 (`--version` reconferido pela skill); `gemini` **não instalado** + (`command not found`). +- `pnpm --filter cenaforge-panel test:panel` inclui `ai.test.ts`: 21 testes, 21 passaram (reexecutado pela skill; um + usa a DPAPI real). Clipador: `pnpm test:clipper` → 335 passed (reexecutado). Suíte do painel 104/104: informada. + Ida e volta real do cofre painel → Clipador: informada, não repetida. +- **Não verificado:** Gemini com chave real, `@arquivo` de imagem no juiz, envelope de erro do `-o json`, a UI + `/settings/ai` no navegador, troca de IA no meio de um agente real. Armadilhas: gotchas, itens 168–172. diff --git a/.claude/skills/cenaforge/references/clipper.md b/.claude/skills/cenaforge/references/clipper.md index 32b649a..394c243 100644 --- a/.claude/skills/cenaforge/references/clipper.md +++ b/.claude/skills/cenaforge/references/clipper.md @@ -12,7 +12,7 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You | O quê | Onde | |---|---| -| Banco do Clipador | `data/clipper/clipper.db` (`PRAGMA user_version` 10, `SCHEMA` em `clipper/app/db.py`: v1 tabelas, v2 `settings`, v3 jogo/varredura/emotes/configuração do corte — colunas novas em `sessions`, `channels.settings_json`, `chat.emotes`, `clips.learned`, tabelas `games` e `emotes`; v4 `edits` (`clip_id`, `project_json`, `rev`, `cover`, `exported_at`, `created_at`, `updated_at`); v5 `face_track`; v6 `games.notes_json`/`games.edited_at`; v7 `edits.origin` (`ai`/`user`) + `edits.ai_project_json`; v8 `clips.aspect` (`vertical`/`horizontal`, padrão `vertical`, gravado no render); v9 `sessions.capture_json` (o que a captura gravou de fato; sessões antigas `NULL`); v10 tabela `deleted_clips` (marca do corte apagado, `ON DELETE CASCADE` com a sessão)). Migra ao subir o serviço. **Nunca altere uma migração já aplicada** (o banco real estava em v4 quando a v7 nasceu): coluna nova = `ALTER` numa versão nova | +| Banco do Clipador | `data/clipper/clipper.db` (`PRAGMA user_version` 12, `SCHEMA` em `clipper/app/db.py`: v1 tabelas, v2 `settings`, v3 jogo/varredura/emotes/configuração do corte — colunas novas em `sessions`, `channels.settings_json`, `chat.emotes`, `clips.learned`, tabelas `games` e `emotes`; v4 `edits` (`clip_id`, `project_json`, `rev`, `cover`, `exported_at`, `created_at`, `updated_at`); v5 `face_track`; v6 `games.notes_json`/`games.edited_at`; v7 `edits.origin` (`ai`/`user`) + `edits.ai_project_json`; v8 `clips.aspect` (`vertical`/`horizontal`, padrão `vertical`, gravado no render); v9 `sessions.capture_json` (o que a captura gravou de fato; sessões antigas `NULL`); v10 tabela `deleted_clips` (marca do corte apagado, `ON DELETE CASCADE` com a sessão); v11 `channels.monitor_paused_at`/`monitor_paused_session`/`language` e `sessions.language`, padrão `''` = `CLIPPER_LANGUAGE`; v12 `games.profile_ai_json` (perfil em inglês), `translated_at`, `aliases_json`). Migra ao subir o serviço. **Nunca altere uma migração já aplicada** (o banco real estava em v4 quando a v7 nasceu): coluna nova = `ALTER` numa versão nova | | Blocos gravados (`.ts` de 30 s + `segments.csv`) e frames | `data/clipper/sessions//` (frames em `frames/`) | | Pesos do rastreio de reação (YuNet, MediaPipe, OpenSeeFace) | `data/clipper/models/`, fixados (URL imutável + sha256) em `clipper/models.lock.json` | | Cortes prontos | `output/clipper//clip-.mp4` + `clip-.jpg` | @@ -29,12 +29,13 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You | Busca de quadro dentro de bloco `.ts` (`seek_args`, `grab_frame`) e emenda de resolução/codec (`uniform_segments`) | `clipper/app/media.py`; `clipper/app/editor_render.py`; `face.grab_bgr` e tamanho do quadro por bloco (`_frame_size`) em `face.py` | gotchas, itens 107–108 | | Retomada de live (`Engine.live_check`, `keep_live`, `RESUME_DELAYS_S`, `resume_interrupted`), render que falha (`recover_orphan_renders`, `ORPHAN_RENDER_S` 300, `MAX_RENDER_ATTEMPTS` 3), cortes duplicados (`SAME_PEAK_S` 10, `SAME_MOMENT_OVERLAP` 0,6, `KEPT_STATUSES`/`VETO_STATUSES`, `discard_pending_duplicates`) | `clipper/app/worker.py` | `clipper/tests/test_resume.py`, `clipper/tests/test_render_and_duplicates.py` | | Apagar cortes (`delete_clip`, `delete_many`, `select_ids`, `MAX_BATCH` 500, recusas `BUSY`/`PUBLISHED`/`CHANGED`, marca `marks`/`mark_spans`, arquivos só dentro das pastas do Clipador) | `clipper/app/clip_delete.py`; rotas em `main.py` (`ClipsDeleteIn`); marca lida em `worker.py` (veto depois do juiz) e na varredura (`intel.py`) | `clipper/tests/test_clip_delete.py`; `METHODS` em `panel/src/lib/clipper.ts`; seção "Apagar cortes" abaixo | +| Parar à mão e pausa do monitor (`Engine.stop_session(id, pause_monitor=True)`, `StopIn.pauseMonitor`), idioma por fonte/sessão (`check_language`, visões de fonte/sessão/corte com `language` resolvido; Whisper e `judge.output_language_note`) | `clipper/app/worker.py`, `main.py`, `db.py` (v11), `judge.py`; painel `ACCOUNT_LANGUAGES` em `panel/src/lib/languages.ts` | `clipper/tests/test_monitor_pause_and_language.py` (9); seção "Parar é parar e idioma" abaixo | | Chat (IRC anônimo da Twitch com `CAP REQ :twitch.tv/tags` → emotes nativos e `room-id`; Pusher da Kick, emotes `[emote:id:NOME]`) | `clipper/app/chat.py` | — | | Heurística: pesos, base de 3 min, mínimo proporcional (`_required_messages`), reações (`min_reactions`), chat fraco (`sparse_rate` 0,5 msg/s), momentos do chat/áudio/rosto (`_chat_moments`/`_audio_moments`/`_face_moments`; `face_*` em `Params`), `pick_peaks`, `fit_window` (duração de todo corte automático) | `Params` e funções em `clipper/app/scoring.py`; alvo `min_target` em `layout.py` | `clipper/tests/test_scoring.py` (regressões de falso positivo, chat fraco e rosto), `test_duration_banner_fonts.py` | | Rastreio de reação — E/S: backends (MediaPipe; plano B OpenSeeFace), download sob demanda com sha256, recorte FFmpeg 6 qps, laço `face` | `clipper/app/face.py` (`for_scoring`, `must_wait`, `view`, `reset`); laço `_face_loop` e uso de `must_wait` na decisão do corte em `worker.py`; bancada `clipper/tools/face_bench.py` | `clipper/tests/test_face.py`, `clipper/models.lock.json`, `doc/FACE_BAKEOFF.md` | | Rastreio de reação — lógica pura: sinal por segundo contra o neutro do streamer, rótulos, `reaction_moments`, `summarize` (linha do analista), `locate_cam` (câmera pelo rosto) | `ReactionParams` e funções em `clipper/app/reaction.py` | `clipper/tests/test_reaction.py` | | Emotes: catálogo 7TV/BTTV/FFZ (canal + global, TTL 1 h, fonte que falha é ignorada), emojis, peso aprendido (`LEARN_UP`/`LEARN_DOWN` 0,3/0,15) | `clipper/app/emotes.py`; ingestão e aprendizado em `clipper/app/intel.py` (`ingest_chat`, `learn_from_clip`) | `clipper/tests/test_intel.py` | -| Contexto do jogo (categoria a cada `GAME_CHECK_S` 600, `screen_game`, perfil pela web; `clean_profile`, `save_profile`, `refine`, `delete_note`), varredura (`SCAN_*`), webcam (`detect_cam`: YuNet local primeiro, IA só se não achar ou `use_ai`; `CAM_RETRY_S` 300), opções `OPTION_DEFAULTS` (inclui `faceTrack`) | `clipper/app/intel.py` | README do Clipador | +| Contexto do jogo (categoria a cada `GAME_CHECK_S` 600, `screen_game`, perfil pela web; `clean_profile`, `save_profile`, `refine`, `delete_note`; perfis bilíngues, `add_game`, `delete_game`, `translate`, aliases, `import_seeds` de `clipper/app/seeds/games/*.json`; contrato em `doc/clipador/JOGOS.md`), varredura (`SCAN_*`), webcam (`detect_cam`: YuNet local primeiro, IA só se não achar ou `use_ai`; `CAM_RETRY_S` 300), opções `OPTION_DEFAULTS` (inclui `faceTrack`) | `clipper/app/intel.py` | README do Clipador | | Juízes (analista + editor), prompts, glossário `CHAT_GLOSSARY`, linha "Rosto do streamer: …" do analista, schemas, chamada da CLI, pesquisa e refino do jogo (`PROFILE_SYSTEM`/`research_game`, `REFINE_SYSTEM`/`refine_game`), câmera | `clipper/app/judge.py`; montagem dos 6 frames do analista (8 se o trecho passa de 80 s) em `worker.py` | README do Clipador | | Hashtags da legenda (`to_tag`, `fold`, `split_hashtags`, `compose`, `build_caption`; `MAX_TAGS` 8, `GAME_TAGS` 3, `MOMENT_TAGS` 4) | `clipper/app/hashtags.py`; uso em `judge_clip` de `worker.py`; campo `hashtags` em `judge.py` (`VERDICT_SCHEMA`, `PROFILE_SCHEMA`, `Verdict.hashtags`) e `PROFILE_LISTS`/`clean_profile`/`Intel.session_game` em `intel.py` — ver "Hashtags da legenda" abaixo | `clipper/tests/test_hashtags.py` | | Configuração do corte: camadas padrão ← canal ← sessão ← projeto (`DEFAULTS`, `merge`, `validate`), `format.aspect` (`ASPECTS`, `FRAME_SIZES`, `CANVAS_SIZES`, `aspect()`), `MODES` (5 modos, inclui `cam_only`), `resolved_mode` (queda para `blur` sem câmera; `full` no horizontal), retângulos, legenda, crédito, `duration` (`min_target`), `hook` (`HOOK_STYLES`, `HOOK_ANIMS`, `HOOK_FONT`), `capture`; fontes empacotadas (`PACKAGED_FONTS`, `font_files`, `ass_filter` = `ass=` com `fontsdir` só se o ASS usar uma delas); cadeia de layout reutilizável `layout_chain(settings, src, dst, tail, suffix, mode)` (usada por `video_filter` e pelo editor) | `clipper/app/layout.py`; rotas de settings em `main.py` (devolvem `aspects`, `frames`, `fontFiles`, `hookStyles`, `hookAnims` e `captureQualities`) | `clipper/tests/test_format_and_captions.py` (o vertical precisa continuar batendo com `clipper/tests/data/vertical_golden_sha256.json`); modo novo também em `LayoutMode`/`MODE_LABEL` de `panel/src/components/clipper-client.ts` e `resolvedMode` de `clip-editor-model.ts`; grupo novo também em `CutSettings` (`Aspect`, `aspectOf`, `withFormat` para serviço antigo) | @@ -45,7 +46,7 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You | Legenda (tempo saneado: `clean_words`, `group_words`, `caption_blocks`; `build_ass`) e crédito — usada pelo render do editor e pelo worker, nos dois formatos | `clipper/app/subtitles.py` (`MIN_WORD_S` 0,06, `MIN_STEP_S` 0,04). `media.render_vertical` ainda existe em `media.py`, mas **não** é mais usado pelo render de cortes | `clipper/tests/test_format_and_captions.py`; [gotchas.md](gotchas.md) itens 57–58, 70, 90 | | Rotas HTTP | `clipper/app/main.py` (editor: `editor_api.py`) | `ALLOWED` em `panel/src/lib/clipper.ts` (o proxy recusa caminho fora da regex) e o timeout por rota no mesmo arquivo | | Variáveis do `.env` | `clipper/app/config.py` + `clipper/.env.example` | tabela do README do Clipador | -| Página `/clipper` | `panel/src/app/clipper/page.tsx`, `panel/src/components/clipper-*.tsx` (`clipper-cut-settings.tsx` modal do corte em 5 abas, com Gancho e "Qualidade da gravação"; `clipper-games.tsx` aba Jogos e emotes (editar perfil, pedir à IA, pedidos guardados); `clipper-queue.tsx` cartão com a análise, reação do rosto (`FaceSignal`, `FACE_LABEL`), recuo do início `START_STEPS`, botão "Editar"/"Continuar edição", "Apagar" e seleção discreta (`SelectionPill`); `clipper-judge.tsx` interruptor "Rastrear a reação do streamer"; `clipper-sessions.tsx` cartão da sessão (`sessionHealth`, selo de quem achou a câmera, relógio `RecordingClock`, cadência `SummaryCadence`) e cabeçalho em `clipper-studio.tsx`), cliente `clipper-client.ts` | [panel.md](panel.md) | +| Páginas `/clipper/*` (grupo de rotas `panel/src/app/clipper/(studio)/`, layout com `ClipperProvider` + `ClipperShell`) | `clipper-provider.tsx` (dados + consulta periódica, `useClipper()`), `clipper-shell.tsx` (`CLIPPER_SECTIONS`, cabeçalho, bloco "Ao vivo agora · N"), páginas `clipper-clips-page.tsx` (+ `clipper-clip-table.tsx` `ClipTable`, `clipper-clip-dialog.tsx` `ClipDialog`, `clipper-clip-parts.tsx`), `clipper-sessions-page.tsx`, `clipper-session-detail.tsx`, `clipper-channels.tsx` (Fontes), `clipper-games-page.tsx` + `clipper-game-dialog.tsx` + `clipper-game-parts.tsx` + `clipper-games.tsx` (emotes), `clipper-settings-page.tsx`; peças compartilhadas em `clipper-sessions.tsx` (`PlatformIcon`, `CutNow`, `RecordForm`, relógio, `sessionHealth`) e utilitários da lista em `clipper-queue.tsx`; `clipper-cut-settings.tsx` modal do corte em 5 abas; `clipper-judge.tsx`; cliente `clipper-client.ts`. Mapa de rotas e papéis em [panel.md](panel.md#página-clipper-clipador) | [panel.md](panel.md) | | Página do editor `/clipper/edit/[clipId]` | `panel/src/app/clipper/edit/[clipId]/page.tsx` + `panel/src/components/clip-editor*.ts(x)` (papel de cada arquivo em [panel.md](panel.md#editor-de-cortes)); tokens `--color-nle-*` e bloco `.nle` em `panel/src/app/globals.css` | [panel.md](panel.md#editor-de-cortes) | | Ponte e proxy do painel | `panel/src/lib/clipper.ts` + `panel/src/app/api/clipper/[...path]/route.ts` | — | | Fontes (canais de live) nos canais de publicação | `linkChannel`/`endChannel`/`accountsForChannel` em `panel/src/lib/accounts.ts`; rotas `panel/src/app/api/accounts/[id]/channels/`; card "Fontes de corte" em `account-manager.tsx`. Na UI "Canais" virou **"Fontes"**; código e rotas seguem `channels` | [panel.md](panel.md) | @@ -64,10 +65,17 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You - **Aprendizado dos emotes:** aprovar/rejeitar no painel = ±0,3/0,15 nos emotes de −10 s a +6 s do pico, uma vez por corte (`clips.learned`); a decisão da IA conta com `factor=0.5`. Peso limitado a −1…3. -## Juízes (decisão do usuário: pela CLI, sem chave de API) +## Juízes (decisão do usuário: pela CLI; chave de API só pelo cofre do painel) -- Provedores `codex` (padrão `gpt-6-luna`; lista de `~/.codex/models_cache.json`), `claude` (`haiku`/`sonnet`/`opus`) - ou `off` (só a heurística). +- Provedores `codex` (padrão `gpt-6-luna`; lista de `~/.codex/models_cache.json`), `claude` (`haiku`/`sonnet`/`opus`), + `gemini` (`Judge._gemini`: `gemini -p -o json --approval-mode plan --skip-trust -m `, prompt + completo pelo stdin, schema no prompt e JSON extraído de `response`; frames copiados para pasta temporária **fora do + repo**, porque `@arquivo` respeita o `.gitignore`) ou `off` (só a heurística). +- **IA reserva por chamada** (18/11/2026): `clipper/app/ai_settings.py` lê `data/ai/settings.json` e o cofre + `data/ai/vault.bin` (DPAPI por `ctypes`; **só leitura**, quem escreve é o painel). Falha de indisponibilidade (cota, + 429, login, chave, rede, CLI fora) pausa a IA e a mesma chamada segue na próxima pronta da `order`; erro de conteúdo + não troca. Contrato: `doc/ia.md`; visão geral e armadilhas: [ai.md](ai.md). Teste: `clipper/tests/test_ai_fallback.py`. + Só vale depois de reiniciar o Clipador (gotchas, item 144). Gemini com chave real e `@arquivo` de imagem: não testados. - **ANALISTA** vê 6 frames (8 se o trecho passa de 80 s) + fala + chat + glossário e devolve `situation`, `what_happened`, `screen`, `speech`, `chat_meaning`, `confidence` (0–1) e início/fim da ação. **EDITOR** vê só texto + a análise e escreve título, legenda, nota e corte. Os dois podem recuar até `duration.backtrackS` (padrão 120 s) antes do candidato. @@ -77,7 +85,7 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You - Custo fixo: cada chamada é um processo novo (2 por candidato). `codex_lean_overrides(search, config_file=None)` em `judge.py` enxuga o Codex; o Claude leva `--setting-sources project,local`. Números e limites em [token-economy.md](token-economy.md); teste: `test_codex_lean_overrides`. Vale após reiniciar o Clipador (gotcha 136). -- Não adicione chave de API ao juiz sem pedido do usuário. Corte manual é renderizado mesmo com nota baixa. +- Chave de API do juiz vem só do cofre do painel (`authMode: "apiKey"`, variável só na chamada); não crie outro caminho de chave sem pedido do usuário. Corte manual é renderizado mesmo com nota baixa. ## Hashtags da legenda (`hashtags.py`) @@ -322,18 +330,59 @@ Teste local do editor sem tocar no serviço do usuário: instância na faixa 450 banco, com as regras do item 77 de [gotchas.md](gotchas.md). Teste de UI no painel do usuário sobre um corte real: intercepte as escritas (item 86) e ache as camadas do canvas pelo cursor (item 85). +## Parar é parar e idioma (18/11/2026) + +Texto completo no README do Clipador ("Parar é parar", "Idioma por fonte e por sessão"). + +- **Parar à mão pausa o monitor da fonte.** `POST /v1/sessions/{id}/stop` (corpo opcional `{"pauseMonitor": false}`; + padrão `true`) grava `channels.monitor_paused_at` + `monitor_paused_session`; o monitor pula a fonte pausada. Limpam a + pausa: `PATCH /v1/channels/{id}` com `{"monitor": true}`, `POST /v1/sessions` (gravar pelo link) e `resume` pelo painel. + Queda de live (captura cai sozinha) **não** passa pela pausa: continua `keep_live`, na mesma sessão. Na UI: a fonte + mostra "monitor pausado · você parou a sessão #N" com **Religar**; o diálogo de parar tem a opção de voltar a gravar + sozinho (marcada = não pausa). +- **Idioma.** `language` em `channels` e `sessions` (`pt-BR`, `en-US`, `es-419`; `''` = `CLIPPER_LANGUAGE`), aceito em + `POST/PATCH /v1/channels` e `POST /v1/sessions`; as visões de fonte, sessão e corte devolvem o idioma **já resolvido**. + O Whisper usa o idioma da sessão; fora de pt-BR os prompts do editor e da varredura recebem a nota de idioma de saída. + No painel, `accounts.language` (migração v9 do painel, padrão `pt-BR`) e o aviso no diálogo Publicar quando o idioma do + canal difere do idioma do corte. Versões traduzidas de um mesmo corte: **ainda não existem** (próxima etapa). +- Sem reiniciar o Clipador as rotas novas não valem; o painel trata `language`/pausa como opcionais e não quebra + (gotchas, item 166). + ## Perfil do jogo (aba Jogos) -Toda rota abaixo devolve a lista inteira (mesma forma de `GET /v1/games`). +Fonte do contrato: `doc/clipador/JOGOS.md`; seção "Contexto do jogo" de `clipper/README.md`. Toda rota abaixo devolve a +lista inteira (mesma forma de `GET /v1/games`), exceto onde dito. + +**Dois idiomas.** `profile` = português (o que o painel mostra); `profileAi` = inglês (vai nos prompts; `null` = não +traduzido, a IA usa `profile`); `aiLanguage` `en-US`; `translatedAt`; `aliases` (união dos dois perfis). Campos novos do +perfil: `aliases` (≤ 10), `missions` `[{name, chapter, summary, completion_triggers ≤ 8 de 200 caracteres}]` (até 120; +`[]` quando não há lista pública — a IA nunca inventa) e `end_triggers` (≤ 12, sinais gerais de fim de missão). +`game_context` (`judge.mission_lines`: `MISSIONS_IN_PROMPT` 25, `MISSIONS_PROMPT_CHARS` 1500) manda terminar o corte de +missão logo depois do gatilho de fim. Busca por nome casa `id` **ou** alias (categoria "Grand Theft Auto VI" e tela +"GTA 6" = mesmo jogo). | Rota | Faz | |---|---| -| `GET /v1/games` | perfis com `status`, `model`, `researchedAt`, `editedAt`, `notes` (`[{text, at, section?}]`) e `profile` | -| `POST /v1/games/{id}/research` | refaz o perfil do zero pela web (`RESEARCH_TIMEOUT_S` 420); os pedidos guardados entram no prompt | -| `PUT /v1/games/{id}` | grava o perfil editado à mão: `name`, `summary`, `genre`, `mechanics`, `clip_worthy`, `avoid`, `jargon`, `news`, `hashtags`, `sources` | -| `POST /v1/games/{id}/refine` | `{instruction, search, section, history}` → `{games, reply}`. `instruction` 3–1500 caracteres; `search` padrão `true` (`false` = sem web, `TIMEOUT_S` 240); `section` `""` \| `summary` \| `clip_worthy` \| `avoid` \| `mechanics` \| `news` \| `jargon` \| `hashtags` \| `sources` (`Literal` em `GameRefineIn` de `main.py`, inválido dá 422); `history` `[{role: "user"\|"ai", text ≤1500}]`, máx. 20. A IA devolve o perfil inteiro + `reply` (1–2 frases do que mudou); guarda o pedido (com `section`) e marca `edited_at` | +| `GET /v1/games` | perfis com `status`, `error`, `model`, `researchedAt`, `editedAt`, `translatedAt`, `notes` (`[{text, at, section?}]`), `aliases`, `profile`, `profileAi` | +| `POST /v1/games` `{name, notes?}` | cadastra (201, `{games, id}`, status `pending`) e pesquisa em segundo plano; 409 se o `id` ou um alias já existe | +| `DELETE /v1/games/{id}` | apaga o jogo (sessões não mudam; volta a ser pesquisado se o jogo reaparecer); 404 se não existe | +| `POST /v1/games/{id}/research` | refaz o perfil do zero pela web **em inglês** e traduz para português (`RESEARCH_TIMEOUT_S` 420); os pedidos guardados entram no prompt | +| `POST /v1/games/{id}/translate` | gera o inglês a partir do português (jogo de antes dos perfis bilíngues) | +| `PUT /v1/games/{id}?lang=pt\|en` | grava a edição à mão no idioma `lang` (padrão `pt`) e traduz para o outro; sem IA, grava e deixa o outro desatualizado. Campos: `name`, `summary`, `genre`, `mechanics`, `clip_worthy`, `avoid`, `jargon`, `news`, `hashtags`, `sources`, `aliases`, `missions`, `end_triggers` | +| `POST /v1/games/{id}/refine` | `{instruction, search, section, history}` → `{games, reply}`. Aplica no inglês e responde em português. `instruction` 3–1500 caracteres; `search` padrão `true` (`false` = sem web, `TIMEOUT_S` 240); `section` `""` \| `summary` \| `clip_worthy` \| `avoid` \| `mechanics` \| `news` \| `jargon` \| `hashtags` \| `sources` \| `missions` \| `end_triggers` \| `aliases` (`Literal` em `GameRefineIn` de `main.py`, inválido dá 422); `history` `[{role: "user"\|"ai", text ≤1500}]`, máx. 20. A IA devolve o perfil inteiro + `reply`; guarda o pedido (com `section`) e marca `edited_at` | | `DELETE /v1/games/{id}/notes/{index}` | esquece um pedido guardado (o perfil atual fica como está) | +- Tradução que falha (ou IA desligada): a outra versão fica como estava (na pesquisa, as duas em inglês), `error` + explica e `translatedAt` não muda. Tradução nunca mexe em nome, hashtags, fontes e outros nomes, e é recusada se + perder missões. +- **Sementes:** `clipper/app/seeds/games/*.json` (`{name, aliases, researchedAt, sources, profileAi, profile}`) é + importado na subida **só se o jogo não existe**. Hoje: `gta-vi.json` (GTA VI lança 19/11/2026, sem lista oficial de + missões; a semente traz 4 do vídeo "An Extended Look" com nomes descritivos **não oficiais** — pesquisar de novo + depois do lançamento; gotchas, item 167). +- Proxy do painel (`panel/src/lib/clipper.ts`): `ALLOWED` aceita `games//(research|refine|translate|notes/n)`; + `METHODS` dá GET/POST a `games` e PUT/DELETE a `games/`; timeouts: 8 min `research|refine`, 5 min `translate` e + `PUT`, 30 s `POST games`. + - `clean_profile` (`intel.py`) normaliza tudo que entra: apara, tira vazios e duplicados, no máximo 20 itens por lista. São guardados os últimos 30 pedidos. - **Pedido guardado sobrevive a "Pesquisar de novo"** (`research_game(name, title, notes)`; `PROFILE_SYSTEM` manda @@ -344,13 +393,10 @@ Toda rota abaixo devolve a lista inteira (mesma forma de `GET /v1/games`). `history`, 400 caracteres cada. `REFINE_SYSTEM` manda mexer só na seção em foco e transformar pedido genérico em item concreto ("reação do streamer conta" → "Streamer grita, xinga ou ri alto logo depois de uma morte ou fuga"). `Intel.refine(...)` (`intel.py`) devolve `(profile, reply)`. -- Painel (`clipper-games.tsx`): o cabeçalho tem selo de iniciais e os botões "Conversar com a IA" (perfil inteiro), - "Editar" (uma linha por item) e "Pesquisar de novo". Cada seção é um cartão com "Pedir à IA", que abre o chat - daquela seção (`AiChat`: Enter envia, Shift+Enter quebra linha, chave "Confirmar na web" **desligada** por - padrão no painel, embora a API use `search=true` por padrão). Item recém-acrescentado aparece com selo "novo". - "Memória da IA" lista os pedidos guardados (com a seção) e tem X. A conversa só existe enquanto o chat está - aberto. O que fica salvo é o pedido. Tipo `Game` em `panel/src/components/clipper-client.ts` - (`editedAt?`, `notes?[].section?`). Detalhes visuais em [panel.md](panel.md). +- Painel: lista em `/clipper/games` e modal por `?game=ID` (`clipper-game-dialog.tsx`, `clipper-game-parts.tsx`); o chat + `AiChat` tem a chave "Confirmar na web" **desligada** por padrão, embora a API use `search=true`. A conversa só existe + enquanto o chat está aberto; o que fica salvo é o pedido (aba "Pedidos à IA", com X). Tipos `Game`, `GameProfile`, + `GameMission` em `panel/src/components/clipper-client.ts`. Detalhes visuais em [panel.md](panel.md). ## Regras @@ -371,6 +417,17 @@ Toda rota abaixo devolve a lista inteira (mesma forma de `GET /v1/games`). ## Testes e evidência +Perfis de jogo bilíngues, missões, cadastro e semente do GTA VI (18/11/2026): `pnpm test:clipper` → **335 passed** +(reexecutado nesta manutenção, 108 s; bate com o informado); 10 testes em `clipper/tests/test_game_profiles.py`. Não +verificado: IA real na pesquisa, tradução e refino bilíngues; modal e lista no navegador; serviço real em v12 (precisa +reiniciar); `pnpm typecheck` e testes do painel. + +IA reserva e Gemini no juiz (18/11/2026): `pnpm test:clipper` → **335 passed** (reexecutado pela skill; `test_ai_fallback.py` novo). + +Reformulação da interface e regras de pausa/idioma (18/11/2026): `pnpm test:clipper` → **287 passed** (reexecutado +nesta manutenção; 9 testes novos em `clipper/tests/test_monitor_pause_and_language.py`). Não verificado: as páginas no +navegador e o banco real em v11 (o serviço precisa reiniciar). + Os testes não chamam a CLI de IA: `FakeJudge.ask` (`clipper/tests/test_sources_and_api.py`) sempre falha, e o serviço segue pelo caminho de "IA fora". Juiz falso novo precisa cobrir `ask` também. @@ -485,7 +542,7 @@ Não verificado: contra o serviço reiniciado; - apagar: rota no serviço real do usuário; arquivo em uso no Windows (deve voltar em `left`); pedido do editor em andamento gravando em `edit-/` depois de apagar; relógio da sessão com movimento reduzido, aba escondida e - larguras de 1024/1280; a faixa do topo em `clipper-studio.tsx` ainda mostra o `durationS` real (sem o relógio); + larguras de 1024/1280; a faixa do topo (hoje `clipper-shell.tsx`) pode ainda mostrar o `durationS` real (sem o relógio); - duração, gancho, reenquadramento, camadas e captura: live 2K real e HEVC real da Twitch pela captura; gravação longa em 1080p ou 2K com o serviço real; juiz e varredura reais com as durações novas; render real de um projeto feito no editor com reenquadramento e camadas comparado com a prévia (pendente, depois do reinício do serviço); camadas na diff --git a/.claude/skills/cenaforge/references/gotchas.md b/.claude/skills/cenaforge/references/gotchas.md index 1c8356b..947830d 100644 --- a/.claude/skills/cenaforge/references/gotchas.md +++ b/.claude/skills/cenaforge/references/gotchas.md @@ -3,7 +3,7 @@ Cada item: **sintoma → causa → correção → onde está tratado**. Observadas na implementação da prova de conceito com Godot 4.7.2 / FFmpeg 7.1.1 / pnpm 11.22 (16/11/2026). Registro formal em `doc/TEST_RESULT.md`: itens 1–5, 7, 13–15, 17 e 18; itens 30–33 estão em `voice/README.md` -("GPU e CPU"); itens 57–61 estão em `clipper/README.md` ("Armadilhas já resolvidas"); itens 74–76, 87–90 e 103–108 também estão lá e o 78 na seção "Limitações" do editor; itens 79, 81–84 e 92–95 estão em `doc/FACE_BAKEOFF.md` (o 93 também em "Variáveis" de `clipper/README.md`) (o 80, no comentário de `clipper/requirements.txt`); itens 118–128 (publicação) seguem `doc/publicacao/` e o código; itens 151–154 foram informados em 17/11/2026 (parte conferida no código); itens 129–132 foram informados em 17/11/2026 e conferidos no código (`doc_main.gd`, `doc/godot/cenas.md`) e no banco (`agent_runs` 5, 7 e 8); itens 62–67, 77, 85–86, 91, 99–102, 109–112 e as ampliações do 52, do 44, 77, 86 e 87 foram informados em 16–17/11/2026 (não estão em `doc/TEST_RESULT.md`); os demais vieram de erros de compilação ou instalação durante a implementação. +("GPU e CPU"); itens 57–61 estão em `clipper/README.md` ("Armadilhas já resolvidas"); itens 74–76, 87–90 e 103–108 também estão lá e o 78 na seção "Limitações" do editor; itens 79, 81–84 e 92–95 estão em `doc/FACE_BAKEOFF.md` (o 93 também em "Variáveis" de `clipper/README.md`) (o 80, no comentário de `clipper/requirements.txt`); itens 168–172 (IA) seguem `doc/ia.md`; itens 118–128 (publicação) seguem `doc/publicacao/` e o código; itens 151–154 foram informados em 17/11/2026 (parte conferida no código); itens 129–132 foram informados em 17/11/2026 e conferidos no código (`doc_main.gd`, `doc/godot/cenas.md`) e no banco (`agent_runs` 5, 7 e 8); itens 62–67, 77, 85–86, 91, 99–102, 109–112 e as ampliações do 52, do 44, 77, 86 e 87 foram informados em 16–17/11/2026 (não estão em `doc/TEST_RESULT.md`); os demais vieram de erros de compilação ou instalação durante a implementação. Ao descobrir uma nova, registre aqui via `cenaforge-skill-updater`. Os números são estáveis (outros textos os citam): item novo entra na seção do assunto com o próximo número livre. @@ -764,10 +764,54 @@ observada num envio real ainda. Contexto em [publishing.md](publishing.md). 165. **Cartoon: sombra do corpo/barriga em elipse parece mancha.** Correção: elipse + curva de volume (contorno) e sombra lateral recortada por `clipPath`. Onde: `cartoon/src/CharacterFigure.tsx`. +166. **Clipador: depois de parar a sessão à mão, a fonte não grava de novo (ou as rotas/campos novos "não pegam").** + Dois lados. (a) Parar à mão pausa o monitor da fonte de propósito (`monitor_paused_at`): live no ar e nada + reabrindo não é falha. Religar = "Religar" em `/clipper/sources`, `PATCH /v1/channels/{id}` `{"monitor": true}`, + gravar pelo link ou retomar a sessão; `{"pauseMonitor": false}` no stop evita a pausa. Queda de live sem ninguém + parar continua retomando na mesma sessão. (b) Serviço sem `--reload` (item 144): sem reiniciar, `stop` não pausa, + `language` não é aceito nem devolvido e a migração v11 não roda; o painel trata os campos como opcionais, então + nada quebra, só não pega. Reinicie (é do usuário) e confira `PRAGMA user_version` = 11. Onde: + `clipper/app/worker.py`, `main.py` (`StopIn`), `db.py` (v11); teste `clipper/tests/test_monitor_pause_and_language.py`. + +167. **Clipador: perfil do jogo sem versão em inglês, GTA VI ausente ou "cadastrar jogo" que não funciona.** (a) Serviço + sem reiniciar (item 144): a migração v12 não roda, `POST /v1/games`, `translate`, `DELETE` e `?lang=` não existem e a + semente do GTA VI não é importada (só entra na subida, e só se o jogo não existe: nunca sobrescreve edição). + Reinicie (é do usuário) e confira `PRAGMA user_version` = 12. (b) Jogo antigo tem `profileAi: null`: a IA usa o + português até rodar `POST /v1/games/{id}/translate` ("Gerar versão em inglês" no modal). (c) Categoria ou tela com + outro nome ("Grand Theft Auto VI" × "GTA 6") só cai no mesmo perfil se o nome estiver em `aliases`; cadastro com nome + já existente (inclusive alias) dá 409. (d) Missões só entram quando a lista é pública; **a semente do GTA VI traz 4 + missões do vídeo "An Extended Look" com nomes descritivos, não oficiais** (jogo lança 19/11/2026, sem lista oficial): + pesquisar de novo depois do lançamento, sem apagar o jogo. Edição à mão em um idioma é traduzida para o outro; tradução + que falha deixa a outra versão como estava e `error` explica. Onde: `clipper/app/intel.py` (`import_seeds`, + `add_game`, `translate`), `main.py`, `db.py` (v12), `seeds/games/`; teste `clipper/tests/test_game_profiles.py`. + +## IA: provedores, login e reserva + +Itens 168–172 informados em 18/11/2026 e conferidos contra `doc/ia.md` e o código. Contexto em [ai.md](ai.md). + +168. **Gemini CLI com login Google: `IneligibleTierError: UNSUPPORTED_CLIENT`** (gemini-cli 0.68.0). Causa: o OAuth gratuito + "Code Assist for individuals" foi encerrado; o Google manda migrar para o Antigravity. OAuth só com plano elegível + (Code Assist Standard/Enterprise, Workspace). Correção: conta pessoal usa **chave do AI Studio** (`authMode: "apiKey"`). + O erro conta como indisponibilidade (`IneligibleTier`) e aciona a reserva. Onde: `panel/src/lib/ai.ts`, `doc/ia.md`. +169. **`CODEX_API_KEY` só vale no `codex exec`** (confirmado no binário 0.169.0). Para chave sem mexer na conta do usuário, + ponha a variável só na chamada (`providerEnv`); **não** use `codex login --with-api-key`, que troca o login global. + Mesma regra para `ANTHROPIC_API_KEY` e `GEMINI_API_KEY`. Onde: `providerEnv` em `panel/src/lib/ai.ts`. +170. **Terminal de login no Windows: aspas do `cmd` e caminho com espaço ("Program Files").** Forma que funcionou: + `cmd /d /c start "" cmd.exe /k ""` com `windowsVerbatimArguments: true` (testado com caminho em + "Program Files"); sem o modo verbatim o Node reescreve as aspas (causa não isolada). Onde: `openLoginTerminal` em + `panel/src/lib/ai.ts`. +171. **Status das IAs lento (~0,3 s por chamada ao cofre).** Causa: a DPAPI no Node passa por PowerShell. Correção: cofre + em cache por `mtime` de `data/ai/vault.bin`; o Clipador lê com `ctypes` (`clipper/app/ai_settings.py`). Não leia o + cofre por requisição sem o cache. +172. **CLI instalada "não aparece" no painel.** Causa: o PATH do painel é o de quando ele abriu (instalação nova não entra), + e o instalador nativo do Claude usa `~/.local/bin` e o npm `%APPDATA%\npm`. Correção: `resolveCommand` procura nesses + dois lugares além do PATH; mesmo assim, instalar e não ver = "Verificar" de novo na tela. Gemini no Windows: o + `gemini.cmd` exige shell, então roda `node …/@google/gemini-cli/bundle/gemini.js` (mesma família do item 28). + Relacionadas, já registradas acima: - Patch por script em arquivos CRLF do painel (`lib/metrics.ts`, `components/metrics-view.tsx`, `dashboard-controls.tsx`, `app/dashboard/page.tsx`): item 63 — uma substituição com "\n" não acha o trecho; normalize e grave de volta em CRLF. - `codex.cmd` sem shell: item 28. - Script de patch com regex (`\b`) passado por heredoc: item 44. - Publicador roda sem `--reload`: mudança em `publisher/app/` só vale depois de reiniciar o `pnpm dev` (itens 137, 139, 140, 142, 143, 145 e 147; o Clipador também: 144). -- Migração do painel (v3 … v8) é aplicada na 1ª requisição depois da recarga do `db.ts`; reiniciar o `pnpm panel`/`pnpm dev` só se isso não bastar: itens 51 e 138 (reiniciar mata agente em execução: item 131). +- Migração do painel (v3 … v10) é aplicada na 1ª requisição depois da recarga do `db.ts`; reiniciar o `pnpm panel`/`pnpm dev` só se isso não bastar: itens 51 e 138 (reiniciar mata agente em execução: item 131). diff --git a/.claude/skills/cenaforge/references/panel.md b/.claude/skills/cenaforge/references/panel.md index 332c2af..730eee1 100644 --- a/.claude/skills/cenaforge/references/panel.md +++ b/.claude/skills/cenaforge/references/panel.md @@ -19,13 +19,15 @@ Fonte: código em `panel/src/lib/` e `panel/README.md`. O painel é do usuário: (ex.: `CutSettingsDialog` de `clipper-cut-settings.tsx`). Não monte um segundo host. - `Button` (`components/ui.tsx`) tipa as props como `ComponentProps<"button">` e aceita `ref` (React 19). -## Banco (`data/cenaforge.db`, esquema v7) +## Banco (`data/cenaforge.db`, esquema v10) - Migração em `panel/src/lib/db.ts` (lista `MIGRATIONS`). Banco com dados → cópia em `data/backups/` antes de migrar (`cenaforge-v-.db`). `foreign_keys = OFF` fora da transação e `PRAGMA foreign_key_check` antes do `COMMIT` de cada versão. - v3: `account_channels` (conta ↔ canal de live do Clipador; `status` `active`/`ended`). O canal vive em `data/clipper/clipper.db`, então não há chave estrangeira para ele. +- v9: `accounts.language` (idioma e público do canal de publicação; padrão `pt-BR`; opções em `ACCOUNT_LANGUAGES` de + `panel/src/lib/languages.ts`). A v8 (última leitura dos números das redes) não está descrita aqui: ver publishing.md. - v4: reconstrói `stories` (SQLite não altera CHECK) para `kind` aceitar `'documentary'`; mesmas colunas e ids. - v5: publicação real — `publish_jobs`, `app_settings`, `clip_auto_approvals`; `account_networks` e `publications` @@ -35,6 +37,7 @@ Fonte: código em `panel/src/lib/` e `panel/README.md`. O painel é do usuário: - v6: reconstrói `publish_jobs` (ids preservados) com `schedule_source` (`auto`/`manual`/`now`) e `cancel_reason` `unlinked`. Banco real em v6 (`PRAGMA user_version`, conferido em 17/11/2026, antes da v7). - v7: `publish_jobs.origin` (`link`/`manual`, padrão `link`): job criado pelo botão "Publicar" do corte. Ver publishing.md. +- v10: `agent_runs.fallback_of` (execução que continuou outra que caiu por indisponibilidade; IA reserva — [ai.md](ai.md)). - API: toda rota `/api/**` passa por `panel/src/proxy.ts` (Host local; escrita exige `Origin` do painel) e corpo por `readJson` (415 sem `Content-Type: application/json`) — gotchas, item 125. - A conexão fica em `globalThis.__cenaforgeDb`; a marca de módulo `checkedThisModule` faz a 1ª chamada de `db()` depois @@ -248,7 +251,13 @@ Cada trecho vira um MP4 de desenho 2D montado por peças a partir do texto; pers informando o formato (o subagente é uma casca que lê `doc/roteiro/`; sem WebSearch, fato sem fonte fica "a confirmar"); no **Codex** manda ler os guias e escrever sozinho, sem usar `.claude/agents/` (mesma regra no `AGENTS.md`). -- Lista de modelos = `models()` (não há mais constante fixa): +- **Três provedores** (`claude`, `codex`, `gemini`), configurados em **Configurações → IA** (`/settings/ai`: ligar/desligar, + conta ou chave de API, ordem da reserva, instalar, entrar, testar). **IA reserva:** agente que termina com erro de + indisponibilidade é pausado e a mesma tarefa recomeça na próxima IA pronta (`agent_runs.fallback_of`; o console segue + o `followUpRunId` também nesse caso; vertentes religadas à nova execução). Contrato, API e armadilhas em + [ai.md](ai.md). Configurações são subpáginas `/settings/{ai,publishing,apps,browser,modes}` (`/settings` → IA; + `SETTINGS_SECTIONS` em `settings-shell.tsx`, também no menu lateral); link antigo `/settings?tab=apps` não existe mais. +- Lista de modelos = `models()` (não há mais constante fixa; o Gemini usa `geminiModels()` de `lib/ai.ts`): - Codex: lê `models_cache.json` de `$CODEX_HOME` (padrão `~/.codex`), que a CLI do Codex atualiza sozinha; filtra `visibility === "list"`, ordena por `priority`. Primeira opção "Padrão da CLI (…)" = `model = "..."` do `config.toml`. O id vai em `codex exec -m `. Em 17/11/2026: 8 modelos @@ -266,8 +275,9 @@ Cada trecho vira um MP4 de desenho 2D montado por peças a partir do texto; pers em `createStoryFromTextAction`, `app/actions.ts`). Por script: `POST /api/stories {text, title?, kind?, provider?, model?}` (`app/api/stories/route.ts`; `kind` padrão `documentary`, texto 20–20.000 caracteres) cria a história + ep01 e dispara o agente `story` → `{storyId, episodeId, runId}` (cabeçalho `Origin`: gotchas, item 125). -- O agente roda dentro do processo do painel: reiniciar o `pnpm panel` o mata (gotchas, item 131). Limite de uso do - Claude/Codex para a tarefa no meio: continue no outro provedor com o contexto (item 132). +- O agente roda dentro do processo do painel: reiniciar o `pnpm panel` o mata (gotchas, item 131). Limite de uso no + meio da tarefa: com a reserva ligada o painel recomeça sozinho na próxima IA (item 132 vale só com a reserva + desligada ou sem outra IA pronta: continue à mão no outro provedor com o contexto). - Prompt do Codex manda ler texto no PowerShell com `Get-Content -Raw -Encoding UTF8` (gotchas, item 98). ### Mensagem com o agente rodando @@ -336,6 +346,29 @@ Limitação: o overlay da Godot só tem `choiceA`/`choiceB` (`scene_config.gd`); ## Página `/clipper` (Clipador) +Reformulada em 18/11/2026 (`doc/clipador/REDESIGN.md`): deixou de ser uma página com 5 abas e virou **subpáginas** no +grupo de rotas `panel/src/app/clipper/(studio)/`. O `layout.tsx` monta `ClipperProvider` (`clipper-provider.tsx`: dados + +consulta periódica; `useClipper()`) e `ClipperShell` (`clipper-shell.tsx`: cabeçalho compacto com estado do serviço, +bloco "Ao vivo agora · N" com uma linha por live, sub-navegação com contadores). Sub-navegação = `CLIPPER_SECTIONS`; a +sidebar (`sidebar-nav.tsx`) mostra os mesmos subitens quando o Clipador está ativo. Seção nova = entrada em +`CLIPPER_SECTIONS` + pasta em `(studio)/`. + +| Rota | Conteúdo | Arquivos | +|---|---|---| +| `/clipper` Cortes | lista `ClipTable` (uma linha por corte; ações rápidas Aprovar/Rejeitar/Publicar), filtros na URL (`?stage ?source ?session ?lang`), modal `ClipDialog` por `?clip=ID` com anterior/próximo | `clipper-clips-page.tsx`, `clipper-clip-table.tsx`, `clipper-clip-dialog.tsx`, `clipper-clip-parts.tsx`; ordenar/apagar/selecionar em utilitários de `clipper-queue.tsx` | +| `/clipper/sessions` | lista de sessões; "Gravar pelo link" em diálogo (`RecordForm`) | `clipper-sessions-page.tsx` | +| `/clipper/sessions/[id]` | saúde, resumo da IA, tiles, gráfico do chat, emotes, configuração do corte | `clipper-session-detail.tsx` | +| `/clipper/sources` | fontes em tabela, "Adicionar fonte" em diálogo, monitor ligado/**pausado** + Religar, idioma da live, canais de publicação | `clipper-channels.tsx` | +| `/clipper/games` | jogos em tabela (nome, gênero, estado, missões, última pesquisa/edição), "Adicionar jogo" em diálogo, `?game=ID` abre o modal do jogo e emotes do canal | `clipper-games-page.tsx`, `clipper-game-dialog.tsx` (modal), `clipper-game-parts.tsx` (seções, `AiChat`, editor à mão), `clipper-games.tsx` | +| `/clipper/settings` | abas Juiz (IA) / Serviço / Idiomas e públicos | `clipper-settings-page.tsx`, `clipper-judge.tsx` | +| `/clipper/edit/[clipId]` | editor em tela cheia, **fora** do grupo `(studio)` | ver "Editor de cortes" | + +`clipper-studio.tsx` foi **apagado**; `clipper-queue.tsx` virou só utilitários da lista (a lista é `ClipTable`); +`clipper-sessions.tsx` virou peças compartilhadas (`PlatformIcon`, `CutNow`, `RecordForm`, relógio, `sessionHealth`). +Canal de publicação: campo "Idioma e público" em `account-manager.tsx`; aviso de idioma em `clip-publish.tsx`. +Os parágrafos abaixo descrevem o comportamento de cada peça; onde falam em "aba", "cartão" ou "fila", leia "página", +"linha" e "lista de cortes" (a reescrita deles não foi verificada no navegador). + - `clipper-cut-settings.tsx`: modal "Configuração do corte" em cinco abas — Formato e duração (com a seção "Qualidade da gravação" e o disco por hora de cada opção, de `captureQualities`) · Câmera e layout · Legenda (com seletor de fonte) · Gancho (estilo, cores, fonte, animação de entrada, "Ver a entrada") · Crédito — com a prévia ao @@ -345,7 +378,7 @@ Limitação: o overlay da Godot só tem `choiceA`/`choiceB` (`scene_config.gd`); - `clipper-client.ts`: tipo `Aspect`, `format` em `CutSettings`, `aspect?` em `Clip`, `aspectOf()` (ausente = vertical) e `withFormat()` (completa a resposta de um serviço antigo sem `format`). Na fila (`clipper-queue.tsx`) o corte horizontal aparece em 16:9. -- Aba Sessões (`clipper-sessions.tsx`; cabeçalho em `clipper-studio.tsx`): cartão com cabeçalho (tempo gravado, +- Sessão (`clipper-sessions.tsx`, `clipper-session-detail.tsx`): cartão com cabeçalho (tempo gravado, "gravando em L×A · fps" de `capture` e ações), frase de saúde (`sessionHealth()`), painel "o que está acontecendo" (resumo da IA + jogo), quatro blocos (Chat, Transcrição, IA assistiu, Cortes) e barra de ferramentas. **Altura fixa por desenho**: nada pode pular na atualização automática. "Retomar gravação" aparece em toda live que não está gravando (botão principal só em @@ -358,12 +391,12 @@ Limitação: o overlay da Godot só tem `choiceA`/`choiceB` (`scene_config.gd`); atrasou, "gerando o próximo resumo…". O intervalo vem de `/status` → `judge.options.scanIntervalS` (`useScanInterval`; reserva 180 = `OPTION_DEFAULTS` de `intel.py`). Existe porque o dono achou que o resumo travava (gotchas, item 115). -- `clipper-games.tsx`: aba Jogos e emotes. O card do jogo tem selo de iniciais (primeira + última palavra, cor - por `hueOf`) e os botões "Conversar com a IA", "Editar" e "Pesquisar de novo". Cada seção é um cartão com - barra colorida, contador e "Pedir à IA", que abre o chat inline `AiChat` (balões, atalhos de pedido por seção, - indicador de digitação, "+N itens novos / −N removidos"). Item novo fica verde com selo "novo". Gírias viram - chips, e Fontes e "Memória da IA" ficam recolhidas. A aba também mostra os emotes do canal com usos e peso. - Rotas e regras em [clipper.md](clipper.md#perfil-do-jogo-aba-jogos). +- Jogos (`clipper-games-page.tsx` + `clipper-game-dialog.tsx` + `clipper-game-parts.tsx`; `clipper-games.tsx` guarda + os emotes do canal): lista em tabela; o modal tem alternância **Português (você lê) / English (vai para a IA)** e abas + Visão geral · Rende corte · Missões · Gatilhos de fim · Termos e hashtags · Fontes · Pedidos à IA, com Pesquisar de + novo, Editar, Pedir à IA (`AiChat`: atalhos por seção, "+N itens novos / −N removidos") e Apagar. Editar grava no + idioma da alternância e o serviço traduz o outro. Rotas e regras em [clipper.md](clipper.md#perfil-do-jogo-aba-jogos). +- Sidebar: os subitens do Clipador usam os mesmos ícones das abas do topo (`sidebar-nav.tsx`, `SubItem.icon`). - `clipper-queue.tsx`: cartão do corte mostra a análise do juiz e recua/avança o início (`START_STEPS` −30/−10/−5/−2/+2 s). `clipper-judge.tsx`: modelos do editor e do analista, varredura, visão, câmera. - **Ordenar a fila** (`clipper-queue.tsx`, seletor "Ordenar" ao lado do filtro de sessão; `QUEUE_SORTS`, `useQueueSort`): @@ -523,4 +556,4 @@ Apagar na fila, relógio da sessão e prévia igual ao render (17/11/2026): `npx (reconferido pela skill). Informado pelo coordenador: porte da legenda em 22 conferências contra o Python; corte 61 montado no editor e renderizado pelo serviço com enquadramento, inserção e legenda iguais à prévia em 2/3,5/5/6,5/8 s. Não verificado: apagar pela UI contra o serviço real; relógio com movimento reduzido, aba escondida -e larguras de 1024/1280; a faixa do topo de `clipper-studio.tsx` ainda usa o `durationS` real. +e larguras de 1024/1280; a faixa do topo (hoje `clipper-shell.tsx`) pode ainda usar o `durationS` real. diff --git a/.claude/skills/cenaforge/references/tools.md b/.claude/skills/cenaforge/references/tools.md index e304a3a..6d133bb 100644 --- a/.claude/skills/cenaforge/references/tools.md +++ b/.claude/skills/cenaforge/references/tools.md @@ -21,9 +21,9 @@ prévia e registre aqui (via `cenaforge-skill-updater`). | Next.js / React / Tailwind | 16.4.6 / 19.3.0 / 4.3.3 | painel (`panel/`) | dependências do workspace | 16/11/2026 | | @xyflow/react | 13.0.1 | árvore de vertentes na aba Fluxo (`panel/src/components/story-flow.tsx`) | dependência do painel | 16/11/2026 | | SQLite | `node:sqlite` (Node 24) | banco do painel, sem dependência nativa | embutido | 16/11/2026 | -| Codex CLI | 0.169.0 (`@openai/codex`) | agente no painel (`codex exec --json -m `, sandbox `workspace-write`); modelos lidos de `~/.codex/models_cache.json` (panel.md, "Agentes e modelos") | `CODEX_BIN` → `.exe` no PATH → `codex.js` ao lado do `codex.cmd` do npm | 17/11/2026 | +| Codex CLI | 0.169.0 (`@openai/codex`) | agente no painel (`codex exec --json -m `, sandbox `workspace-write`); modelos lidos de `~/.codex/models_cache.json` (panel.md, "Agentes e modelos") | `CODEX_BIN` → `.exe` no PATH → `codex.js` ao lado do `codex.cmd` do npm | 17/11/2026 (`--version` reconferido em 18/11/2026) | | API do Wikimedia Commons (`commons.wikimedia.org/w/api.php`) | sem versão (HTTP público, sem chave; User-Agent genérico) | fotos reais por trecho na montagem documental (`panel/src/lib/image-search.ts`), com autor, licença e página de origem nos créditos | chamada direta do painel | 17/11/2026 (`ep01.montage.json`: 5 fotos do Commons com licença CC registrada; MP4 de 88,3 s; licença não conferida na página de cada foto) | -| Claude Code CLI | 2.1.314 | agente chamado pelo painel (`-p`, `stream-json`, `--resume`, `--model claude-*-5-5`/`claude-fable-5-2`) | `CLAUDE_BIN` → `PATH` (`claude.exe`) | 17/11/2026 | +| Claude Code CLI | 2.1.314 | agente chamado pelo painel (`-p`, `stream-json`, `--resume`, `--model claude-*-5-5`/`claude-fable-5-2`) | `CLAUDE_BIN` → `PATH` (`claude.exe`) → `~/.local/bin` | 17/11/2026 (`--version` reconferido em 18/11/2026) | Estilo Cartoon (`cartoon/`, 17/11/2026; contrato e uso em [cartoon.md](cartoon.md)): @@ -168,6 +168,7 @@ segurança). | Ferramenta | Para quê | Situação | |---|---|---| +| Gemini CLI (`@google/gemini-cli`) | terceiro provedor de IA (agentes do painel e juiz do Clipador; [ai.md](ai.md)) | **código pronto, nunca executado de verdade**: não instalado nesta máquina (18/11/2026, `gemini: command not found`); a versão 0.68.0 do contrato (`doc/ia.md`) vem de teste do dono e não foi reverificada aqui. Coberto só por testes sem CLI (`ai.test.ts`, `test_ai_fallback.py`). OAuth gratuito de conta pessoal encerrado (gotchas, item 168); uso real exige chave do AI Studio, ainda não testada. Passa a "Em uso" depois de uma tarefa real concluída por ele | | Meshy | gerar modelos GLB (personagens, objetos) e rig | citada na especificação; não testada | | Mixamo | animações para personagens com rig | citada como não obrigatória; não testada | | `.glb` carregado por `GLTFDocument` em tempo de execução (Godot) | modelos prontos dentro de cenas da biblioteca (`library//assets/`) | **só documentado** em `doc/godot/cenas.md`; nenhum `.glb` no repositório nem render com ele (17/11/2026). Personagens e barcos atuais são procedurais (`godot/kits/`) | diff --git a/doc/ia.md b/doc/ia.md new file mode 100644 index 0000000..d40692b --- /dev/null +++ b/doc/ia.md @@ -0,0 +1,82 @@ +# IA do CenaForge — provedores, login e reserva + +Três IAs, sempre pela **CLI oficial** instalada no PC (nunca SDK/HTTP direto): + +| Provedor | CLI | Instalação (Windows) | Login com a conta (OAuth) | Chave de API (variável) | +|---|---|---|---|---| +| `claude` | Claude Code (`claude`) | `irm https://claude.ai/install.ps1 \| iex` | `claude auth login` | `ANTHROPIC_API_KEY` | +| `codex` | Codex (`codex`) | `npm install -g @openai/codex@latest` | `codex login` (ChatGPT) | `CODEX_API_KEY` (só no `codex exec`) | +| `gemini` | Gemini CLI (`gemini`) | `npm install -g @google/gemini-cli@latest` | `gemini` interativo → "Login with Google" | `GEMINI_API_KEY` | + +> **Gemini + OAuth (verificado em 18/11/2026, gemini-cli 0.68.0):** o login gratuito "Gemini Code Assist for +> individuals" foi encerrado (`IneligibleTierError: UNSUPPORTED_CLIENT`, o Google manda migrar para o Antigravity). +> OAuth só funciona com plano elegível (Code Assist Standard/Enterprise, Workspace). Para conta pessoal, use a +> **chave de API** do Google AI Studio. + +Quem usa: os **agentes do painel** (`panel/src/lib/agents.ts`) e o **juiz do Clipador** (`clipper/app/judge.py`). +A configuração fica no painel em **Configurações → IA** (`/settings/ai`). + +## Arquivos compartilhados (contrato painel ↔ Clipador) + +Ambos em `data/ai/`. Quem escreve é só o painel; o Clipador apenas lê (relê se o `mtime` mudar). + +### `data/ai/settings.json` (sem segredo) + +```json +{ + "version": 1, + "providers": { + "claude": { "enabled": true, "authMode": "oauth" }, + "codex": { "enabled": true, "authMode": "oauth" }, + "gemini": { "enabled": false, "authMode": "apiKey" } + }, + "order": ["claude", "codex", "gemini"], + "fallback": { "enabled": true, "cooldownMin": 15 } +} +``` + +- `enabled`: a IA pode ser usada (como principal ou reserva). Desligada, nunca é chamada. +- `authMode`: `"oauth"` = a sessão já logada da CLI; `"apiKey"` = a chave guardada no cofre. +- `order`: prioridade da **reserva**. A tarefa usa a IA escolhida (ou a preferida dela); se falhar por + indisponibilidade, tenta a próxima da lista que estiver ligada e pronta. +- `fallback.enabled`: liga a troca automática. `cooldownMin`: depois de uma falha de indisponibilidade, a IA fica + "em pausa" esse tempo e é pulada (cada processo guarda a sua pausa em memória). +- Arquivo ausente ou inválido = padrão acima, com `claude` e `codex` ligados em `oauth` e `gemini` desligado. + +### `data/ai/vault.bin` (chaves de API) + +Um JSON `{"claude": "sk-ant-…", "codex": "sk-…", "gemini": "AIza…"}` (só as que existirem) cifrado com a +**DPAPI do Windows**, escopo do usuário (`CurrentUser`), entropia `b"CenaForge.AI.vault.v1"`. O arquivo é o blob +cru da DPAPI. Só a mesma conta do Windows nesta máquina abre. A chave **nunca** volta para a tela: a API do painel +só diz se existe e os 4 últimos caracteres. + +## Ambiente de cada chamada + +Montado a partir do ambiente do processo, por provedor: + +| Provedor | `authMode = "oauth"` | `authMode = "apiKey"` | +|---|---|---| +| `claude` | remove `ANTHROPIC_API_KEY` | `ANTHROPIC_API_KEY=` | +| `codex` | remove `CODEX_API_KEY` | `CODEX_API_KEY=` | +| `gemini` | `GOOGLE_GENAI_USE_GCA=true`, remove `GEMINI_API_KEY` | `GEMINI_API_KEY=`, remove `GOOGLE_GENAI_USE_GCA` | + +Assim o login global de cada CLI não é tocado: o modo chave só vale para a chamada. + +## O que conta como "indisponível" (dispara a reserva) + +Falha que não é culpa do pedido: limite de uso ou cota (`rate limit`, `429`, `quota`, `usage limit`, +`credit balance`), sobrecarga (`overloaded`, `529`, `503`, `unavailable`), login ou chave (`401`, `403`, +`unauthorized`, `not logged in`, `invalid api key`, `IneligibleTier`), rede (`ECONN`, `ETIMEDOUT`, `ENOTFOUND`, +`network`), CLI que não iniciou ou não foi encontrada, e tempo esgotado. Erro de conteúdo (JSON inválido, schema) +**não** troca de IA. + +## Gemini CLI em modo headless (0.68.0) + +- Agente: `gemini -p -o stream-json --approval-mode auto_edit --skip-trust [-m ] [--resume ]`. +- Eventos JSONL: `init {session_id, model}`, `message {role, content, delta}` (texto do assistente chega em + pedaços), `tool_use {tool_name, tool_id, parameters}`, `tool_result {tool_id, status, output, error}`, + `error {severity: warning|error, message}`, `result {status, error?, stats}`. +- Respostas estruturadas (juiz): `-o json` devolve `{"response": "", "stats": …}`; não há `--output-schema`, + então o schema vai no prompt e o JSON é extraído do texto. Leitura somente: `--approval-mode plan --skip-trust`, rodando numa pasta temporária fora do repositório (o `@arquivo` respeita o `.gitignore`). +- Modelos: `gemini models -o json` (não exige login). +- No Windows o npm instala `gemini.cmd`; rode `node /node_modules/@google/gemini-cli/bundle/gemini.js`. diff --git a/panel/src/app/accounts/page.tsx b/panel/src/app/accounts/page.tsx index 353ad76..8f19518 100644 --- a/panel/src/app/accounts/page.tsx +++ b/panel/src/app/accounts/page.tsx @@ -31,7 +31,7 @@ export default async function AccountsPage({ searchParams }: { searchParams: Pro description="Cada canal reúne os seus perfis no YouTube, no TikTok e no Instagram. Ligue histórias e fontes de corte a ele: o que você aprovar sai nas redes do canal." meta={<> }>Fila e horários em Publicações - }>Apps das redes e horários bons em Configurações + }>Apps das redes e horários bons em Configurações } />
diff --git a/panel/src/app/actions.ts b/panel/src/app/actions.ts index eda41e2..6e50a0a 100644 --- a/panel/src/app/actions.ts +++ b/panel/src/app/actions.ts @@ -7,7 +7,7 @@ import { addManualComments, closeDecision, decisionVotes } from "@/lib/decisions import { defaultModelFor, defaultProviderFor, startRun } from "@/lib/agents"; import { slugify } from "@/lib/paths"; import { UserError, createEpisode, createStory, deleteStory, getEpisodeById, getStory, provisionalTitle } from "@/lib/stories"; -import { CHOICES, type Choice, type Provider, type StoryKind } from "@/lib/types"; +import { CHOICES, PROVIDERS, type Choice, type Provider, type StoryKind } from "@/lib/types"; export type FormState = { error?: string; message?: string } | null; @@ -55,7 +55,7 @@ export async function createStoryFromTextAction(_prev: FormState, form: FormData // Documental é um vídeo só: sem título de episódio ("Abertura" só faz sentido numa série). const ep = createEpisode(story.id, { title: kind === "documentary" ? "" : "Abertura" }); const chosen = String(form.get("provider") ?? ""); - const provider: Provider = chosen === "claude" || chosen === "codex" ? chosen : defaultProviderFor("story"); + const provider: Provider = (PROVIDERS as string[]).includes(chosen) ? (chosen as Provider) : defaultProviderFor("story"); // Modelo escolhido no formulário; vazio = padrão da tarefa (no Codex, o do config.toml). startRun valida. const model = String(form.get("model") ?? "") || defaultModelFor("story", provider); const run = startRun({ diff --git a/panel/src/app/agent/page.tsx b/panel/src/app/agent/page.tsx index 376f8f2..3913f53 100644 --- a/panel/src/app/agent/page.tsx +++ b/panel/src/app/agent/page.tsx @@ -24,13 +24,13 @@ export default async function AgentPage({ searchParams }: { searchParams: Promis const defaults: AgentDefaults = { provider: map(defaultProviderFor), preferred: PREFERRED_PROVIDER, - model: map((k) => ({ claude: defaultModelFor(k, "claude"), codex: defaultModelFor(k, "codex") })), + model: map((k) => ({ claude: defaultModelFor(k, "claude"), codex: defaultModelFor(k, "codex"), gemini: defaultModelFor(k, "gemini") })), }; return ( <> + description="Peça uma história, um roteiro, uma cena ou um ajuste. Enredo e roteiro saem com o GPT (Codex); a cena, com o Claude. Se uma IA cair, a reserva assume (Configurações → IA). Um agente roda por vez, sempre dentro do projeto." />
}; + +async function mustProvider(ctx: Ctx): Promise { + const id = (await ctx.params).provider; + if (!(PROVIDERS as string[]).includes(id)) throw new UserError("IA desconhecida."); + return id as Provider; +} + +const payload = (refresh = false) => ({ settings: readAiSettings(), providers: providerStatus({ refresh }) }); + +/** + * Ações de uma IA: {action: "install" | "login" | "verify" | "test" | "resume"}. + * install — instala/atualiza a CLI em segundo plano (o log vem no GET /api/ai); + * login — abre um terminal com o login da CLI (OAuth no navegador); + * verify — refaz a detecção (depois do login ou da instalação); + * test — pergunta mínima para confirmar login/chave/cota (devolve {test}); + * resume — tira a IA da pausa da reserva. + */ +export async function POST(request: Request, ctx: Ctx) { + try { + const id = await mustProvider(ctx); + const { action } = await readJson<{ action: string }>(request); + switch (action) { + case "install": + startInstall(id); + return Response.json(payload()); + case "login": + openLoginTerminal(id); + return Response.json(payload()); + case "verify": + return Response.json(payload(true)); + case "test": { + const test = await testProvider(id); + return Response.json({ ...payload(), test }); + } + case "resume": + clearCooldown(id); + return Response.json(payload()); + default: + throw new UserError("Ação inválida."); + } + } catch (error) { + return errorResponse(error); + } +} + +/** Guarda a chave de API no cofre (DPAPI): {apiKey}. A resposta nunca traz a chave, só os 4 últimos caracteres. */ +export async function PUT(request: Request, ctx: Ctx) { + try { + const id = await mustProvider(ctx); + const { apiKey } = await readJson<{ apiKey: string }>(request); + if (typeof apiKey !== "string") throw new UserError("Cole a chave de API."); + setApiKey(id, apiKey); + return Response.json(payload()); + } catch (error) { + return errorResponse(error); + } +} + +/** Apaga a chave de API desta IA do cofre. */ +export async function DELETE(_request: Request, ctx: Ctx) { + try { + setApiKey(await mustProvider(ctx), null); + return Response.json(payload()); + } catch (error) { + return errorResponse(error); + } +} diff --git a/panel/src/app/api/ai/route.ts b/panel/src/app/api/ai/route.ts new file mode 100644 index 0000000..5012d99 --- /dev/null +++ b/panel/src/app/api/ai/route.ts @@ -0,0 +1,24 @@ +import { providerStatus, readAiSettings, updateAiSettings, type AiSettingsPatch } from "@/lib/ai"; +import { errorResponse, readJson } from "@/lib/http"; + +export const dynamic = "force-dynamic"; + +/** Estado das IAs: {settings, providers}. `?refresh=1` refaz a detecção (instalada, versão, login) na hora. */ +export async function GET(request: Request) { + try { + const refresh = new URL(request.url).searchParams.get("refresh") === "1"; + return Response.json({ settings: readAiSettings(), providers: providerStatus({ refresh }) }, { headers: { "Cache-Control": "no-store" } }); + } catch (error) { + return errorResponse(error); + } +} + +/** Atualiza só o que vier: {providers?: {?: {enabled?, authMode?}}, order?: [...], fallback?: {enabled?, cooldownMin?}}. */ +export async function PUT(request: Request) { + try { + const settings = updateAiSettings(await readJson(request)); + return Response.json({ settings, providers: providerStatus() }); + } catch (error) { + return errorResponse(error); + } +} diff --git a/panel/src/app/api/stories/route.ts b/panel/src/app/api/stories/route.ts index dea977b..ae5e213 100644 --- a/panel/src/app/api/stories/route.ts +++ b/panel/src/app/api/stories/route.ts @@ -5,7 +5,7 @@ import { defaultModelFor, defaultProviderFor, startRun } from "@/lib/agents"; import { errorResponse } from "@/lib/http"; import { slugify } from "@/lib/paths"; import { UserError, createEpisode, createStory, getStory, provisionalTitle } from "@/lib/stories"; -import { STORY_KINDS, type Provider, type StoryKind } from "@/lib/types"; +import { PROVIDERS, STORY_KINDS, type Provider, type StoryKind } from "@/lib/types"; export async function POST(request: Request) { try { @@ -20,7 +20,7 @@ export async function POST(request: Request) { for (let n = 2; getStory(id); n++) id = `${base}-${n}`; const story = createStory({ title, id, logline: "", kind, branchCount: 2 }); const ep = createEpisode(story.id, { title: kind === "documentary" ? "" : "Abertura" }); - const provider: Provider = body.provider === "claude" || body.provider === "codex" ? body.provider : defaultProviderFor("story"); + const provider: Provider = PROVIDERS.includes(body.provider as Provider) ? (body.provider as Provider) : defaultProviderFor("story"); const model = String(body.model ?? "") || defaultModelFor("story", provider); const run = startRun({ provider, model, kind: "story", request: text, storyId: story.id, episodeId: ep.id }); return Response.json({ storyId: story.id, episodeId: ep.id, runId: run.id }); diff --git a/panel/src/app/page.tsx b/panel/src/app/page.tsx index d6ce547..b7bae06 100644 --- a/panel/src/app/page.tsx +++ b/panel/src/app/page.tsx @@ -10,7 +10,7 @@ import { } from "@/components/ui"; import { defaultProviderFor, models, providers } from "@/lib/agents"; import { listEpisodes, listStories } from "@/lib/stories"; -import type { EpisodeView, Story } from "@/lib/types"; +import type { EpisodeView, Provider, Story } from "@/lib/types"; export default async function HomePage() { await connection(); @@ -18,7 +18,7 @@ export default async function HomePage() { const totalEpisodes = stories.reduce((sum, s) => sum + s.episodes.length, 0); const rendered = stories.reduce((sum, s) => sum + s.episodes.filter((e) => e.stage === "renderizado" || e.stage === "decidido").length, 0); const openVotes = stories.reduce((sum, s) => sum + (s.story.kind === "interactive" ? s.episodes.filter((e) => e.stage === "renderizado").length : 0), 0); - const available = Object.fromEntries(providers().map((p) => [p.id, p.available])) as Record<"claude" | "codex", boolean>; + const available = Object.fromEntries(providers().map((p) => [p.id, p.available])) as Record; return ( <> diff --git a/panel/src/app/publishing/page.tsx b/panel/src/app/publishing/page.tsx index 98a2a8c..4d233f8 100644 --- a/panel/src/app/publishing/page.tsx +++ b/panel/src/app/publishing/page.tsx @@ -16,7 +16,7 @@ export default function PublishingPage() { description="Tudo o que vai para as redes: o que espera a sua aprovação, o que está agendado, o que está saindo agora e o que já foi publicado." meta={<> }>Redes e regras em Canais de publicação - }>Horários bons em Configurações + }>Horários bons em Configurações }>O painel precisa estar aberto para publicar } /> diff --git a/panel/src/app/settings/ai/page.tsx b/panel/src/app/settings/ai/page.tsx new file mode 100644 index 0000000..f66350c --- /dev/null +++ b/panel/src/app/settings/ai/page.tsx @@ -0,0 +1,7 @@ +import { AiSettings } from "@/components/ai-settings"; + +export const metadata = { title: "IA · Configurações" }; + +export default function Page() { + return ; +} diff --git a/panel/src/app/settings/apps/page.tsx b/panel/src/app/settings/apps/page.tsx new file mode 100644 index 0000000..f6b2de1 --- /dev/null +++ b/panel/src/app/settings/apps/page.tsx @@ -0,0 +1,7 @@ +import { AppsTab } from "@/components/settings-panel"; + +export const metadata = { title: "Apps das redes · Configurações" }; + +export default function Page() { + return ; +} diff --git a/panel/src/app/settings/browser/page.tsx b/panel/src/app/settings/browser/page.tsx new file mode 100644 index 0000000..2cdedf2 --- /dev/null +++ b/panel/src/app/settings/browser/page.tsx @@ -0,0 +1,7 @@ +import { BrowserTab } from "@/components/settings-panel"; + +export const metadata = { title: "Navegador · Configurações" }; + +export default function Page() { + return ; +} diff --git a/panel/src/app/settings/layout.tsx b/panel/src/app/settings/layout.tsx new file mode 100644 index 0000000..fdd855f --- /dev/null +++ b/panel/src/app/settings/layout.tsx @@ -0,0 +1,9 @@ +import type { ReactNode } from "react"; +import { SettingsShell } from "@/components/settings-shell"; + +export const metadata = { title: "Configurações" }; + +/** Moldura comum das subpáginas de Configurações (IA, Publicação, Apps das redes, Navegador, Sobre os modos). */ +export default function SettingsLayout({ children }: { children: ReactNode }) { + return {children}; +} diff --git a/panel/src/app/settings/modes/page.tsx b/panel/src/app/settings/modes/page.tsx new file mode 100644 index 0000000..7453890 --- /dev/null +++ b/panel/src/app/settings/modes/page.tsx @@ -0,0 +1,7 @@ +import { ModesTab } from "@/components/settings-panel"; + +export const metadata = { title: "Sobre os modos · Configurações" }; + +export default function Page() { + return ; +} diff --git a/panel/src/app/settings/page.tsx b/panel/src/app/settings/page.tsx index 042946f..1bae63c 100644 --- a/panel/src/app/settings/page.tsx +++ b/panel/src/app/settings/page.tsx @@ -1,15 +1,6 @@ -import { SettingsPanel } from "@/components/settings-panel"; -import { PageHeader } from "@/components/ui"; +import { redirect } from "next/navigation"; -export const metadata = { title: "Configurações" }; - -/** Configurações do painel: publicação, apps das redes, navegador da sessão logada e a explicação dos modos. */ +/** /settings abre a primeira seção (IA); cada seção tem a própria página. */ export default function SettingsPage() { - return ( - <> - - - - ); + redirect("/settings/ai"); } diff --git a/panel/src/app/settings/publishing/page.tsx b/panel/src/app/settings/publishing/page.tsx new file mode 100644 index 0000000..c2a19d1 --- /dev/null +++ b/panel/src/app/settings/publishing/page.tsx @@ -0,0 +1,7 @@ +import { PublishingTab } from "@/components/settings-panel"; + +export const metadata = { title: "Publicação · Configurações" }; + +export default function Page() { + return ; +} diff --git a/panel/src/components/account-networks.tsx b/panel/src/components/account-networks.tsx index 6adae27..14246fa 100644 --- a/panel/src/components/account-networks.tsx +++ b/panel/src/components/account-networks.tsx @@ -308,7 +308,7 @@ export function PublishingRulesCard({ account, className }: { account: AccountVi { value: "best_slot", label: "No próximo horário bom", hint: "Mais gente vendo" }, ]} />

- Os horários bons de cada rede ficam em Configurações. Entre dois vídeos na mesma rede fica pelo menos 1 hora. + Os horários bons de cada rede ficam em Configurações. Entre dois vídeos na mesma rede fica pelo menos 1 hora.

diff --git a/panel/src/components/agent-console.tsx b/panel/src/components/agent-console.tsx index fa3365c..691ace7 100644 --- a/panel/src/components/agent-console.tsx +++ b/panel/src/components/agent-console.tsx @@ -27,8 +27,8 @@ const KINDS: { id: AgentKind; label: string; description: string; icon: Componen { id: "free", label: "Pedido livre", description: "Ajustes no projeto, testes, iluminação", icon: ChatIcon }, ]; -export const PROVIDER_LABEL: Record = { claude: "Claude Code", codex: "GPT · Codex" }; -const PROVIDER_SHORT: Record = { claude: "Claude", codex: "GPT" }; +export const PROVIDER_LABEL: Record = { claude: "Claude Code", codex: "GPT · Codex", gemini: "Gemini" }; +const PROVIDER_SHORT: Record = { claude: "Claude", codex: "GPT", gemini: "Gemini" }; const PLACEHOLDER: Record = { story: "Ex.: Um entregador recebe um pacote sem remetente; toda vez que tenta entregar, o endereço muda. Suspense leve com humor.", @@ -210,7 +210,7 @@ export function AgentConsole(props: { {/* 2. Agente */}
2 · Agente -
+
{props.providers.map((p) => ( chooseProvider(p.id)} /> @@ -334,7 +334,7 @@ function ProviderCard({ info, selected, recommended, onSelect }: {PROVIDER_LABEL[info.id]} {recommended && padrão desta tarefa} - {!info.available && não instalado} + {!info.available && não está pronto} {info.version && {info.version}} diff --git a/panel/src/components/ai-settings.tsx b/panel/src/components/ai-settings.tsx new file mode 100644 index 0000000..9bff182 --- /dev/null +++ b/panel/src/components/ai-settings.tsx @@ -0,0 +1,358 @@ +"use client"; +// Configurações → IA: as três CLIs (Claude Code, Codex/GPT e Gemini) num cartão cada — instalar/atualizar, ligar, +// entrar com a conta (OAuth, num terminal) ou colar a chave de API (cofre DPAPI), testar — e a IA reserva +// (troca sozinha quando uma cair, pausa e ordem). API: GET/PUT /api/ai e POST/PUT/DELETE /api/ai/[provider]. +import { useCallback, useEffect, useState, type ReactNode } from "react"; +import type { AiSettings, AuthMode, ProviderStatus, TestResult } from "@/lib/ai"; +import type { Provider } from "@/lib/types"; +import { CopyButton } from "./copy-button"; +import { AlertIcon, ArrowLeftIcon, CheckIcon, CpuIcon, DownloadIcon, KeyIcon, LinkIcon, PauseIcon, PlayIcon, RefreshIcon, TrashIcon, UsersIcon } from "./icons"; +import { Badge, Button, Card, ChoiceGroup, Feedback, Field, Input, Select, Spinner, Switch, cx, type Tone } from "./ui"; + +type Payload = { settings: AiSettings; providers: ProviderStatus[]; test?: TestResult }; +type Result = { ok: true; data: T } | { ok: false; error: string }; +type Message = { ok: boolean; text: string } | null; + +async function aiCall(path: string, method = "GET", body?: unknown): Promise> { + try { + const response = await fetch(`/api/ai${path}`, { + method, cache: "no-store", + headers: body === undefined ? undefined : { "Content-Type": "application/json" }, + body: body === undefined ? undefined : JSON.stringify(body), + }); + const data = (await response.json().catch(() => ({}))) as T & { error?: string }; + return response.ok ? { ok: true, data } : { ok: false, error: data.error ?? `Erro ${response.status}` }; + } catch { + return { ok: false, error: "O painel não respondeu." }; + } +} + +const COOLDOWN_OPTIONS = [5, 15, 30, 60, 120]; +const PROVIDER_TAGLINE: Record = { + claude: "Cena, Godot e ajustes no projeto. Mostra o custo em US$.", + codex: "GPT: enredo e roteiro por padrão. Usa a conta do ChatGPT.", + gemini: "Google. Boa reserva com chave do AI Studio (tem cota gratuita).", +}; + +const time = (iso: string) => new Date(iso).toLocaleTimeString("pt-BR", { hour: "2-digit", minute: "2-digit" }); + +/** Situação em uma palavra (badge do cartão e da ordem). */ +function statusBadge(p: ProviderStatus): { tone: Tone; text: string } { + if (!p.settings.enabled) return { tone: "neutral", text: "desligada" }; + if (!p.installed) return { tone: "warning", text: "não instalada" }; + if (!p.ready) return { tone: "warning", text: p.settings.authMode === "apiKey" ? "falta a chave" : "falta entrar" }; + if (p.cooldown) return { tone: "danger", text: `em pausa até ${time(p.cooldown.until)}` }; + return { tone: "success", text: "pronta" }; +} + +export function AiSettings() { + const [data, setData] = useState(null); + const [error, setError] = useState(null); + + const load = useCallback(async (refresh = false) => { + const r = await aiCall(refresh ? "?refresh=1" : ""); + if (r.ok) { setData(r.data); setError(null); } else setError(r.error); + }, []); + useEffect(() => { void load(); }, [load]); + + // Instalação em andamento: relê a cada 2 s para mostrar o log. + const installing = data?.providers.some((p) => p.install?.status === "running") ?? false; + useEffect(() => { + if (!installing) return; + const timer = setInterval(() => void load(), 2000); + return () => clearInterval(timer); + }, [installing, load]); + + if (error && !data) { + return ( +
+ Não deu para ler as IAs: {error} + +
+ ); + } + if (!data) return

Procurando as CLIs neste computador…

; + + const readyCount = data.providers.filter((p) => p.ready).length; + const byId = Object.fromEntries(data.providers.map((p) => [p.id, p])) as Record; + + return ( +
+ {readyCount === 0 && ( + Nenhuma IA está pronta. Instale pelo menos uma abaixo e entre com a conta (ou cole uma chave de API). + )} + +
+
+
+

As IAs deste computador

+

+ Cada uma roda pela CLI oficial. Conta usa a assinatura em que você já paga + (login no navegador); chave de API cobra por uso e fica cifrada neste PC. +

+
+ +
+
+ {data.settings.order.map((id) => )} +
+
+
+ ); +} + +/* ---------- Reserva ---------- */ + +function FallbackCard({ data, onChange }: { data: Payload; onChange: (next: Payload) => void }) { + const { settings } = data; + const [busy, setBusy] = useState(null); + const [message, setMessage] = useState(null); + const byId = Object.fromEntries(data.providers.map((p) => [p.id, p])) as Record; + + async function save(key: string, patch: Partial<{ order: Provider[]; fallback: Partial }>, ok: string) { + setBusy(key); + setMessage(null); + const r = await aiCall("", "PUT", patch); + setBusy(null); + if (r.ok) { onChange(r.data); setMessage({ ok: true, text: ok }); } else setMessage({ ok: false, text: r.error }); + } + + function move(index: number, delta: -1 | 1) { + const order = [...settings.order]; + const [item] = order.splice(index, 1); + order.splice(index + delta, 0, item); + void save(`move-${item}`, { order }, "Ordem salva."); + } + + return ( + IA reserva} title="Se uma IA cair, a próxima assume" + description="Vale para os agentes do painel e para o juiz do Clipador. A tarefa começa na IA escolhida (ou na preferida dela); se falhar por limite de uso, login, chave ou rede, recomeça na próxima pronta desta lista. Erro do pedido em si não troca de IA."> +
+
+ void save("enabled", { fallback: { enabled } }, enabled ? "Reserva ligada." : "Reserva desligada.")} /> + + + +
+
+ Ordem de uso +
    + {settings.order.map((id, index) => { + const p = byId[id]; + const badge = statusBadge(p); + return ( +
  1. + {index + 1} + {p.label} + {badge.text} + + + + +
  2. + ); + })} +
+

IA desligada ou sem login/chave é pulada.

+
+
+ {message &&
{message.text}
} +
+ ); +} + +/* ---------- Cartão de cada IA ---------- */ + +function ProviderCard({ status: p, onChange }: { status: ProviderStatus; onChange: (next: Payload) => void }) { + const [busy, setBusy] = useState(null); + const [message, setMessage] = useState(null); + const [key, setKey] = useState(""); + const badge = statusBadge(p); + + async function act(name: string, call: () => Promise>, ok?: (data: Payload) => string) { + setBusy(name); + setMessage(null); + const r = await call(); + setBusy(null); + if (!r.ok) { setMessage({ ok: false, text: r.error }); return false; } + onChange(r.data); + if (ok) setMessage({ ok: true, text: ok(r.data) }); + return true; + } + const post = (action: string) => () => aiCall(`/${p.id}`, "POST", { action }); + + return ( +
+
+
+
+

+ {p.label}{p.vendor} +

+

{PROVIDER_TAGLINE[p.id]}

+
+ {badge.text} +
+ void act("enabled", () => aiCall("", "PUT", { providers: { [p.id]: { enabled } } }))} /> +
+ + void act("install", post("install"))} /> + + {p.installed && ( +
+ name={`auth-${p.id}`} legend="Como entra" value={p.settings.authMode} + onChange={(authMode) => void act("auth", () => aiCall("", "PUT", { providers: { [p.id]: { authMode } } }))} + options={[ + { value: "oauth", label: Conta }, + { value: "apiKey", label: Chave de API }, + ]} /> + {p.settings.authMode === "oauth" + ? void act("login", post("login"), () => "Abrimos um terminal com o login. Termine no navegador e clique em Verificar.")} + onVerify={() => void act("verify", post("verify"), (d) => d.providers.find((x) => x.id === p.id)?.oauth.detail || "Verificado.")} /> + : void act("key", () => aiCall(`/${p.id}`, "PUT", { apiKey: key }), () => "Chave salva no cofre deste PC.").then((ok) => ok && setKey(""))} + onRemove={() => void act("remove", () => aiCall(`/${p.id}`, "DELETE"), () => "Chave apagada.")} />} +
+ )} + + {p.installed && p.settings.enabled && ( +
+ {p.cooldown && ( +
+ Em pausa até {time(p.cooldown.until)}: {p.cooldown.reason} + +
+ )} +
+ + Faz uma pergunta mínima (poucos tokens) fora do projeto. +
+ {p.lastTest && ( +

+ {p.lastTest.ok ? "Funcionou" : "Falhou"} às {time(p.lastTest.at)} · {(p.lastTest.ms / 1000).toFixed(1)} s · {p.lastTest.text} +

+ )} +
+ )} + + {message && {message.text}} +
+ ); +} + +function InstallSection({ p, busy, onInstall }: { p: ProviderStatus; busy: string | null; onInstall: () => void }) { + const job = p.install; + const running = job?.status === "running"; + return ( +
+ {p.installed ? ( +
+
+ Instalada + {p.version} +
+ +
+ ) : ( +
+

A CLI não foi encontrada neste computador.

+
+ {p.meta.installCommand} + +
+ +
+ )} + {job && (job.status !== "success" || !p.installed) && ( +
+ + {job.status === "running" ? "Instalando…" : job.status === "success" ? "Instalação concluída" : "A instalação falhou"} · log + +
{job.log.slice(-40).join("\n")}
+
+ )} + {job?.status === "success" && !p.installed && ( + Instalou, mas o painel ainda não acha a CLI (o PATH dele é o de quando abriu). Clique em "Procurar de novo" ou reinicie o pnpm panel. + )} +
+ ); +} + +function OAuthSection({ p, busy, onLogin, onVerify }: { p: ProviderStatus; busy: string | null; onLogin: () => void; onVerify: () => void }) { + const tone = p.oauth.state === "yes" ? "text-success" : p.oauth.state === "no" ? "text-warning" : "text-fg-muted"; + return ( +
+

{p.meta.oauthLabel}. O login é feito pela própria CLI: o painel nunca vê a senha.

+ {p.oauth.detail &&

{p.oauth.detail}

} + {p.meta.oauthNote && ( +

+ {p.meta.oauthNote} +

+ )} +
+ {p.meta.canLogin && ( + + )} + +
+
+ ); +} + +function ApiKeySection({ p, busy, value, onValue, onSave, onRemove }: { + p: ProviderStatus; busy: string | null; value: string; onValue: (v: string) => void; onSave: () => void; onRemove: () => void; +}) { + return ( +
{ e.preventDefault(); onSave(); }}> + {p.apiKey.saved && ( +
+ Chave salva {p.apiKey.hint} + +
+ )} + Fica cifrada neste PC (DPAPI do Windows) e nunca volta para a tela. Vai para a CLI como {p.meta.apiKeyEnv} só na hora da chamada.}> + onValue(e.target.value)} placeholder="Cole a chave aqui" /> + +
+ + Criar uma chave +
+
+ ); +} + +function ExternalLink({ href, children }: { href: string; children: ReactNode }) { + return ( + + {children} + + ); +} diff --git a/panel/src/components/connect-wizard.tsx b/panel/src/components/connect-wizard.tsx index f2603fc..ae0d919 100644 --- a/panel/src/components/connect-wizard.tsx +++ b/panel/src/components/connect-wizard.tsx @@ -341,7 +341,7 @@ export function ConnectWizard({ accountId, accountName, platform, network, recon )}
- {error && {error}{/app|client/i.test(error) && <> Veja Configurações › Apps das redes.}} + {error && {error}{/app|client/i.test(error) && <> Veja Configurações › Apps das redes.}}
)} @@ -417,7 +417,7 @@ function ModeCard({ platform, mode, checked, appMissing, onSelect }: { {appMissing && ( - O app do {label} ainda não foi configurado. Faça isso antes em Configurações › Apps das redes. + O app do {label} ainda não foi configurado. Faça isso antes em Configurações › Apps das redes. )} diff --git a/panel/src/components/dashboard-controls.tsx b/panel/src/components/dashboard-controls.tsx index fe7782e..9e110c5 100644 --- a/panel/src/components/dashboard-controls.tsx +++ b/panel/src/components/dashboard-controls.tsx @@ -132,7 +132,7 @@ export function MetricsSyncControls({ syncs, accountId, everyHours, showAccount

Números das redes

{everyHours > 0 ? `O painel lê sozinho a cada ${everyHours} h (com o painel aberto).` : "Leitura automática desligada: só pelo botão."}{" "} - Muda em Configurações. + Muda em Configurações. TikTok e Instagram abrem a janela do navegador por alguns segundos.

diff --git a/panel/src/components/publishing-board.tsx b/panel/src/components/publishing-board.tsx index acfa432..df2d139 100644 --- a/panel/src/components/publishing-board.tsx +++ b/panel/src/components/publishing-board.tsx @@ -251,7 +251,7 @@ export function PublishingBoard() { action={}> - Nada sai para as redes até você retomar. Dá para aprovar e agendar normalmente. A pausa também fica em Configurações. + Nada sai para as redes até você retomar. Dá para aprovar e agendar normalmente. A pausa também fica em Configurações. )}
diff --git a/panel/src/components/settings-panel.tsx b/panel/src/components/settings-panel.tsx index 718f518..32bf625 100644 --- a/panel/src/components/settings-panel.tsx +++ b/panel/src/components/settings-panel.tsx @@ -1,11 +1,12 @@ "use client"; -// Configurações do painel (por enquanto, tudo da publicação nas redes), em abas: -// Publicação — pausar tudo, horários bons por rede, fuso e de quanto em quanto tempo ler os números dos posts -// (GET/PUT /api/settings); -// Apps das redes — passo a passo para criar o app de cada rede e os campos Client ID/Secret -// (GET/PUT/DELETE /api/settings/apps/[platform]); o segredo nunca volta para a tela; -// Navegador — navegador encontrado pelo Publicador (modo sessão) e onde ficam as sessões; -// Sobre os modos — comparação simples entre "Conta oficial (API)" e "Sessão logada". +// Seções de Configurações da publicação nas redes, cada uma numa subpágina (/settings/, ver settings-shell.tsx): +// PublishingTab — pausar tudo, horários bons por rede, fuso e de quanto em quanto tempo ler os números dos posts +// (GET/PUT /api/settings); +// AppsTab — passo a passo para criar o app de cada rede e os campos Client ID/Secret +// (GET/PUT/DELETE /api/settings/apps/[platform]); o segredo nunca volta para a tela; +// BrowserTab — navegador encontrado pelo Publicador (modo sessão) e onde ficam as sessões; +// ModesTab — comparação simples entre "Conta oficial (API)" e "Sessão logada". +// A seção de IA fica em ai-settings.tsx. import { useCallback, useEffect, useState, type FormEvent, type ReactNode } from "react"; import type { Platform } from "@/lib/types"; import { askConfirm } from "./confirm-dialog"; @@ -17,10 +18,8 @@ import { type AppState, type PublisherStatus, type AppSettings, } from "./publishing-client"; import { NoticeBar, PlatformName, TextLink } from "./publishing-ui"; -import { Tabs } from "./tabs"; import { Badge, Button, Card, Feedback, Field, Input, Select, Spinner, Switch, Table, Td, Th, THead, Tr, cx } from "./ui"; -type TabId = "publicacao" | "apps" | "navegador" | "modos"; type Message = { ok: boolean; text: string } | null; /** Ordem de exibição das redes nestas telas (a mais usada primeiro). */ @@ -35,27 +34,9 @@ const TIMEZONES: { value: string; label: string }[] = [ { value: "UTC", label: "UTC" }, ]; -export function SettingsPanel() { - return ( - label="Seções das configurações" - items={[ - { id: "publicacao", label: "Publicação", icon: }, - { id: "apps", label: "Apps das redes", icon: }, - { id: "navegador", label: "Navegador", icon: }, - { id: "modos", label: "Sobre os modos", icon: }, - ]} - panels={{ - publicacao: , - apps: , - navegador: , - modos: , - }} /> - ); -} - /* ---------- Publicação ---------- */ -function PublishingTab() { +export function PublishingTab() { const [settings, setSettings] = useState(null); const [draft, setDraft] = useState(null); const [error, setError] = useState(null); @@ -244,7 +225,7 @@ const GUIDES: Record<"youtube" | "tiktok", Guide> = { }, }; -function AppsTab() { +export function AppsTab() { return (

@@ -403,7 +384,7 @@ function ExternalLink({ href, children }: { href: string; children: ReactNode }) /* ---------- Navegador ---------- */ -function BrowserTab() { +export function BrowserTab() { const [status, setStatus] = useState(null); const [busy, setBusy] = useState(false); const load = useCallback(async () => { @@ -474,7 +455,7 @@ const MODES_TABLE: Record = }, }; -function ModesTab() { +export function ModesTab() { return (

), para dar link direto (ex.: "Configurações → IA"). +import Link from "next/link"; +import { usePathname } from "next/navigation"; +import type { ComponentType, ReactNode } from "react"; +import { ClockIcon, CpuIcon, GlobeIcon, InfoIcon, KeyIcon } from "./icons"; +import { PageHeader, cx } from "./ui"; + +export type SettingsSection = { href: string; label: string; hint: string; description: string; icon: ComponentType<{ size?: number }> }; + +export const SETTINGS_SECTIONS: SettingsSection[] = [ + { href: "/settings/ai", label: "IA", hint: "Claude, GPT e Gemini", icon: CpuIcon, + description: "Quais IAs o CenaForge usa, como cada uma entra (conta ou chave de API) e a ordem da reserva quando uma cair." }, + { href: "/settings/publishing", label: "Publicação", hint: "Horários e pausa", icon: ClockIcon, + description: "Pausar tudo, os horários bons de cada rede, o fuso e de quanto em quanto tempo ler os números dos posts." }, + { href: "/settings/apps", label: "Apps das redes", hint: "Client ID e Secret", icon: KeyIcon, + description: "O app de cada rede para publicar pela conta oficial (API). O segredo fica no cofre e nunca volta para a tela." }, + { href: "/settings/browser", label: "Navegador", hint: "Sessão logada", icon: GlobeIcon, + description: "O navegador que o Publicador usa no modo sessão logada e onde ficam as sessões." }, + { href: "/settings/modes", label: "Sobre os modos", hint: "API × sessão logada", icon: InfoIcon, + description: "Comparação simples entre publicar pela conta oficial (API) e pela sessão logada." }, +]; + +export function activeSettingsSection(pathname: string): SettingsSection | null { + return SETTINGS_SECTIONS.find((s) => pathname === s.href || pathname.startsWith(`${s.href}/`)) ?? null; +} + +export function SettingsShell({ children }: { children: ReactNode }) { + const pathname = usePathname(); + const current = activeSettingsSection(pathname); + return ( +
+ + + {children} +
+ ); +} diff --git a/panel/src/components/sidebar-nav.tsx b/panel/src/components/sidebar-nav.tsx index e198f09..5b4cecf 100644 --- a/panel/src/components/sidebar-nav.tsx +++ b/panel/src/components/sidebar-nav.tsx @@ -14,6 +14,7 @@ import { CLIPPER_SECTIONS, activeSection } from "./clipper-shell"; import { ChartIcon, CubeIcon, FilmIcon, MicIcon, PublishIcon, ScissorsIcon, SettingsIcon, SparkIcon, TerminalIcon, UsersIcon } from "./icons"; import { LogoMark, Wordmark } from "./logo"; import { getSummary } from "./publishing-client"; +import { SETTINGS_SECTIONS, activeSettingsSection } from "./settings-shell"; import { cx } from "./ui"; type SubItem = { href: string; label: string; icon?: ComponentType<{ size?: number }> }; @@ -39,7 +40,7 @@ const NAV: NavItem[] = [ { href: "/characters", label: "Personagens", hint: "Elenco reaproveitável", icon: UsersIcon }, { href: "/assets", label: "Assets", hint: "Biblioteca e envios", icon: CubeIcon }, { href: "/voices", label: "Vozes", hint: "Narração e legenda", icon: MicIcon }, - { href: "/agent", label: "Agente", hint: "Claude e Codex", icon: TerminalIcon }, + { href: "/agent", label: "Agente", hint: "Claude, GPT e Gemini", icon: TerminalIcon }, ]; /** Depois do estúdio: onde as histórias vão ao ar. */ @@ -48,7 +49,11 @@ const DISTRIBUTION: NavItem[] = [ { href: "/publishing", label: "Publicações", hint: "Aprovar, agendar, acompanhar", icon: PublishIcon }, ]; -const SETTINGS: NavItem = { href: "/settings", label: "Configurações", hint: "Horários, apps e navegador", icon: SettingsIcon }; +const SETTINGS: NavItem = { + href: "/settings", label: "Configurações", hint: "IA, publicação e navegador", icon: SettingsIcon, + children: SETTINGS_SECTIONS.map((s) => ({ href: s.href, label: s.label, icon: s.icon })), + activeChild: (pathname) => activeSettingsSection(pathname)?.href ?? null, +}; function useAwaitingCount(pathname: string): number | null { const [count, setCount] = useState(null); diff --git a/panel/src/components/story-composer.tsx b/panel/src/components/story-composer.tsx index 905e623..6868034 100644 --- a/panel/src/components/story-composer.tsx +++ b/panel/src/components/story-composer.tsx @@ -13,7 +13,7 @@ import { Button, ChoiceGroup, Feedback, Input, Kbd, Select, Spinner, Textarea, c const MIN_CHARS = 20; const MAX_CHARS = 20_000; -const PROVIDER_NAME: Record = { codex: "GPT · Codex", claude: "Claude" }; +const PROVIDER_NAME: Record = { codex: "GPT · Codex", claude: "Claude", gemini: "Gemini" }; export function StoryComposer({ autoProvider, available, models }: { /** Agente que o modo automático vai usar agora (Codex, se estiver instalado). */ @@ -24,11 +24,12 @@ export function StoryComposer({ autoProvider, available, models }: { }) { const [state, action, pending] = useActionState(createStoryFromTextAction, null); const [length, setLength] = useState(0); - const [provider, setProvider] = useState<"" | "claude">(""); + const [provider, setProvider] = useState<"" | Provider>(""); const [kind, setKind] = useState(DEFAULT_STORY_FORMAT); const [model, setModel] = useState(""); const short = length > 0 && length < MIN_CHARS; - const engine: Provider = provider === "claude" ? "claude" : autoProvider; + const engine: Provider = provider || autoProvider; + const noneReady = !Object.values(available).some(Boolean); const documentary = kind === "documentary"; return ( @@ -85,8 +86,9 @@ export function StoryComposer({ autoProvider, available, models }: { { setProvider(next); setModel(""); }} options={[ - { value: "", label: autoProvider === "codex" ? "GPT · Codex" : "Automático" }, - { value: "claude", label: "Claude", disabled: !available.claude }, + { value: "", label: `Automático (${PROVIDER_NAME[autoProvider]})` }, + ...(["claude", "codex", "gemini"] as const).filter((p) => p !== autoProvider) + .map((p) => ({ value: p, label: PROVIDER_NAME[p], disabled: !available[p] })), ]} />
- {!available.codex && ( -

O Codex não está instalado aqui: o modo automático vai usar o Claude. Instale com npm install -g @openai/codex e rode codex login.

+ {noneReady ? ( +

Nenhuma IA está pronta neste computador. Instale e entre com a conta (ou cole uma chave) em Configurações → IA.

+ ) : !available.codex && ( +

O Codex não está pronto: o automático usa {PROVIDER_NAME[autoProvider]}. Ajuste em Configurações → IA.

)}
diff --git a/panel/src/lib/agents.ts b/panel/src/lib/agents.ts index 2a7a262..d99b387 100644 --- a/panel/src/lib/agents.ts +++ b/panel/src/lib/agents.ts @@ -1,4 +1,5 @@ -// Agentes de código (Claude Code e Codex) chamados pela CLI, como no VS Code. +// Agentes de código (Claude Code, Codex e Gemini) chamados pela CLI, como no VS Code. +// Instalação, login/chave e a IA reserva ficam em lib/ai.ts (Configurações → IA). // // Segurança (decisão do usuário: "edita sozinho no projeto"): // - roda com cwd = raiz do repositório; edições automáticas só dentro dele; @@ -6,13 +7,16 @@ // - o pedido vai como argumento (sem shell); stdin fechado; // - um agente por vez; cancelar encerra a árvore de processos. // Comentários do público NUNCA entram no prompt: só a decisão A/B já fechada. -import { spawn, spawnSync, type ChildProcess } from "node:child_process"; +import { spawn, type ChildProcess } from "node:child_process"; import fs from "node:fs"; import path from "node:path"; import { all, get, now, run } from "./db"; import { DATA_DIR, REPO_ROOT, rel } from "./paths"; import { buildPrompt } from "./prompts"; -import { findOnPath, killTree, lineSplitter } from "./proc"; +import { + PROVIDER_META, geminiModels, isAvailabilityError, markUnavailable, nextFallback, providerEnv, providerStatus, readyChain, resolvedFor, +} from "./ai"; +import { killTree, lineSplitter } from "./proc"; import { onAgentRunClosed } from "./branches"; import { UserError, getEpisodeById, getStory, syncStoryMeta } from "./stories"; import { AGENT_KINDS, type AgentEvent, type AgentKind, type AgentRun, type Provider } from "./types"; @@ -92,7 +96,7 @@ function codexModels(): ModelOption[] { /** Modelos que o seletor oferece por agente. */ export function models(): Record { - return { claude: CLAUDE_MODELS, codex: codexModels() }; + return { claude: CLAUDE_MODELS, codex: codexModels(), gemini: [{ id: "", label: "Padrão da CLI (automático)" }, ...geminiModels()] }; } /** Modelo sugerido por tipo de tarefa (economia de tokens). */ @@ -106,15 +110,14 @@ export const DEFAULT_MODEL: Record = { free: "", story: "", s */ export const PREFERRED_PROVIDER: Record = { free: "claude", story: "codex", script: "codex", scene: "claude", branches: "codex", godot: "claude", character: "claude" }; +/** A preferida da tarefa se estiver pronta (e fora de pausa); senão a próxima da ordem da reserva. */ export function defaultProviderFor(kind: AgentKind): Provider { - const list = providers(); - const preferred = PREFERRED_PROVIDER[kind]; - if (list.find((p) => p.id === preferred)?.available) return preferred; - return list.find((p) => p.available)?.id ?? preferred; + return readyChain(PREFERRED_PROVIDER[kind])[0] ?? PREFERRED_PROVIDER[kind]; } /** Modelo padrão: o do tipo de tarefa só vale para o Claude; no Codex, o do config.toml. */ export function defaultModelFor(kind: AgentKind, provider: Provider): string { + if (provider === "gemini") return ""; return provider === "claude" ? DEFAULT_MODEL[kind] : CODEX_DEFAULT_MODEL[kind]; } @@ -125,11 +128,8 @@ export function defaultModelFor(kind: AgentKind, provider: Provider): string { */ const CODEX_DEFAULT_MODEL: Record = { free: "", story: "gpt-6.1-sol", script: "gpt-6.1-sol", branches: "gpt-6.1-sol", scene: "", godot: "", character: "" }; -/** `command` + `prefixArgs` é o que de fato executamos (ex.: node + codex.js no Windows). */ -type ProviderInfo = { - id: Provider; available: boolean; path: string | null; version: string | null; note: string; - command: string | null; prefixArgs: string[]; -}; +/** Uma IA como o console do agente a vê. `available` = pronta (ligada, instalada e com login ou chave). */ +type ProviderInfo = { id: Provider; available: boolean; path: string | null; version: string | null; note: string }; /** * Execução em andamento. `followUp`: mensagem do usuário enviada durante a execução; quando ela * fecha (sozinha ou interrompida), a mesma sessão é retomada com essa mensagem. @@ -141,8 +141,10 @@ type ActiveRun = { followUp: string | null; /** O agente já deu um passo (texto ou ferramenta). Antes disso a sessão ainda não guardou o pedido. */ progressed: boolean; + /** Últimas linhas de erro (stderr e eventos de erro): decidem se a falha foi indisponibilidade. */ + errors: string[]; }; -const g = globalThis as unknown as { __cenaforgeAgents?: Map; __cenaforgeProviders?: { at: number; list: ProviderInfo[] } }; +const g = globalThis as unknown as { __cenaforgeAgents?: Map }; const active = (g.__cenaforgeAgents ??= new Map()); /** Há um agente trabalhando? (o executor roda um por vez) */ @@ -150,52 +152,23 @@ export function busy(): boolean { return active.size > 0; } -/** - * Executável de um provedor. No Windows o npm instala o Codex como `codex.cmd` (que o Node - * não executa sem shell); nesse caso rodamos o `codex.js` do pacote diretamente pelo Node. - */ -function resolveCommand(id: Provider, envVar: string): { path: string; command: string; prefixArgs: string[] } | null { - const fromEnv = process.env[envVar]; - if (fromEnv) { - return fromEnv.endsWith(".js") - ? { path: fromEnv, command: process.execPath, prefixArgs: [fromEnv] } - : { path: fromEnv, command: fromEnv, prefixArgs: [] }; - } - const exe = findOnPath(id); - if (exe) return { path: exe, command: exe, prefixArgs: [] }; - if (id === "codex") { - for (const dir of (process.env.PATH ?? "").split(path.delimiter).filter(Boolean)) { - const js = path.join(dir, "node_modules", "@openai", "codex", "bin", "codex.js"); - if (fs.existsSync(path.join(dir, "codex.cmd")) && fs.existsSync(js)) { - return { path: js, command: process.execPath, prefixArgs: [js] }; - } - } - } - return null; -} +const PROVIDER_NOTE: Record = { + claude: "Claude Code CLI em modo não interativo (-p, stream-json); edição automática dentro do projeto e comandos liberados.", + codex: "Codex CLI (codex exec --json) com sandbox workspace-write: escreve só dentro do projeto.", + gemini: "Gemini CLI (-p, stream-json) com edição automática; comandos de shell só os liberados (render e testes).", +}; +/** As três IAs para o console: o estado vem de lib/ai.ts (instalada, ligada, login/chave, pausa da reserva). */ export function providers(): ProviderInfo[] { - // Cache curto: instalar ou remover uma CLI aparece sem reiniciar o painel. - if (g.__cenaforgeProviders && Date.now() - g.__cenaforgeProviders.at < 60_000) return g.__cenaforgeProviders.list; - const detect = (id: Provider, envVar: string, note: string): ProviderInfo => { - const resolved = resolveCommand(id, envVar); - let version: string | null = null; - if (resolved) { - const r = spawnSync(resolved.command, [...resolved.prefixArgs, "--version"], { encoding: "utf8", timeout: 20_000, windowsHide: true, shell: false }); - version = r.status === 0 ? r.stdout.trim().split(/\r?\n/)[0] : null; - } + return providerStatus().map((p) => { + const pause = p.cooldown + ? ` Em pausa até ${new Date(p.cooldown.until).toLocaleTimeString("pt-BR", { hour: "2-digit", minute: "2-digit" })} (${p.cooldown.reason}).` + : ""; return { - id, available: !!resolved && version !== null, path: resolved?.path ?? null, version, - note: resolved ? note : `${note} Não encontrado: instale e faça login${id === "codex" ? " (npm install -g @openai/codex; codex login)" : ""}.`, - command: resolved?.command ?? null, prefixArgs: resolved?.prefixArgs ?? [], + id: p.id, available: p.ready, path: p.path, version: p.version, + note: p.ready ? `${PROVIDER_NOTE[p.id]}${pause}` : `${PROVIDER_NOTE[p.id]} ${p.problem} Ajuste em Configurações → IA.`, }; - }; - const list = [ - detect("claude", "CLAUDE_BIN", "Claude Code CLI em modo não interativo (-p, stream-json); edição automática dentro do projeto e comandos liberados."), - detect("codex", "CODEX_BIN", "Codex CLI (codex exec --json) com sandbox workspace-write: escreve só dentro do projeto."), - ]; - g.__cenaforgeProviders = { at: Date.now(), list }; - return list; + }); } export function listRuns(limit = 30): AgentRun[] { @@ -209,9 +182,14 @@ export function getRun(id: number): AgentRun | undefined { export function startRun(input: { provider: Provider; model: string; kind: AgentKind; request: string; storyId?: string | null; episodeId?: number | null; resumeRunId?: number | null; + /** Execução que caiu por indisponibilidade e que esta continua com a IA reserva. */ + fallbackOfRunId?: number | null; }): AgentRun { const info = providers().find((p) => p.id === input.provider); - if (!info?.available || !info.command) throw new UserError(`${input.provider} não está disponível neste computador.`); + const resolved = resolvedFor(input.provider); + if (!info?.available || !resolved) { + throw new UserError(`${PROVIDER_META[input.provider]?.label ?? input.provider} não está pronto neste computador. ${info?.note ?? ""}`.trim()); + } if (active.size > 0) throw new UserError("Já existe um agente trabalhando. Aguarde ou cancele antes de enviar outro pedido."); const request = input.request.trim(); if (request.length < 2) throw new UserError("Escreva o pedido."); @@ -230,12 +208,18 @@ export function startRun(input: { throw new UserError("Só é possível continuar uma conversa do mesmo agente, com sessão registrada."); } - const prompt = resume ? request : buildPrompt({ kind: input.kind, provider: input.provider, request, story, episode }); + const fallbackOf = input.fallbackOfRunId ? getRun(input.fallbackOfRunId) : undefined; + const basePrompt = resume ? request : buildPrompt({ kind: input.kind, provider: input.provider, request, story, episode }); + // Reserva: a IA anterior pode ter deixado arquivos pela metade; a nova confere antes de refazer. + const prompt = fallbackOf + ? `${basePrompt}\n\nObservação: esta tarefa começou com outra IA (${PROVIDER_META[fallbackOf.provider].label}), que parou por indisponibilidade. ` + + "Confira o estado atual dos arquivos citados antes de criar ou refazer algo e continue de onde ela parou." + : basePrompt; const logDir = path.join(DATA_DIR, "logs", "agents"); fs.mkdirSync(logDir, { recursive: true }); - const row = run(`INSERT INTO agent_runs (provider, model, kind, prompt, story_id, episode_id, resume_of, status, log_path, started_at) - VALUES (?, ?, ?, ?, ?, ?, ?, 'running', '', ?)`, - input.provider, input.model, input.kind, request, story?.id ?? null, episode?.id ?? null, resume?.id ?? null, now()); + const row = run(`INSERT INTO agent_runs (provider, model, kind, prompt, story_id, episode_id, resume_of, fallback_of, status, log_path, started_at) + VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'running', '', ?)`, + input.provider, input.model, input.kind, request, story?.id ?? null, episode?.id ?? null, resume?.id ?? null, fallbackOf?.id ?? null, now()); const id = Number(row.lastInsertRowid); const logPath = path.join(logDir, `${id}.jsonl`); run("UPDATE agent_runs SET log_path = ? WHERE id = ?", rel(logPath), id); @@ -246,20 +230,31 @@ export function startRun(input: { ...(resume?.session_id ? ["--resume", resume.session_id] : []), ...CLAUDE_LEAN_FLAGS, "--max-budget-usd", String(CLAUDE_BUDGET_USD[input.kind]), "--allowedTools", CLAUDE_ALLOWED_TOOLS] - : codexArgs(prompt, input.model, resume?.session_id ?? null, input.kind); + : input.provider === "codex" + ? codexArgs(prompt, input.model, resume?.session_id ?? null, input.kind) + : geminiArgs(prompt, input.model, resume?.session_id ?? null); - const child = spawn(info.command, [...info.prefixArgs, ...args], { cwd: REPO_ROOT, shell: false, windowsHide: true, stdio: ["ignore", "pipe", "pipe"] }); + // providerEnv: chave de API só nesta chamada (modo "chave") ou nenhuma (modo "conta"); ver doc/ia.md. + const child = spawn(resolved.command, [...resolved.prefixArgs, ...args], { + cwd: REPO_ROOT, shell: false, windowsHide: true, stdio: ["ignore", "pipe", "pipe"], env: providerEnv(input.provider), + }); const listeners = new Set<(e: AgentEvent | null) => void>(); const log = fs.createWriteStream(logPath); + const gemini: GeminiState = { text: "" }; const emit = (e: Omit) => { if (e.kind !== "system" && e.kind !== "stderr" && e.kind !== "error") entry.progressed = true; + if (e.kind === "stderr" || e.kind === "error" || (e.kind === "result" && e.isError)) { + entry.errors.push(e.text); + if (entry.errors.length > 20) entry.errors.shift(); + } const event = { ...e, at: now() } as AgentEvent; log.write(JSON.stringify(event) + "\n"); for (const l of listeners) l(event); }; - const entry: ActiveRun = { child, listeners, emit, followUp: null, progressed: false }; + const entry: ActiveRun = { child, listeners, emit, followUp: null, progressed: false, errors: [] }; active.set(id, entry); - emit({ kind: "system", text: `${input.provider}${input.model ? ` · ${input.model}` : ""} · tarefa "${input.kind}"${resume ? ` · continua a execução #${resume.id}` : ""}` }); + emit({ kind: "system", text: `${input.provider}${input.model ? ` · ${input.model}` : ""} · tarefa "${input.kind}"` + + `${resume ? ` · continua a execução #${resume.id}` : ""}${fallbackOf ? ` · reserva da execução #${fallbackOf.id}` : ""}` }); child.stdout.setEncoding("utf8").on("data", lineSplitter((line) => { let obj: Record; @@ -269,7 +264,8 @@ export function startRun(input: { emit({ kind: "text", text: line.slice(0, 2000) }); return; } - const events = input.provider === "claude" ? normalizeClaude(obj, id) : normalizeCodex(obj, id); + const events = input.provider === "claude" ? normalizeClaude(obj, id) + : input.provider === "codex" ? normalizeCodex(obj, id) : normalizeGemini(obj, id, gemini); events.forEach(emit); })); child.stderr.setEncoding("utf8").on("data", lineSplitter((line) => { @@ -277,6 +273,7 @@ export function startRun(input: { })); child.on("error", (error) => emit({ kind: "error", text: `não iniciou: ${error.message}`, isError: true })); child.on("close", (code) => { + if (input.provider === "gemini") flushGemini(gemini, id).forEach(emit); // Tarefa "criar história": a IA grava meta.json com título e premissa definitivos. if (input.kind === "story" && story && code === 0) syncStoryMeta(story.id); const current = getRun(id); @@ -286,6 +283,12 @@ export function startRun(input: { ok ? "success" : "error", ok ? null : `saiu com código ${code}`, now(), id); } active.delete(id); + // IA reserva: caiu por indisponibilidade (cota, login, rede…) e ninguém mandou mensagem → a próxima IA assume. + // Começa antes das vertentes e dos ouvintes: o preparo passa a esperar a reserva e o "end" já leva o id dela. + const fallbackRunId = entry.followUp ? null : startFallback(id, entry); + if (fallbackRunId) { + run("UPDATE episodes SET branches_run_id = ? WHERE branches_run_id = ? AND branches_status = 'running'", fallbackRunId, id); + } // Vertentes: fecha o preparo desta execução e começa o próximo da fila (o executor já está livre). try { onAgentRunClosed(id, getRun(id)?.status === "success"); @@ -339,9 +342,45 @@ export function sendFollowUp(id: number, text: string, mode: "now" | "queue"): v } } -/** A execução que continuou esta (mensagem enviada durante ela ou "Continuar esta conversa"). */ +/** A execução que continuou esta (mensagem enviada durante ela, "Continuar esta conversa" ou a IA reserva). */ export function followUpRunOf(id: number): number | null { - return get<{ id: number }>("SELECT id FROM agent_runs WHERE resume_of = ? ORDER BY id DESC LIMIT 1", id)?.id ?? null; + return get<{ id: number }>("SELECT id FROM agent_runs WHERE resume_of = ? OR fallback_of = ? ORDER BY id DESC LIMIT 1", id, id)?.id ?? null; +} + +/** + * Se a execução terminou com erro de indisponibilidade, põe a IA em pausa e começa a mesma tarefa na próxima IA + * pronta da ordem (Configurações → IA). Cada IA é tentada uma vez por cadeia. Devolve o id da nova execução. + */ +function startFallback(id: number, entry: ActiveRun): number | null { + const closed = getRun(id); + if (!closed || closed.status !== "error") return null; + if (!isAvailabilityError([closed.error ?? "", ...entry.errors].join("\n"))) return null; + markUnavailable(closed.provider, closed.error ?? entry.errors.at(-1) ?? "indisponível"); + // IAs já tentadas nesta cadeia (segue fallback_of para trás). + const tried: Provider[] = []; + for (let cursor: AgentRun | undefined = closed; cursor; cursor = cursor.fallback_of ? getRun(cursor.fallback_of) : undefined) { + tried.push(cursor.provider); + } + const next = nextFallback(tried); + if (!next) { + entry.emit({ kind: "system", text: `${PROVIDER_META[closed.provider].label} ficou indisponível e não há outra IA pronta para assumir (Configurações → IA).` }); + return null; + } + // Numa continuação, o prompt guardado é só a mensagem nova: o pedido original vem da primeira execução da conversa. + let root: AgentRun = closed; + for (let parent = root.resume_of ? getRun(root.resume_of) : undefined; parent; parent = parent.resume_of ? getRun(parent.resume_of) : undefined) root = parent; + const request = root.id === closed.id ? closed.prompt : `${root.prompt}\n\nMensagem seguinte do usuário:\n${closed.prompt}`; + try { + const started = startRun({ + provider: next, model: defaultModelFor(closed.kind, next), kind: closed.kind, request: request.slice(0, 20_000), + storyId: closed.story_id, episodeId: closed.episode_id, fallbackOfRunId: id, + }); + entry.emit({ kind: "system", text: `${PROVIDER_META[closed.provider].label} indisponível: a tarefa continua com ${PROVIDER_META[next].label} (execução #${started.id}).` }); + return started.id; + } catch (error) { + entry.emit({ kind: "error", text: `A IA reserva não começou: ${(error as Error).message}`, isError: true }); + return null; + } } export function cancelRun(id: number): void { @@ -421,6 +460,72 @@ const STDERR_NOISE = [/no stdin data received/, /Reading additional input from s // O Claude Code avisa de id fora da lista interna dele, mas roda o modelo normalmente (testado com claude-fable-5-2). /\[claude-code:unrecognized_model\]/]; +// --- Gemini --------------------------------------------------------------------- + +/** + * Gemini CLI 0.68.0 sem interação (doc/ia.md). `auto_edit` aprova as edições sozinho; de shell, só os comandos + * abaixo (no modo não interativo o resto é recusado). `--skip-trust`: confia na pasta só nesta execução. + */ +const GEMINI_ALLOWED_SHELL = [ + "pnpm render", "pnpm verify", "pnpm test", "pnpm typecheck", "pnpm.cmd render", "pnpm.cmd verify", "pnpm.cmd test", SKILL_SCRIPTS, +].map((command) => `run_shell_command(${command})`); + +export function geminiArgs(prompt: string, model: string, sessionId: string | null): string[] { + return ["-p", prompt, "-o", "stream-json", "--approval-mode", "auto_edit", "--skip-trust", + ...(model ? ["-m", model] : []), ...(sessionId ? ["--resume", sessionId] : []), + "--allowed-tools", ...GEMINI_ALLOWED_SHELL]; +} + +/** O texto do Gemini chega em pedaços (`delta`): junta e solta um bloco só quando chega outro tipo de evento. */ +export type GeminiState = { text: string }; + +function flushGemini(state: GeminiState, runId: number): Omit[] { + const text = state.text.trim(); + state.text = ""; + if (!text) return []; + run("UPDATE agent_runs SET result = ? WHERE id = ?", text.slice(0, 20_000), runId); + return [{ kind: "text", text }]; +} + +/** Eventos JSONL do `gemini -o stream-json` (formato lido no código do gemini-cli 0.68.0). */ +export function normalizeGemini(o: Record, runId: number, state: GeminiState): Omit[] { + if (o.type === "message") { + if (o.role === "assistant") state.text += String(o.content ?? ""); + return []; + } + const pending = flushGemini(state, runId); + switch (o.type) { + case "init": + run("UPDATE agent_runs SET session_id = ? WHERE id = ?", String(o.session_id), runId); + return [...pending, { kind: "system", text: `sessão iniciada · modelo ${o.model}` }]; + case "tool_use": + return [...pending, { kind: "tool", text: `${o.tool_name} ${summarizeInput(o.parameters as Record | undefined)}` }]; + case "tool_result": { + const error = o.error as { message?: string } | undefined; + return [...pending, { kind: "tool_result", text: truncate(String(o.output ?? error?.message ?? ""), 1500) || "(sem saída)", isError: o.status === "error" }]; + } + case "error": + return [...pending, o.severity === "error" + ? { kind: "error", text: truncate(String(o.message ?? ""), 500), isError: true } + : { kind: "system", text: truncate(String(o.message ?? ""), 300) }]; + case "result": { + const stats = (o.stats ?? {}) as { input_tokens?: number; output_tokens?: number; tool_calls?: number }; + const error = o.error as { message?: string } | undefined; + const failed = o.status === "error"; + run("UPDATE agent_runs SET num_turns = COALESCE(num_turns, 0) + 1, error = COALESCE(error, ?) WHERE id = ?", + failed ? String(error?.message ?? "erro").slice(0, 2000) : null, runId); + return [...pending, { + kind: "result", isError: failed, + text: failed + ? `Terminou com erro: ${truncate(String(error?.message ?? "falha"), 300)}` + : `Concluído · ${stats.input_tokens ?? 0} tokens de entrada · ${stats.output_tokens ?? 0} de saída · ${stats.tool_calls ?? 0} ferramentas · Gemini não informa custo em US$`, + }]; + } + default: + return pending; + } +} + // --- normalização --------------------------------------------------------------- type Block = { type?: string; text?: string; name?: string; input?: Record; content?: unknown; is_error?: boolean }; diff --git a/panel/src/lib/ai.test.ts b/panel/src/lib/ai.test.ts new file mode 100644 index 0000000..6f0b1bb --- /dev/null +++ b/panel/src/lib/ai.test.ts @@ -0,0 +1,127 @@ +// IA: configuração (data/ai/settings.json), classificador de indisponibilidade, ambiente por modo de login, cofre +// DPAPI (só no Windows) e o normalizador do Gemini. Tudo numa pasta TEMPORÁRIA (CENAFORGE_ROOT); nenhuma CLI real é +// chamada. Rodar: pnpm --filter cenaforge-panel test:panel +import assert from "node:assert/strict"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import { before, describe, it } from "node:test"; + +const ROOT = fs.mkdtempSync(path.join(os.tmpdir(), "cenaforge-ai-")); +process.env.CENAFORGE_ROOT = ROOT; + +type Ai = typeof import("./ai"); +type Agents = typeof import("./agents"); +type Db = typeof import("./db"); +let ai: Ai; +let agents: Agents; +let dbm: Db; +const SETTINGS = () => path.join(ROOT, "data", "ai", "settings.json"); + +before(async () => { + ai = await import("./ai"); + agents = await import("./agents"); + dbm = await import("./db"); +}); + +describe("configuração da IA", () => { + it("sem arquivo usa o padrão: Claude e Codex ligados na conta, Gemini desligado", () => { + const s = ai.readAiSettings(); + assert.deepEqual(s.order, ["claude", "codex", "gemini"]); + assert.equal(s.providers.claude.enabled, true); + assert.equal(s.providers.gemini.enabled, false); + assert.equal(s.providers.gemini.authMode, "apiKey"); + assert.equal(s.fallback.enabled, true); + }); + + it("normaliza arquivo estragado: ordem sem repetição e completa, pausa dentro do limite", () => { + fs.mkdirSync(path.dirname(SETTINGS()), { recursive: true }); + fs.writeFileSync(SETTINGS(), JSON.stringify({ order: ["gemini", "gemini", "x"], providers: { codex: { enabled: "sim", authMode: "nada" } }, fallback: { cooldownMin: 9999 } })); + const s = ai.readAiSettings(); + assert.deepEqual(s.order, ["gemini", "claude", "codex"]); + assert.equal(s.providers.codex.enabled, true); + assert.equal(s.providers.codex.authMode, "oauth"); + assert.equal(s.fallback.cooldownMin, 240); + fs.rmSync(SETTINGS()); + }); + + it("salva só o que veio e recusa ordem inválida", () => { + const s = ai.updateAiSettings({ providers: { gemini: { enabled: true } }, order: ["codex", "gemini", "claude"], fallback: { cooldownMin: 30 } }); + assert.equal(s.providers.gemini.enabled, true); + assert.deepEqual(JSON.parse(fs.readFileSync(SETTINGS(), "utf8")).order, ["codex", "gemini", "claude"]); + assert.throws(() => ai.updateAiSettings({ order: ["codex", "codex", "claude"] }), /cada IA uma vez/); + assert.throws(() => ai.updateAiSettings({ fallback: { cooldownMin: 0 } }), /entre 1 e 240/); + assert.throws(() => ai.updateAiSettings({ providers: { gemini: { authMode: "senha" as never } } }), /Modo de login/); + assert.equal(ai.readAiSettings().fallback.cooldownMin, 30); + }); +}); + +describe("indisponibilidade (dispara a reserva)", () => { + for (const text of [ + "API Error: 429 rate_limit_error", "You've hit your usage limit", "Credit balance is too low", "Overloaded (529)", + "IneligibleTierError: This client is no longer supported", "Not logged in · Please run /login", "getaddrinfo ENOTFOUND api.openai.com", + "não iniciou: spawn ENOENT", "Invalid API key", + ]) it(`troca de IA: ${text}`, () => assert.equal(ai.isAvailabilityError(text), true)); + for (const text of ["saiu com código 1", "SyntaxError: Unexpected token in JSON", "Parou no teto de gasto desta tarefa", ""]) { + it(`não troca: ${text || "(vazio)"}`, () => assert.equal(ai.isAvailabilityError(text), false)); + } +}); + +describe("ambiente de cada chamada", () => { + it("modo conta tira a chave do ambiente; Gemini na conta liga GOOGLE_GENAI_USE_GCA", () => { + ai.updateAiSettings({ providers: { claude: { authMode: "oauth" }, gemini: { authMode: "oauth" } } }); + const base = { ANTHROPIC_API_KEY: "sk-ant-velha", GEMINI_API_KEY: "AIza-velha", PATH: "x" }; + const claude = ai.providerEnv("claude", base); + assert.equal(claude.ANTHROPIC_API_KEY, undefined); + assert.equal(claude.PATH, "x"); + const gemini = ai.providerEnv("gemini", base); + assert.equal(gemini.GEMINI_API_KEY, undefined); + assert.equal(gemini.GOOGLE_GENAI_USE_GCA, "true"); + }); + + it("modo chave sem chave salva não vaza a do ambiente do painel", () => { + ai.updateAiSettings({ providers: { codex: { authMode: "apiKey" } } }); + assert.equal(ai.providerEnv("codex", { CODEX_API_KEY: "sk-do-sistema" }).CODEX_API_KEY, undefined); + }); + + it("cofre DPAPI: guarda, injeta só na chamada e apaga", { skip: process.platform !== "win32" && "DPAPI só existe no Windows" }, () => { + assert.throws(() => ai.setApiKey("codex", "curta"), /não parece válida/); + ai.setApiKey("codex", "sk-test-0123456789abcdefWXYZ"); + const bytes = fs.readFileSync(path.join(ROOT, "data", "ai", "vault.bin")); + assert.equal(bytes.includes(Buffer.from("sk-test")), false, "a chave não pode ficar em texto claro"); + assert.equal(ai.providerEnv("codex", {}).CODEX_API_KEY, "sk-test-0123456789abcdefWXYZ"); + ai.setApiKey("codex", null); + assert.equal(fs.existsSync(path.join(ROOT, "data", "ai", "vault.bin")), false); + assert.equal(ai.providerEnv("codex", {}).CODEX_API_KEY, undefined); + }); +}); + +describe("Gemini: eventos do stream-json", () => { + it("junta o texto em pedaços, registra sessão, ferramenta e resultado", () => { + const id = Number(dbm.run(`INSERT INTO agent_runs (provider, model, kind, prompt, status, log_path, started_at) + VALUES ('gemini', '', 'free', 'oi', 'running', '', ?)`, dbm.now()).lastInsertRowid); + const state: import("./agents").GeminiState = { text: "" }; + const n = (o: Record) => agents.normalizeGemini(o, id, state); + assert.deepEqual(n({ type: "init", session_id: "abc-123", model: "gemini-3.5-flash" }).map((e) => e.kind), ["system"]); + assert.deepEqual(n({ type: "message", role: "user", content: "oi" }), []); + assert.deepEqual(n({ type: "message", role: "assistant", content: "Vou ", delta: true }), []); + assert.deepEqual(n({ type: "message", role: "assistant", content: "ler.", delta: true }), []); + const tool = n({ type: "tool_use", tool_name: "read_file", tool_id: "t1", parameters: { file_path: "README.md" } }); + assert.deepEqual(tool.map((e) => [e.kind, e.text]), [["text", "Vou ler."], ["tool", "read_file README.md"]]); + assert.equal(n({ type: "tool_result", tool_id: "t1", status: "error", error: { message: "sem permissão" } })[0].isError, true); + const done = n({ type: "result", status: "error", error: { type: "API", message: "429 quota exceeded" }, stats: {} }); + assert.equal(done[0].isError, true); + const row = dbm.get<{ session_id: string; error: string; num_turns: number }>("SELECT session_id, error, num_turns FROM agent_runs WHERE id = ?", id)!; + assert.equal(row.session_id, "abc-123"); + assert.match(row.error, /429/); + assert.equal(ai.isAvailabilityError(row.error), true); + }); + + it("argumentos: modo headless, edição automática, retomada e shell só o liberado", () => { + const args = agents.geminiArgs("faça X", "gemini-2.5-pro", "sess-1"); + assert.deepEqual(args.slice(0, 7), ["-p", "faça X", "-o", "stream-json", "--approval-mode", "auto_edit", "--skip-trust"]); + assert.ok(args.includes("--resume") && args.includes("sess-1")); + assert.ok(args.some((a) => a.startsWith("run_shell_command(pnpm render"))); + assert.equal(args.includes("--yolo"), false); + }); +}); diff --git a/panel/src/lib/ai.ts b/panel/src/lib/ai.ts new file mode 100644 index 0000000..72ed438 --- /dev/null +++ b/panel/src/lib/ai.ts @@ -0,0 +1,629 @@ +// IA do painel: as três CLIs (Claude Code, Codex e Gemini), login com a conta (OAuth) ou chave de API, +// instalação pelo painel e a IA reserva (se uma cair, a próxima da ordem assume). +// +// Contrato com o Clipador (Python), que lê os mesmos arquivos: doc/ia.md. +// data/ai/settings.json — ligada/desligada, modo de login e ordem da reserva (sem segredo); +// data/ai/vault.bin — chaves de API cifradas com a DPAPI do Windows (só esta conta, nesta máquina). +// A chave nunca volta para a tela: a API só diz se existe e os 4 últimos caracteres. +import { spawn, spawnSync } from "node:child_process"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import { DATA_DIR } from "./paths"; +import { findOnPath, lineSplitter } from "./proc"; +import { UserError } from "./stories"; +import { PROVIDERS, type Provider } from "./types"; + +export type AuthMode = "oauth" | "apiKey"; +export type ProviderSettings = { enabled: boolean; authMode: AuthMode }; +export type AiSettings = { + version: 1; + providers: Record; + /** Prioridade da reserva. */ + order: Provider[]; + fallback: { enabled: boolean; cooldownMin: number }; +}; + +const AI_DIR = path.join(DATA_DIR, "ai"); +const SETTINGS_PATH = path.join(AI_DIR, "settings.json"); +const VAULT_PATH = path.join(AI_DIR, "vault.bin"); +const HOME = os.homedir(); +const IS_WINDOWS = process.platform === "win32"; + +export const DEFAULT_AI_SETTINGS: AiSettings = { + version: 1, + providers: { + claude: { enabled: true, authMode: "oauth" }, + codex: { enabled: true, authMode: "oauth" }, + gemini: { enabled: false, authMode: "apiKey" }, + }, + order: ["claude", "codex", "gemini"], + fallback: { enabled: true, cooldownMin: 15 }, +}; + +/* ---------------------------------------------------------------- catálogo das CLIs */ + +type Command = { file: string; args: string[] }; + +export type ProviderMeta = { + id: Provider; + label: string; + vendor: string; + /** Nome do executável no PATH. */ + bin: string; + /** Variável que aponta o executável manualmente (ex.: CLAUDE_BIN). */ + binEnv: string; + /** No Windows o npm instala um `.cmd` (o Node não o executa sem shell): rodamos o `.js` do pacote pelo Node. */ + npmEntry: string | null; + install: { display: string; command: Command }; + /** Argumentos do login com a conta, abertos num terminal visível. */ + loginArgs: string[]; + oauthLabel: string; + oauthNote: string | null; + apiKeyEnv: string; + apiKeyUrl: string; + apiKeyLabel: string; +}; + +const npmInstall = (pkg: string): ProviderMeta["install"] => ({ + display: `npm install -g ${pkg}`, + command: IS_WINDOWS ? { file: "cmd.exe", args: ["/d", "/s", "/c", `npm install -g ${pkg}`] } : { file: "npm", args: ["install", "-g", pkg] }, +}); + +export const PROVIDER_META: Record = { + claude: { + id: "claude", label: "Claude Code", vendor: "Anthropic", bin: "claude", binEnv: "CLAUDE_BIN", npmEntry: null, + install: IS_WINDOWS + ? { display: "irm https://claude.ai/install.ps1 | iex", command: { file: "powershell.exe", args: ["-NoProfile", "-ExecutionPolicy", "Bypass", "-Command", "irm https://claude.ai/install.ps1 | iex"] } } + : { display: "curl -fsSL https://claude.ai/install.sh | bash", command: { file: "bash", args: ["-lc", "curl -fsSL https://claude.ai/install.sh | bash"] } }, + loginArgs: ["auth", "login"], + oauthLabel: "Conta Claude (Pro/Max) ou Console", + oauthNote: null, + apiKeyEnv: "ANTHROPIC_API_KEY", apiKeyUrl: "https://console.anthropic.com/settings/keys", apiKeyLabel: "Chave da API da Anthropic (sk-ant-…)", + }, + codex: { + id: "codex", label: "Codex", vendor: "OpenAI", bin: "codex", binEnv: "CODEX_BIN", npmEntry: path.join("@openai", "codex", "bin", "codex.js"), + install: npmInstall("@openai/codex@latest"), + loginArgs: ["login"], + oauthLabel: "Conta ChatGPT (Plus/Pro/Team)", + oauthNote: null, + apiKeyEnv: "CODEX_API_KEY", apiKeyUrl: "https://platform.openai.com/api-keys", apiKeyLabel: "Chave da API da OpenAI (sk-…)", + }, + gemini: { + id: "gemini", label: "Gemini CLI", vendor: "Google", bin: "gemini", binEnv: "GEMINI_BIN", npmEntry: path.join("@google", "gemini-cli", "bundle", "gemini.js"), + install: npmInstall("@google/gemini-cli@latest"), + loginArgs: [], + oauthLabel: "Conta Google", + // Verificado em 18/11/2026 (gemini-cli 0.68.0): IneligibleTierError UNSUPPORTED_CLIENT no plano gratuito. + oauthNote: "O Google encerrou o login gratuito do Gemini CLI para contas pessoais. Só planos pagos elegíveis (Code Assist Standard/Enterprise, Workspace) entram com a conta. Para conta pessoal, use a chave de API do AI Studio.", + apiKeyEnv: "GEMINI_API_KEY", apiKeyUrl: "https://aistudio.google.com/apikey", apiKeyLabel: "Chave do Google AI Studio (AIza…)", + }, +}; + +/* ---------------------------------------------------------------- configuração */ + +function isProvider(value: unknown): value is Provider { + return typeof value === "string" && (PROVIDERS as string[]).includes(value); +} + +/** Lê e normaliza: campo inválido volta ao padrão; a ordem sempre tem as três IAs, uma vez cada. */ +export function readAiSettings(): AiSettings { + let raw: Partial = {}; + try { + raw = JSON.parse(fs.readFileSync(SETTINGS_PATH, "utf8")) as Partial; + } catch { /* ausente ou inválido: padrão */ } + const providers = {} as Record; + for (const id of PROVIDERS) { + const item = (raw.providers as Record> | undefined)?.[id] ?? {}; + const fallback = DEFAULT_AI_SETTINGS.providers[id]; + providers[id] = { + enabled: typeof item.enabled === "boolean" ? item.enabled : fallback.enabled, + authMode: item.authMode === "oauth" || item.authMode === "apiKey" ? item.authMode : fallback.authMode, + }; + } + const order = [...new Set((Array.isArray(raw.order) ? raw.order : []).filter(isProvider))]; + for (const id of DEFAULT_AI_SETTINGS.order) if (!order.includes(id)) order.push(id); + const cooldown = Number(raw.fallback?.cooldownMin); + return { + version: 1, providers, order, + fallback: { + enabled: typeof raw.fallback?.enabled === "boolean" ? raw.fallback.enabled : true, + cooldownMin: Number.isFinite(cooldown) ? Math.min(240, Math.max(1, Math.round(cooldown))) : DEFAULT_AI_SETTINGS.fallback.cooldownMin, + }, + }; +} + +export type AiSettingsPatch = { + providers?: Partial>>; + order?: unknown; + fallback?: Partial; +}; + +export function updateAiSettings(patch: AiSettingsPatch): AiSettings { + const next = readAiSettings(); + for (const [id, change] of Object.entries(patch.providers ?? {})) { + if (!isProvider(id) || !change) throw new UserError("IA desconhecida."); + if (change.enabled !== undefined) { + if (typeof change.enabled !== "boolean") throw new UserError("\"Ligada\" precisa ser verdadeiro ou falso."); + next.providers[id].enabled = change.enabled; + } + if (change.authMode !== undefined) { + if (change.authMode !== "oauth" && change.authMode !== "apiKey") throw new UserError("Modo de login inválido."); + next.providers[id].authMode = change.authMode; + } + } + if (patch.order !== undefined) { + const order = Array.isArray(patch.order) ? patch.order : []; + if (order.length !== PROVIDERS.length || !order.every(isProvider) || new Set(order).size !== PROVIDERS.length) { + throw new UserError("A ordem precisa ter cada IA uma vez."); + } + next.order = order as Provider[]; + } + if (patch.fallback?.enabled !== undefined) { + if (typeof patch.fallback.enabled !== "boolean") throw new UserError("Reserva: valor inválido."); + next.fallback.enabled = patch.fallback.enabled; + } + if (patch.fallback?.cooldownMin !== undefined) { + const minutes = Number(patch.fallback.cooldownMin); + if (!Number.isInteger(minutes) || minutes < 1 || minutes > 240) throw new UserError("A pausa precisa ficar entre 1 e 240 minutos."); + next.fallback.cooldownMin = minutes; + } + writeAtomic(SETTINGS_PATH, JSON.stringify(next, null, 2) + "\n"); + invalidateStatus(); + return next; +} + +function writeAtomic(file: string, data: string | Buffer): void { + fs.mkdirSync(path.dirname(file), { recursive: true }); + const tmp = `${file}.${process.pid}.tmp`; + fs.writeFileSync(tmp, data); + fs.renameSync(tmp, file); +} + +/* ---------------------------------------------------------------- cofre (DPAPI) */ + +const VAULT_ENTROPY = "CenaForge.AI.vault.v1"; +type VaultData = Partial>; +const g = globalThis as unknown as { + __cenaforgeAiVault?: { mtimeMs: number; data: VaultData }; + __cenaforgeAiStatus?: { at: number; list: ProviderRuntime[] }; + __cenaforgeAiInstalls?: Map; + __cenaforgeAiCooldown?: Map; + __cenaforgeAiTests?: Map; + __cenaforgeGeminiModels?: { at: number; list: { id: string; label: string }[]; loading: boolean }; +}; + +/** DPAPI pelo PowerShell (System.Security.ProtectedData), escopo do usuário. O Clipador abre com ctypes. */ +function dpapi(op: "Protect" | "Unprotect", data: Buffer): Buffer { + if (!IS_WINDOWS) throw new UserError("O cofre de chaves usa a DPAPI do Windows; este sistema não tem."); + const script = "Add-Type -AssemblyName System.Security; $i = [Console]::In.ReadToEnd().Trim(); " + + `$e = [Text.Encoding]::UTF8.GetBytes('${VAULT_ENTROPY}'); ` + + `[Console]::Out.Write([Convert]::ToBase64String([Security.Cryptography.ProtectedData]::${op}([Convert]::FromBase64String($i), $e, 'CurrentUser')))`; + const r = spawnSync("powershell.exe", ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-Command", script], + { input: data.toString("base64"), encoding: "utf8", windowsHide: true, timeout: 30_000 }); + if (r.status !== 0 || !r.stdout.trim()) { + throw new UserError("O cofre de chaves não abriu (arquivo de outro usuário do Windows ou corrompido). Apague data/ai/vault.bin e salve as chaves de novo."); + } + return Buffer.from(r.stdout.trim(), "base64"); +} + +function readVault(): VaultData { + let stat: fs.Stats; + try { + stat = fs.statSync(VAULT_PATH); + } catch { + return {}; + } + if (g.__cenaforgeAiVault?.mtimeMs === stat.mtimeMs) return g.__cenaforgeAiVault.data; + const parsed = JSON.parse(dpapi("Unprotect", fs.readFileSync(VAULT_PATH)).toString("utf8")) as Record; + const data: VaultData = {}; + for (const id of PROVIDERS) if (typeof parsed[id] === "string" && parsed[id]) data[id] = parsed[id] as string; + g.__cenaforgeAiVault = { mtimeMs: stat.mtimeMs, data }; + return data; +} + +function apiKeyOf(id: Provider): string | null { + try { + return readVault()[id] ?? null; + } catch { + return null; + } +} + +/** Guarda (ou apaga, com null) a chave de uma IA. Validação leve: sem espaços e tamanho plausível. */ +export function setApiKey(id: Provider, key: string | null): void { + if (!isProvider(id)) throw new UserError("IA desconhecida."); + const data = { ...readVault() }; + if (key === null) { + delete data[id]; + } else { + const clean = key.trim(); + if (clean.length < 16 || clean.length > 400 || /\s/.test(clean)) throw new UserError("Essa chave não parece válida: cole a chave inteira, sem espaços."); + data[id] = clean; + } + if (Object.keys(data).length === 0) { + fs.rmSync(VAULT_PATH, { force: true }); + } else { + writeAtomic(VAULT_PATH, dpapi("Protect", Buffer.from(JSON.stringify(data), "utf8"))); + } + g.__cenaforgeAiVault = undefined; + g.__cenaforgeAiTests?.delete(id); + invalidateStatus(); +} + +/* ---------------------------------------------------------------- executável e ambiente */ + +export type ResolvedCommand = { path: string; command: string; prefixArgs: string[] }; + +/** Pastas onde os instaladores costumam pôr as CLIs (o PATH do painel é o de quando ele abriu). */ +function extraDirs(): string[] { + const dirs = [path.join(HOME, ".local", "bin")]; + if (process.env.APPDATA) dirs.push(path.join(process.env.APPDATA, "npm")); + return dirs; +} + +export function resolveCommand(id: Provider): ResolvedCommand | null { + const meta = PROVIDER_META[id]; + const fromEnv = process.env[meta.binEnv]; + if (fromEnv) { + return fromEnv.endsWith(".js") ? { path: fromEnv, command: process.execPath, prefixArgs: [fromEnv] } : { path: fromEnv, command: fromEnv, prefixArgs: [] }; + } + const exe = findOnPath(meta.bin); + if (exe) return { path: exe, command: exe, prefixArgs: [] }; + const dirs = [...(process.env.PATH ?? "").split(path.delimiter).filter(Boolean), ...extraDirs()]; + for (const dir of dirs) { + if (!IS_WINDOWS) break; + const native = path.join(dir, `${meta.bin}.exe`); + if (fs.existsSync(native)) return { path: native, command: native, prefixArgs: [] }; + if (meta.npmEntry) { + const js = path.join(dir, "node_modules", meta.npmEntry); + if (fs.existsSync(path.join(dir, `${meta.bin}.cmd`)) && fs.existsSync(js)) return { path: js, command: process.execPath, prefixArgs: [js] }; + } + } + return null; +} + +/** Variáveis de ambiente de uma chamada: o modo chave só vale para ela; o login global da CLI não muda. */ +export function providerEnv(id: Provider, base: Record = process.env): NodeJS.ProcessEnv { + const env = { ...base } as NodeJS.ProcessEnv; + const mode = readAiSettings().providers[id].authMode; + const key = mode === "apiKey" ? apiKeyOf(id) : null; + const variable = PROVIDER_META[id].apiKeyEnv; + if (key) env[variable] = key; + else delete env[variable]; + if (id === "gemini") { + if (mode === "oauth") env.GOOGLE_GENAI_USE_GCA = "true"; + else delete env.GOOGLE_GENAI_USE_GCA; + } + return env; +} + +/* ---------------------------------------------------------------- estado de cada IA */ + +export type OAuthState = { state: "yes" | "no" | "unknown"; detail: string }; + +/** Parte cara do estado (processos): fica em cache por 60 s. */ +type ProviderRuntime = { id: Provider; resolved: ResolvedCommand | null; version: string | null; oauth: OAuthState }; + +export type InstallJob = { status: "running" | "success" | "error"; log: string[]; startedAt: string; finishedAt: string | null }; +export type TestResult = { ok: boolean; text: string; at: string; ms: number }; + +export type ProviderStatus = { + id: Provider; label: string; vendor: string; + installed: boolean; version: string | null; path: string | null; + settings: ProviderSettings; + oauth: OAuthState; + apiKey: { saved: boolean; hint: string | null }; + /** Ligada, instalada e com login (ou chave) — pode ser chamada agora. */ + ready: boolean; + /** Por que não está pronta (null = pronta). */ + problem: string | null; + cooldown: { until: string; reason: string } | null; + install: InstallJob | null; + lastTest: TestResult | null; + meta: { installCommand: string; oauthLabel: string; oauthNote: string | null; apiKeyEnv: string; apiKeyUrl: string; apiKeyLabel: string; canLogin: boolean }; +}; + +function run(resolved: ResolvedCommand, args: string[], timeout = 20_000) { + return spawnSync(resolved.command, [...resolved.prefixArgs, ...args], { encoding: "utf8", timeout, windowsHide: true, shell: false, env: process.env }); +} + +function detectOAuth(id: Provider, resolved: ResolvedCommand | null): OAuthState { + if (!resolved) return { state: "unknown", detail: "" }; + if (id === "claude") { + const r = run(resolved, ["auth", "status", "--json"]); + try { + const s = JSON.parse(r.stdout) as { loggedIn?: boolean; authMethod?: string; subscriptionType?: string }; + if (!s.loggedIn) return { state: "no", detail: "Não está logado." }; + const plan = s.subscriptionType ? ` · plano ${s.subscriptionType}` : ""; + return { state: "yes", detail: `Logado (${s.authMethod ?? "conta"}${plan}).` }; + } catch { + return { state: "unknown", detail: "Não deu para ler o login do Claude Code." }; + } + } + if (id === "codex") { + const r = run(resolved, ["login", "status"]); + const text = `${r.stdout ?? ""}\n${r.stderr ?? ""}`.trim(); + if (/logged in/i.test(text) && !/not logged in/i.test(text)) return { state: "yes", detail: text.split(/\r?\n/)[0].replace(/^Logged in using/i, "Logado com") }; + return { state: "no", detail: "Não está logado." }; + } + // Gemini: não há comando de status; a credencial do Google fica em ~/.gemini/oauth_creds.json. + return fs.existsSync(path.join(HOME, ".gemini", "oauth_creds.json")) + ? { state: "unknown", detail: "Há uma credencial do Google salva; use \"Testar\" para ver se a conta é aceita." } + : { state: "no", detail: "Nenhuma credencial do Google salva." }; +} + +function runtimes(force = false): ProviderRuntime[] { + const cached = g.__cenaforgeAiStatus; + if (!force && cached && Date.now() - cached.at < 60_000) return cached.list; + const list = PROVIDERS.map((id): ProviderRuntime => { + const resolved = resolveCommand(id); + let version: string | null = null; + if (resolved) { + const r = run(resolved, ["--version"]); + version = r.status === 0 ? r.stdout.trim().split(/\r?\n/)[0] : null; + } + return { id, resolved: version !== null ? resolved : null, version, oauth: detectOAuth(id, version !== null ? resolved : null) }; + }); + g.__cenaforgeAiStatus = { at: Date.now(), list }; + return list; +} + +export function invalidateStatus(): void { + g.__cenaforgeAiStatus = undefined; +} + +export function providerStatus(options: { refresh?: boolean } = {}): ProviderStatus[] { + const settings = readAiSettings(); + let vault: VaultData = {}; + let vaultError: string | null = null; + try { + vault = readVault(); + } catch (error) { + vaultError = (error as Error).message; + } + return runtimes(options.refresh).map((rt): ProviderStatus => { + const meta = PROVIDER_META[rt.id]; + const own = settings.providers[rt.id]; + const key = vault[rt.id]; + const installed = rt.resolved !== null; + let problem: string | null = null; + if (!own.enabled) problem = "Desligada."; + else if (!installed) problem = "CLI não instalada."; + else if (own.authMode === "apiKey" && vaultError) problem = vaultError; + else if (own.authMode === "apiKey" && !key) problem = "Falta a chave de API."; + else if (own.authMode === "oauth" && rt.oauth.state === "no") problem = "Falta entrar com a conta."; + const cooldown = activeCooldown(rt.id); + return { + id: rt.id, label: meta.label, vendor: meta.vendor, + installed, version: rt.version, path: rt.resolved?.path ?? null, + settings: own, oauth: rt.oauth, + apiKey: { saved: !!key, hint: key ? `…${key.slice(-4)}` : null }, + ready: problem === null, problem, + cooldown: cooldown ? { until: new Date(cooldown.until).toISOString(), reason: cooldown.reason } : null, + install: installs().get(rt.id) ?? null, + lastTest: tests().get(rt.id) ?? null, + meta: { + installCommand: meta.install.display, oauthLabel: meta.oauthLabel, oauthNote: meta.oauthNote, + apiKeyEnv: meta.apiKeyEnv, apiKeyUrl: meta.apiKeyUrl, apiKeyLabel: meta.apiKeyLabel, canLogin: IS_WINDOWS, + }, + }; + }); +} + +export function resolvedFor(id: Provider): ResolvedCommand | null { + return runtimes().find((r) => r.id === id)?.resolved ?? null; +} + +/* ---------------------------------------------------------------- reserva */ + +const cooldowns = () => (g.__cenaforgeAiCooldown ??= new Map()); + +/** Falha que não é culpa do pedido: cota, sobrecarga, login/chave, rede, CLI fora. Ver doc/ia.md. */ +const AVAILABILITY_PATTERNS = [ + /rate.?limit/i, /\b429\b/, /quota/i, /usage limit/i, /limit (reached|exceeded)/i, /credit balance/i, /hit your limit/i, + /overloaded/i, /\b529\b/, /\b503\b/, /\b502\b/, /unavailable/i, /capacity/i, + /\b401\b/, /\b403\b/, /unauthori[sz]ed/i, /not logged in/i, /please (run|log)/i, /login/i, /invalid.{0,12}api.?key/i, /authentication/i, /IneligibleTier/i, /auth method/i, + /ECONN/i, /ETIMEDOUT/i, /ENOTFOUND/i, /EAI_AGAIN/i, /network/i, /socket hang up/i, /fetch failed/i, + /não iniciou/i, /não encontrad/i, /não está disponível/i, /timed? ?out/i, /passou de \d+ s/i, +]; + +export function isAvailabilityError(text: string | null | undefined): boolean { + return !!text && AVAILABILITY_PATTERNS.some((re) => re.test(text)); +} + +export function markUnavailable(id: Provider, reason: string): void { + const minutes = readAiSettings().fallback.cooldownMin; + cooldowns().set(id, { until: Date.now() + minutes * 60_000, reason: reason.slice(0, 300) }); +} + +export function clearCooldown(id: Provider): void { + cooldowns().delete(id); +} + +function activeCooldown(id: Provider): { until: number; reason: string } | null { + const entry = cooldowns().get(id); + if (!entry) return null; + if (entry.until <= Date.now()) { + cooldowns().delete(id); + return null; + } + return entry; +} + +/** IAs prontas na ordem de uso: `first` (a escolhida/preferida) e depois a ordem da reserva. As em pausa vão para o fim. */ +export function readyChain(first?: Provider): Provider[] { + const settings = readAiSettings(); + const ready = new Set(providerStatus().filter((p) => p.ready).map((p) => p.id)); + const order = [...new Set([...(first ? [first] : []), ...settings.order])].filter((id) => ready.has(id)); + return [...order.filter((id) => !activeCooldown(id)), ...order.filter((id) => activeCooldown(id))]; +} + +/** Próxima IA para continuar uma tarefa que falhou por indisponibilidade (null = reserva desligada ou nenhuma). */ +export function nextFallback(tried: Provider[]): Provider | null { + if (!readAiSettings().fallback.enabled) return null; + return readyChain().find((id) => !tried.includes(id) && !activeCooldown(id)) ?? null; +} + +/* ---------------------------------------------------------------- instalação */ + +const installs = () => (g.__cenaforgeAiInstalls ??= new Map()); + +/** Instala ou atualiza a CLI em segundo plano; o log aparece na tela (GET /api/ai). */ +export function startInstall(id: Provider): InstallJob { + if (!isProvider(id)) throw new UserError("IA desconhecida."); + if (installs().get(id)?.status === "running") throw new UserError("A instalação já está em andamento."); + const { command } = PROVIDER_META[id].install; + const job: InstallJob = { status: "running", log: [`$ ${PROVIDER_META[id].install.display}`], startedAt: new Date().toISOString(), finishedAt: null }; + installs().set(id, job); + const push = (line: string) => { + job.log.push(line.slice(0, 400)); + if (job.log.length > 200) job.log.splice(1, job.log.length - 200); + }; + const child = spawn(command.file, command.args, { cwd: HOME, shell: false, windowsHide: true, stdio: ["ignore", "pipe", "pipe"], env: process.env }); + child.stdout.setEncoding("utf8").on("data", lineSplitter(push)); + child.stderr.setEncoding("utf8").on("data", lineSplitter(push)); + child.on("error", (error) => { + push(`não iniciou: ${error.message}`); + job.status = "error"; + job.finishedAt = new Date().toISOString(); + }); + child.on("close", (code) => { + if (job.status === "running") job.status = code === 0 ? "success" : "error"; + push(code === 0 ? "Instalação concluída." : `Saiu com código ${code}.`); + job.finishedAt = new Date().toISOString(); + invalidateStatus(); + }); + return job; +} + +/* ---------------------------------------------------------------- login (OAuth) */ + +/** + * Abre um terminal visível com o login da CLI (o navegador abre a página da conta). O painel não vê a senha: + * o login é da própria CLI. Depois o usuário clica em "Verificar". + */ +export function openLoginTerminal(id: Provider): void { + if (!isProvider(id)) throw new UserError("IA desconhecida."); + if (!IS_WINDOWS) throw new UserError(`Rode no terminal: ${PROVIDER_META[id].bin} ${PROVIDER_META[id].loginArgs.join(" ")}`); + const resolved = resolvedFor(id) ?? resolveCommand(id); + if (!resolved) throw new UserError("Instale a CLI antes de entrar com a conta."); + const quoted = [resolved.command, ...resolved.prefixArgs].map((part) => `"${part}"`).join(" "); + const cmdline = [quoted, ...PROVIDER_META[id].loginArgs].join(" "); + const banner = id === "gemini" + ? "echo No Gemini, escolha \"Login with Google\". Depois de logar, feche esta janela com /quit. &&" + : "echo Siga o login no navegador. Depois feche esta janela e clique em Verificar no painel. &&"; + // cmd /k "": as aspas externas caem e as dos caminhos ficam. Caminhos vêm da detecção, não do usuário. + const child = spawn("cmd.exe", ["/d", "/c", "start", `"CenaForge - login ${PROVIDER_META[id].label}"`, "cmd.exe", "/k", `"${banner} ${cmdline}"`], + { cwd: HOME, detached: true, stdio: "ignore", windowsVerbatimArguments: true, env: providerEnvForLogin(id) }); + child.unref(); + invalidateStatus(); +} + +/** No login com a conta, nenhuma chave de API pode estar no ambiente (a CLI usaria a chave em vez da conta). */ +function providerEnvForLogin(id: Provider): NodeJS.ProcessEnv { + const env = { ...process.env }; + delete env[PROVIDER_META[id].apiKeyEnv]; + if (id === "gemini") delete env.GOOGLE_GENAI_USE_GCA; + return env; +} + +/* ---------------------------------------------------------------- teste rápido */ + +const tests = () => (g.__cenaforgeAiTests ??= new Map()); + +/** Pergunta mínima, fora do repositório (não carrega CLAUDE.md nem skills): confirma login, chave e cota. */ +export async function testProvider(id: Provider): Promise { + if (!isProvider(id)) throw new UserError("IA desconhecida."); + const resolved = resolvedFor(id) ?? resolveCommand(id); + if (!resolved) throw new UserError("Instale a CLI antes de testar."); + const status = providerStatus().find((p) => p.id === id); + if (status?.settings.authMode === "apiKey" && !status.apiKey.saved) throw new UserError("Salve a chave de API antes de testar."); + const cwd = fs.mkdtempSync(path.join(os.tmpdir(), "cenaforge-ai-test-")); + const question = "Responda apenas com a palavra: ok"; + const args = id === "claude" + ? ["-p", question, "--output-format", "json", "--max-turns", "1", "--setting-sources", "project,local", "--strict-mcp-config"] + : id === "codex" + ? ["exec", "--json", "--skip-git-repo-check", "--sandbox", "read-only", "-C", cwd, question] + : ["-p", question, "-o", "json", "--approval-mode", "plan", "--skip-trust"]; + const started = Date.now(); + const output = await new Promise<{ code: number | null; out: string; err: string }>((resolve) => { + const child = spawn(resolved.command, [...resolved.prefixArgs, ...args], { cwd, shell: false, windowsHide: true, stdio: ["ignore", "pipe", "pipe"], env: providerEnv(id) }); + let out = ""; + let err = ""; + const timer = setTimeout(() => { err += "\ntempo esgotado (90 s)"; child.kill(); }, 90_000); + child.stdout.setEncoding("utf8").on("data", (c: string) => { out += c; }); + child.stderr.setEncoding("utf8").on("data", (c: string) => { err += c; }); + child.on("error", (e) => { err += `\nnão iniciou: ${e.message}`; }); + child.on("close", (code) => { clearTimeout(timer); resolve({ code, out, err }); }); + }); + fs.rmSync(cwd, { recursive: true, force: true }); + const answer = readTestAnswer(id, output.out); + const ok = output.code === 0 && answer.ok; + const text = ok ? `Respondeu: "${answer.text}"` : summarizeFailure(answer.text || output.err || output.out); + const result: TestResult = { ok, text, at: new Date().toISOString(), ms: Date.now() - started }; + tests().set(id, result); + if (ok) clearCooldown(id); + return result; +} + +function readTestAnswer(id: Provider, out: string): { ok: boolean; text: string } { + try { + if (id === "claude") { + const r = JSON.parse(out) as { is_error?: boolean; result?: string }; + return { ok: !r.is_error, text: String(r.result ?? "").trim().slice(0, 200) }; + } + if (id === "gemini") { + const r = JSON.parse(out.slice(out.indexOf("{"))) as { response?: string; error?: { message?: string } }; + return r.error ? { ok: false, text: String(r.error.message ?? "erro") } : { ok: true, text: String(r.response ?? "").trim().slice(0, 200) }; + } + // Codex: JSONL; a resposta é o último agent_message; falha vem em turn.failed/error. + let text = ""; + for (const line of out.split(/\r?\n/).filter(Boolean)) { + const e = JSON.parse(line) as { type?: string; item?: { type?: string; text?: string }; error?: { message?: string }; message?: string }; + if (e.type === "item.completed" && e.item?.type === "agent_message") text = String(e.item.text ?? ""); + if (e.type === "turn.failed" || e.type === "error") return { ok: false, text: String(e.error?.message ?? e.message ?? "erro") }; + } + return { ok: !!text, text: text.trim().slice(0, 200) }; + } catch { + return { ok: false, text: "" }; + } +} + +/** Primeira linha útil do erro, sem pilha de chamadas. */ +function summarizeFailure(text: string): string { + const lines = text.split(/\r?\n/).map((l) => l.trim()).filter((l) => l && !/^at /.test(l) && !/True color/i.test(l) && !/Ripgrep/i.test(l)); + const useful = lines.find((l) => /error|erro|limit|auth|login|key|quota|denied|inválid|unsupported/i.test(l)) ?? lines[0] ?? "Falhou sem mensagem."; + return useful.slice(0, 400); +} + +/* ---------------------------------------------------------------- modelos do Gemini */ + +const GEMINI_FALLBACK_MODELS = [ + { id: "gemini-3.5-flash", label: "Gemini 3.5 Flash: rápido e barato" }, + { id: "gemini-2.5-pro", label: "Gemini 2.5 Pro: mais capaz" }, + { id: "gemini-3.1-flash-lite", label: "Gemini 3.1 Flash-Lite: o mais barato" }, +]; + +/** Modelos do `gemini models -o json` (não exige login). Devolve o cache na hora e atualiza em segundo plano (1 h). */ +export function geminiModels(): { id: string; label: string }[] { + const cache = (g.__cenaforgeGeminiModels ??= { at: 0, list: GEMINI_FALLBACK_MODELS, loading: false }); + const resolved = resolvedFor("gemini"); + if (resolved && !cache.loading && Date.now() - cache.at > 3_600_000) { + cache.loading = true; + const child = spawn(resolved.command, [...resolved.prefixArgs, "models", "-o", "json"], { cwd: HOME, shell: false, windowsHide: true, stdio: ["ignore", "pipe", "ignore"] }); + let out = ""; + child.stdout.setEncoding("utf8").on("data", (c: string) => { out += c; }); + child.on("error", () => { cache.loading = false; }); + child.on("close", () => { + cache.loading = false; + cache.at = Date.now(); + try { + const parsed = JSON.parse(out.slice(out.indexOf("["))) as { id?: unknown; displayName?: unknown }[]; + const list = parsed.filter((m) => typeof m.id === "string" && m.id !== "auto").map((m) => ({ id: String(m.id), label: String(m.displayName ?? m.id) })); + if (list.length) cache.list = list; + } catch { /* mantém a lista anterior */ } + }); + } + return cache.list; +} diff --git a/panel/src/lib/db.ts b/panel/src/lib/db.ts index be3c146..4c4e0cb 100644 --- a/panel/src/lib/db.ts +++ b/panel/src/lib/db.ts @@ -401,6 +401,10 @@ export const MIGRATIONS: string[] = [ ` ALTER TABLE accounts ADD COLUMN language TEXT NOT NULL DEFAULT 'pt-BR'; `, + // v10: IA reserva — a execução que continuou outra que caiu por indisponibilidade (lib/ai.ts, doc/ia.md). + ` + ALTER TABLE agent_runs ADD COLUMN fallback_of INTEGER REFERENCES agent_runs(id); + `, ]; const g = globalThis as unknown as { __cenaforgeDb?: DatabaseSync }; diff --git a/panel/src/lib/prompts.ts b/panel/src/lib/prompts.ts index 475d1e3..5b40e1d 100644 --- a/panel/src/lib/prompts.ts +++ b/panel/src/lib/prompts.ts @@ -62,8 +62,9 @@ export function buildPrompt(input: { kind: AgentKind; provider: Provider; reques "Trabalhe só dentro do repositório. Seja econômico: Grep antes de ler, leia por intervalo de linhas, filtre saídas longas (`| Select-Object -Last 20` / `| tail -n 20`). " + "Não acione os subagentes `cenaforge-skill-updater` nem `cenaforge-token-auditor` (100–150 mil tokens cada): isso é feito fora do painel. " + "Ao terminar, liste os arquivos criados ou alterados e o que ficou pendente.", - provider === "codex" - ? "Você é o Codex. Arquivos em `.claude/agents/` são subagentes do Claude: você não os aciona; quando o CLAUDE.md mandar delegar a um deles, faça o trabalho você mesmo. " + + provider !== "claude" + ? `Você é o ${provider === "codex" ? "Codex" : "Gemini"}. ` + + "Arquivos em `.claude/agents/` são subagentes do Claude: você não os aciona; quando o CLAUDE.md mandar delegar a um deles, faça o trabalho você mesmo. " + "No PowerShell, leia texto com `Get-Content -Raw -Encoding UTF8` (sem isso os acentos saem quebrados) e rode o pnpm como `pnpm.cmd` " + "(o `pnpm.ps1` é bloqueado pela política de execução): `pnpm.cmd render -- --config --profile preview`." : null, diff --git a/panel/src/lib/publishing-db.test.ts b/panel/src/lib/publishing-db.test.ts index 72d1a97..f04b2a7 100644 --- a/panel/src/lib/publishing-db.test.ts +++ b/panel/src/lib/publishing-db.test.ts @@ -61,7 +61,7 @@ describe("migração v5", () => { it("migra com backup, preserva ids e não quebra chaves estrangeiras", () => { const version = dbm.get<{ user_version: number }>("PRAGMA user_version")!.user_version; assert.equal(version, dbm.MIGRATIONS.length); - assert.equal(version, 9); + assert.equal(version, 10); assert.equal(fs.readdirSync(path.join(ROOT, "data", "backups")).filter((f) => f.startsWith("cenaforge-v4-")).length, 1); assert.deepEqual(dbm.all("PRAGMA foreign_key_check"), []); }); diff --git a/panel/src/lib/types.ts b/panel/src/lib/types.ts index 3110924..f9a9f5a 100644 --- a/panel/src/lib/types.ts +++ b/panel/src/lib/types.ts @@ -123,7 +123,8 @@ export type Decision = { snapshot_json: string; }; -export type Provider = "claude" | "codex"; +export type Provider = "claude" | "codex" | "gemini"; +export const PROVIDERS: Provider[] = ["claude", "codex", "gemini"]; // godot: o agente constrói uma cena nova na biblioteca do Godot (godot/library/, doc/godot/cenas.md). export type AgentKind = "free" | "story" | "script" | "scene" | "branches" | "godot" | "character"; export const AGENT_KINDS: AgentKind[] = ["free", "story", "script", "scene", "branches", "godot", "character"]; @@ -138,6 +139,8 @@ export type AgentRun = { story_id: string | null; episode_id: number | null; resume_of: number | null; + /** Execução que falhou por indisponibilidade e que esta continuou com a IA reserva. */ + fallback_of: number | null; status: AgentStatus; session_id: string | null; cost_usd: number | null;