IA: Claude, Codex e Gemini com login, chave de API e IA reserva; Configurações em subpáginas

- Configurações → IA (/settings/ai): um cartão por IA para instalar/atualizar a CLI pelo painel, ligar,
  entrar com a conta (OAuth pela própria CLI, num terminal) ou colar a chave de API, e testar.
  Chaves cifradas com a DPAPI do Windows em data/ai/vault.bin; só vão para a CLI no ambiente da chamada.
- Gemini CLI como terceiro agente do painel (stream-json, edição automática, shell só o liberado).
- IA reserva: execução que cai por indisponibilidade (cota, 429, login, chave, rede) pausa a IA e recomeça
  a mesma tarefa na próxima pronta da ordem; migração v10 (agent_runs.fallback_of).
- Configurações viraram subpáginas (IA, Publicação, Apps das redes, Navegador, Sobre os modos), também no
  menu lateral; links antigos apontam para a subpágina certa.
- Contrato com o Clipador em doc/ia.md; skill do CenaForge atualizada até a 1.51.0.

O login gratuito do Gemini CLI para conta pessoal foi encerrado pelo Google (IneligibleTierError): para
conta pessoal, use a chave do AI Studio.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-18 01:51:12 -03:00
co-authored by Claude Opus 5.5
parent 0567c7454a
commit ed31d52df0
40 changed files with 1900 additions and 186 deletions
+44
View File
@@ -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. 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 ## 1.48.0 — 17/11/2026
Cartoon: acabamento de ilustração dos personagens (detalhe de rosto/corpo, acessórios, enquadramento e textura). Cartoon: acabamento de ilustração dos personagens (detalhe de rosto/corpo, acessórios, enquadramento e textura).
File diff suppressed because one or more lines are too long
+44
View File
@@ -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 <sessão>`, 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.
+77 -20
View File
@@ -12,7 +12,7 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You
| O quê | Onde | | 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/<id>/` (frames em `frames/`) | | Blocos gravados (`.ts` de 30 s + `segments.csv`) e frames | `data/clipper/sessions/<id>/` (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` | | 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/<sessão>/clip-<id>.mp4` + `clip-<id>.jpg` | | Cortes prontos | `output/clipper/<sessão>/clip-<id>.mp4` + `clip-<id>.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 | | 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` | | 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 | | 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` | — | | 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` | | 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 — 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` | | 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` | | 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 | | 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` | | 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) | | 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 | | 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 | | 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 | | 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) | | 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` | — | | 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) | | 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 - **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. 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`) - Provedores `codex` (padrão `gpt-6-luna`; lista de `~/.codex/models_cache.json`), `claude` (`haiku`/`sonnet`/`opus`),
ou `off` (só a heurística). `gemini` (`Judge._gemini`: `gemini -p <instrução curta> -o json --approval-mode plan --skip-trust -m <modelo>`, 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`, - **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, `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. 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 - 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 `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). [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`) ## 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: 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). 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) ## 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 | | Rota | Faz |
|---|---| |---|---|
| `GET /v1/games` | perfis com `status`, `model`, `researchedAt`, `editedAt`, `notes` (`[{text, at, section?}]`) e `profile` | | `GET /v1/games` | perfis com `status`, `error`, `model`, `researchedAt`, `editedAt`, `translatedAt`, `notes` (`[{text, at, section?}]`), `aliases`, `profile`, `profileAi` |
| `POST /v1/games/{id}/research` | refaz o perfil do zero pela web (`RESEARCH_TIMEOUT_S` 420); os pedidos guardados entram no prompt | | `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 |
| `PUT /v1/games/{id}` | grava o perfil editado à mão: `name`, `summary`, `genre`, `mechanics`, `clip_worthy`, `avoid`, `jargon`, `news`, `hashtags`, `sources` | | `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}/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` | | `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á) | | `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/<id>/(research|refine|translate|notes/n)`;
`METHODS` dá GET/POST a `games` e PUT/DELETE a `games/<id>`; 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. - `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. São guardados os últimos 30 pedidos.
- **Pedido guardado sobrevive a "Pesquisar de novo"** (`research_game(name, title, notes)`; `PROFILE_SYSTEM` manda - **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 `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"). 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)`. `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), - Painel: lista em `/clipper/games` e modal por `?game=ID` (`clipper-game-dialog.tsx`, `clipper-game-parts.tsx`); o chat
"Editar" (uma linha por item) e "Pesquisar de novo". Cada seção é um cartão com "Pedir à IA", que abre o chat `AiChat` tem a chave "Confirmar na web" **desligada** por padrão, embora a API use `search=true`. A conversa só existe
daquela seção (`AiChat`: Enter envia, Shift+Enter quebra linha, chave "Confirmar na web" **desligada** por enquanto o chat está aberto; o que fica salvo é o pedido (aba "Pedidos à IA", com X). Tipos `Game`, `GameProfile`,
padrão no painel, embora a API use `search=true` por padrão). Item recém-acrescentado aparece com selo "novo". `GameMission` em `panel/src/components/clipper-client.ts`. Detalhes visuais em [panel.md](panel.md).
"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).
## Regras ## Regras
@@ -371,6 +417,17 @@ Toda rota abaixo devolve a lista inteira (mesma forma de `GET /v1/games`).
## Testes e evidência ## 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 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. 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; 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 - 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-<id>/` depois de apagar; relógio da sessão com movimento reduzido, aba escondida e andamento gravando em `edit-<id>/` 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 - 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 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 editor com reenquadramento e camadas comparado com a prévia (pendente, depois do reinício do serviço); camadas na
+46 -2
View File
@@ -3,7 +3,7 @@
Cada item: **sintoma → causa → correção → onde está tratado**. Observadas na implementação da 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 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` `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 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. (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 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`. 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 "<título>" cmd.exe /k "<linha>"` 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: Relacionadas, já registradas acima:
- Patch por script em arquivos CRLF do painel (`lib/metrics.ts`, `components/metrics-view.tsx`, `dashboard-controls.tsx`, - 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. `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. - `codex.cmd` sem shell: item 28.
- Script de patch com regex (`\b`) passado por heredoc: item 44. - 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). - 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).
+45 -12
View File
@@ -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. (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). - `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/` - Migração em `panel/src/lib/db.ts` (lista `MIGRATIONS`). Banco com dados → cópia em `data/backups/`
antes de migrar (`cenaforge-v<atual>-<data>.db`). `foreign_keys = OFF` fora da transação e `PRAGMA antes de migrar (`cenaforge-v<atual>-<data>.db`). `foreign_keys = OFF` fora da transação e `PRAGMA
foreign_key_check` antes do `COMMIT` de cada versão. foreign_key_check` antes do `COMMIT` de cada versão.
- v3: `account_channels` (conta ↔ canal de live do Clipador; `status` `active`/`ended`). O canal - 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. 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 - v4: reconstrói `stories` (SQLite não altera CHECK) para `kind` aceitar `'documentary'`; mesmas
colunas e ids. colunas e ids.
- v5: publicação real — `publish_jobs`, `app_settings`, `clip_auto_approvals`; `account_networks` e `publications` - 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` - 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). `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. - 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 - 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. `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 - 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 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 "a confirmar"); no **Codex** manda ler os guias e escrever sozinho, sem usar `.claude/agents/` (mesma
regra no `AGENTS.md`). 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 - 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 (…)" 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 <slug>`. Em 17/11/2026: 8 modelos = `model = "..."` do `config.toml`. O id vai em `codex exec -m <slug>`. 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?, 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 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). 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 - O agente roda dentro do processo do painel: reiniciar o `pnpm panel` o mata (gotchas, item 131). Limite de uso no
Claude/Codex para a tarefa no meio: continue no outro provedor com o contexto (item 132). 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). - Prompt do Codex manda ler texto no PowerShell com `Get-Content -Raw -Encoding UTF8` (gotchas, item 98).
### Mensagem com o agente rodando ### 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) ## 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 - `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 "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 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 = - `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`) 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. 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 "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 (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 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` 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 (`useScanInterval`; reserva 180 = `OPTION_DEFAULTS` de `intel.py`). Existe porque o dono achou que o resumo
travava (gotchas, item 115). travava (gotchas, item 115).
- `clipper-games.tsx`: aba Jogos e emotes. O card do jogo tem selo de iniciais (primeira + última palavra, cor - Jogos (`clipper-games-page.tsx` + `clipper-game-dialog.tsx` + `clipper-game-parts.tsx`; `clipper-games.tsx` guarda
por `hueOf`) e os botões "Conversar com a IA", "Editar" e "Pesquisar de novo". Cada seção é um cartão com os emotes do canal): lista em tabela; o modal tem alternância **Português (você lê) / English (vai para a IA)** e abas
barra colorida, contador e "Pedir à IA", que abre o chat inline `AiChat` (balões, atalhos de pedido por seção, Visão geral · Rende corte · Missões · Gatilhos de fim · Termos e hashtags · Fontes · Pedidos à IA, com Pesquisar de
indicador de digitação, "+N itens novos / −N removidos"). Item novo fica verde com selo "novo". Gírias viram novo, Editar, Pedir à IA (`AiChat`: atalhos por seção, "+N itens novos / −N removidos") e Apagar. Editar grava no
chips, e Fontes e "Memória da IA" ficam recolhidas. A aba também mostra os emotes do canal com usos e peso. idioma da alternância e o serviço traduz o outro. Rotas e regras em [clipper.md](clipper.md#perfil-do-jogo-aba-jogos).
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` - `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. −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`): - **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 (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 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 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.
+3 -2
View File
@@ -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 | | 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 | | @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 | | 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 <slug>`, 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 <slug>`, 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) | | 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)): 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 | | 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 | | 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 | | 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/<id>/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/`) | | `.glb` carregado por `GLTFDocument` em tempo de execução (Godot) | modelos prontos dentro de cenas da biblioteca (`library/<id>/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/`) |
+82
View File
@@ -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=<chave>` |
| `codex` | remove `CODEX_API_KEY` | `CODEX_API_KEY=<chave>` |
| `gemini` | `GOOGLE_GENAI_USE_GCA=true`, remove `GEMINI_API_KEY` | `GEMINI_API_KEY=<chave>`, 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 <prompt> -o stream-json --approval-mode auto_edit --skip-trust [-m <modelo>] [--resume <sessão>]`.
- 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": "<texto>", "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 <prefixo npm>/node_modules/@google/gemini-cli/bundle/gemini.js`.
+1 -1
View File
@@ -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." 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={<> meta={<>
<Meta icon={<PublishIcon size={15} />}>Fila e horários em <Link href="/publishing" className="text-fg-muted underline underline-offset-2 hover:text-fg">Publicações</Link></Meta> <Meta icon={<PublishIcon size={15} />}>Fila e horários em <Link href="/publishing" className="text-fg-muted underline underline-offset-2 hover:text-fg">Publicações</Link></Meta>
<Meta icon={<SettingsIcon size={15} />}>Apps das redes e horários bons em <Link href="/settings" className="text-fg-muted underline underline-offset-2 hover:text-fg">Configurações</Link></Meta> <Meta icon={<SettingsIcon size={15} />}>Apps das redes e horários bons em <Link href="/settings/publishing" className="text-fg-muted underline underline-offset-2 hover:text-fg">Configurações</Link></Meta>
</>} /> </>} />
<div className="grid gap-6"> <div className="grid gap-6">
+2 -2
View File
@@ -7,7 +7,7 @@ import { addManualComments, closeDecision, decisionVotes } from "@/lib/decisions
import { defaultModelFor, defaultProviderFor, startRun } from "@/lib/agents"; import { defaultModelFor, defaultProviderFor, startRun } from "@/lib/agents";
import { slugify } from "@/lib/paths"; import { slugify } from "@/lib/paths";
import { UserError, createEpisode, createStory, deleteStory, getEpisodeById, getStory, provisionalTitle } from "@/lib/stories"; 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; 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). // 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 ep = createEpisode(story.id, { title: kind === "documentary" ? "" : "Abertura" });
const chosen = String(form.get("provider") ?? ""); 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. // 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 model = String(form.get("model") ?? "") || defaultModelFor("story", provider);
const run = startRun({ const run = startRun({
+2 -2
View File
@@ -24,13 +24,13 @@ export default async function AgentPage({ searchParams }: { searchParams: Promis
const defaults: AgentDefaults = { const defaults: AgentDefaults = {
provider: map(defaultProviderFor), provider: map(defaultProviderFor),
preferred: PREFERRED_PROVIDER, 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 ( return (
<> <>
<PageHeader eyebrow="Agentes de código" title="Console do agente" <PageHeader eyebrow="Agentes de código" title="Console do agente"
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. Um agente roda por vez, sempre dentro do projeto." /> 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." />
<div className="grid items-start gap-8 xl:grid-cols-[minmax(0,1fr)_20rem] 2xl:grid-cols-[minmax(0,1fr)_26rem]"> <div className="grid items-start gap-8 xl:grid-cols-[minmax(0,1fr)_20rem] 2xl:grid-cols-[minmax(0,1fr)_26rem]">
<AgentConsole <AgentConsole
key={runId ?? "novo"} key={runId ?? "novo"}
+75
View File
@@ -0,0 +1,75 @@
import { clearCooldown, openLoginTerminal, providerStatus, readAiSettings, setApiKey, startInstall, testProvider } from "@/lib/ai";
import { errorResponse, readJson } from "@/lib/http";
import { UserError } from "@/lib/stories";
import { PROVIDERS, type Provider } from "@/lib/types";
export const dynamic = "force-dynamic";
type Ctx = { params: Promise<{ provider: string }> };
async function mustProvider(ctx: Ctx): Promise<Provider> {
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);
}
}
+24
View File
@@ -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?: {<ia>?: {enabled?, authMode?}}, order?: [...], fallback?: {enabled?, cooldownMin?}}. */
export async function PUT(request: Request) {
try {
const settings = updateAiSettings(await readJson<AiSettingsPatch>(request));
return Response.json({ settings, providers: providerStatus() });
} catch (error) {
return errorResponse(error);
}
}
+2 -2
View File
@@ -5,7 +5,7 @@ import { defaultModelFor, defaultProviderFor, startRun } from "@/lib/agents";
import { errorResponse } from "@/lib/http"; import { errorResponse } from "@/lib/http";
import { slugify } from "@/lib/paths"; import { slugify } from "@/lib/paths";
import { UserError, createEpisode, createStory, getStory, provisionalTitle } from "@/lib/stories"; 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) { export async function POST(request: Request) {
try { try {
@@ -20,7 +20,7 @@ export async function POST(request: Request) {
for (let n = 2; getStory(id); n++) id = `${base}-${n}`; for (let n = 2; getStory(id); n++) id = `${base}-${n}`;
const story = createStory({ title, id, logline: "", kind, branchCount: 2 }); const story = createStory({ title, id, logline: "", kind, branchCount: 2 });
const ep = createEpisode(story.id, { title: kind === "documentary" ? "" : "Abertura" }); 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 model = String(body.model ?? "") || defaultModelFor("story", provider);
const run = startRun({ provider, model, kind: "story", request: text, storyId: story.id, episodeId: ep.id }); 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 }); return Response.json({ storyId: story.id, episodeId: ep.id, runId: run.id });
+2 -2
View File
@@ -10,7 +10,7 @@ import {
} from "@/components/ui"; } from "@/components/ui";
import { defaultProviderFor, models, providers } from "@/lib/agents"; import { defaultProviderFor, models, providers } from "@/lib/agents";
import { listEpisodes, listStories } from "@/lib/stories"; 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() { export default async function HomePage() {
await connection(); await connection();
@@ -18,7 +18,7 @@ export default async function HomePage() {
const totalEpisodes = stories.reduce((sum, s) => sum + s.episodes.length, 0); 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 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 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<Provider, boolean>;
return ( return (
<> <>
+1 -1
View File
@@ -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." 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={<> meta={<>
<Meta icon={<PublishIcon size={15} />}>Redes e regras em <Link href="/accounts" className="text-fg-muted underline underline-offset-2 hover:text-fg">Canais de publicação</Link></Meta> <Meta icon={<PublishIcon size={15} />}>Redes e regras em <Link href="/accounts" className="text-fg-muted underline underline-offset-2 hover:text-fg">Canais de publicação</Link></Meta>
<Meta icon={<ClockIcon size={15} />}>Horários bons em <Link href="/settings" className="text-fg-muted underline underline-offset-2 hover:text-fg">Configurações</Link></Meta> <Meta icon={<ClockIcon size={15} />}>Horários bons em <Link href="/settings/publishing" className="text-fg-muted underline underline-offset-2 hover:text-fg">Configurações</Link></Meta>
<Meta icon={<SettingsIcon size={15} />}>O painel precisa estar aberto para publicar</Meta> <Meta icon={<SettingsIcon size={15} />}>O painel precisa estar aberto para publicar</Meta>
</>} /> </>} />
<PublishingBoard /> <PublishingBoard />
+7
View File
@@ -0,0 +1,7 @@
import { AiSettings } from "@/components/ai-settings";
export const metadata = { title: "IA · Configurações" };
export default function Page() {
return <AiSettings />;
}
+7
View File
@@ -0,0 +1,7 @@
import { AppsTab } from "@/components/settings-panel";
export const metadata = { title: "Apps das redes · Configurações" };
export default function Page() {
return <AppsTab />;
}
+7
View File
@@ -0,0 +1,7 @@
import { BrowserTab } from "@/components/settings-panel";
export const metadata = { title: "Navegador · Configurações" };
export default function Page() {
return <BrowserTab />;
}
+9
View File
@@ -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 <SettingsShell>{children}</SettingsShell>;
}
+7
View File
@@ -0,0 +1,7 @@
import { ModesTab } from "@/components/settings-panel";
export const metadata = { title: "Sobre os modos · Configurações" };
export default function Page() {
return <ModesTab />;
}
+3 -12
View File
@@ -1,15 +1,6 @@
import { SettingsPanel } from "@/components/settings-panel"; import { redirect } from "next/navigation";
import { PageHeader } from "@/components/ui";
export const metadata = { title: "Configurações" }; /** /settings abre a primeira seção (IA); cada seção tem a própria página. */
/** Configurações do painel: publicação, apps das redes, navegador da sessão logada e a explicação dos modos. */
export default function SettingsPage() { export default function SettingsPage() {
return ( redirect("/settings/ai");
<>
<PageHeader eyebrow="Painel" title="Configurações"
description="Horários de publicação, os apps de cada rede e o navegador usado na sessão logada. Tudo fica só neste computador." />
<SettingsPanel />
</>
);
} }
@@ -0,0 +1,7 @@
import { PublishingTab } from "@/components/settings-panel";
export const metadata = { title: "Publicação · Configurações" };
export default function Page() {
return <PublishingTab />;
}
+1 -1
View File
@@ -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" }, { value: "best_slot", label: "No próximo horário bom", hint: "Mais gente vendo" },
]} /> ]} />
<p className="text-[0.8125rem] leading-relaxed text-fg-subtle"> <p className="text-[0.8125rem] leading-relaxed text-fg-subtle">
Os horários bons de cada rede ficam em <TextLink href="/settings">Configurações</TextLink>. Entre dois vídeos na mesma rede fica pelo menos 1 hora. Os horários bons de cada rede ficam em <TextLink href="/settings/publishing">Configurações</TextLink>. Entre dois vídeos na mesma rede fica pelo menos 1 hora.
</p> </p>
</div> </div>
+4 -4
View File
@@ -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 }, { id: "free", label: "Pedido livre", description: "Ajustes no projeto, testes, iluminação", icon: ChatIcon },
]; ];
export const PROVIDER_LABEL: Record<Provider, string> = { claude: "Claude Code", codex: "GPT · Codex" }; export const PROVIDER_LABEL: Record<Provider, string> = { claude: "Claude Code", codex: "GPT · Codex", gemini: "Gemini" };
const PROVIDER_SHORT: Record<Provider, string> = { claude: "Claude", codex: "GPT" }; const PROVIDER_SHORT: Record<Provider, string> = { claude: "Claude", codex: "GPT", gemini: "Gemini" };
const PLACEHOLDER: Record<AgentKind, string> = { const PLACEHOLDER: Record<AgentKind, string> = {
story: "Ex.: Um entregador recebe um pacote sem remetente; toda vez que tenta entregar, o endereço muda. Suspense leve com humor.", 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 */}
<fieldset className="grid gap-3"> <fieldset className="grid gap-3">
<legend className="mb-3 text-eyebrow font-semibold uppercase text-fg-subtle">2 · Agente</legend> <legend className="mb-3 text-eyebrow font-semibold uppercase text-fg-subtle">2 · Agente</legend>
<div className="grid gap-3 md:grid-cols-2"> <div className="grid gap-3 md:grid-cols-3">
{props.providers.map((p) => ( {props.providers.map((p) => (
<ProviderCard key={p.id} info={p} selected={provider === p.id} recommended={preferred === p.id} <ProviderCard key={p.id} info={p} selected={provider === p.id} recommended={preferred === p.id}
onSelect={() => chooseProvider(p.id)} /> onSelect={() => chooseProvider(p.id)} />
@@ -334,7 +334,7 @@ function ProviderCard({ info, selected, recommended, onSelect }:
<span className="flex flex-wrap items-center gap-2"> <span className="flex flex-wrap items-center gap-2">
<span className="text-sm font-semibold text-fg">{PROVIDER_LABEL[info.id]}</span> <span className="text-sm font-semibold text-fg">{PROVIDER_LABEL[info.id]}</span>
{recommended && <Badge tone="accent" dot={false}>padrão desta tarefa</Badge>} {recommended && <Badge tone="accent" dot={false}>padrão desta tarefa</Badge>}
{!info.available && <Badge tone="warning" dot={false}>não instalado</Badge>} {!info.available && <Badge tone="warning" dot={false}>não está pronto</Badge>}
</span> </span>
<span id={hintId} className="grid gap-1 text-xs leading-relaxed text-fg-subtle"> <span id={hintId} className="grid gap-1 text-xs leading-relaxed text-fg-subtle">
{info.version && <span className="font-mono text-[0.6875rem] text-fg-muted">{info.version}</span>} {info.version && <span className="font-mono text-[0.6875rem] text-fg-muted">{info.version}</span>}
+358
View File
@@ -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<T> = { ok: true; data: T } | { ok: false; error: string };
type Message = { ok: boolean; text: string } | null;
async function aiCall<T = Payload>(path: string, method = "GET", body?: unknown): Promise<Result<T>> {
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<Provider, string> = {
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<Payload | null>(null);
const [error, setError] = useState<string | null>(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 (
<div className="grid justify-items-start gap-3">
<Feedback ok={false}>Não deu para ler as IAs: {error}</Feedback>
<Button variant="secondary" size="sm" onClick={() => void load()}><RefreshIcon size={15} />Tentar de novo</Button>
</div>
);
}
if (!data) return <p role="status" className="flex items-center gap-2 text-sm text-fg-muted"><Spinner />Procurando as CLIs neste computador…</p>;
const readyCount = data.providers.filter((p) => p.ready).length;
const byId = Object.fromEntries(data.providers.map((p) => [p.id, p])) as Record<Provider, ProviderStatus>;
return (
<div className="grid gap-8">
{readyCount === 0 && (
<Feedback ok={false}>Nenhuma IA está pronta. Instale pelo menos uma abaixo e entre com a conta (ou cole uma chave de API).</Feedback>
)}
<FallbackCard data={data} onChange={setData} />
<section aria-labelledby="ias" className="grid gap-4">
<div className="flex flex-wrap items-end justify-between gap-3">
<div>
<h2 id="ias" className="text-base font-semibold text-fg">As IAs deste computador</h2>
<p className="mt-1 max-w-[75ch] text-sm text-fg-subtle">
Cada uma roda pela CLI oficial. <strong className="font-medium text-fg-muted">Conta</strong> usa a assinatura em que você já paga
(login no navegador); <strong className="font-medium text-fg-muted">chave de API</strong> cobra por uso e fica cifrada neste PC.
</p>
</div>
<Button variant="ghost" size="sm" onClick={() => void load(true)}><RefreshIcon size={15} />Procurar de novo</Button>
</div>
<div className="grid gap-5 xl:grid-cols-3">
{data.settings.order.map((id) => <ProviderCard key={id} status={byId[id]} onChange={setData} />)}
</div>
</section>
</div>
);
}
/* ---------- Reserva ---------- */
function FallbackCard({ data, onChange }: { data: Payload; onChange: (next: Payload) => void }) {
const { settings } = data;
const [busy, setBusy] = useState<string | null>(null);
const [message, setMessage] = useState<Message>(null);
const byId = Object.fromEntries(data.providers.map((p) => [p.id, p])) as Record<Provider, ProviderStatus>;
async function save(key: string, patch: Partial<{ order: Provider[]; fallback: Partial<AiSettings["fallback"]> }>, 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 (
<Card eyebrow={<><RefreshIcon size={13} />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.">
<div className="grid gap-6 lg:grid-cols-[minmax(0,1fr)_minmax(0,1.2fr)]">
<div className="grid content-start gap-5">
<Switch label="Trocar de IA sozinho" checked={settings.fallback.enabled} busy={busy === "enabled"}
hint={settings.fallback.enabled ? "Ligado: a tarefa continua na próxima IA, que confere o que a anterior já fez." : "Desligado: a tarefa para com erro e você escolhe outra IA."}
onChange={(enabled) => void save("enabled", { fallback: { enabled } }, enabled ? "Reserva ligada." : "Reserva desligada.")} />
<Field label="Depois de cair, pular a IA por" hint="Evita insistir numa IA sem cota. Dá para tirar da pausa no cartão dela.">
<Select value={settings.fallback.cooldownMin} disabled={busy === "cooldown"}
onChange={(e) => void save("cooldown", { fallback: { cooldownMin: Number(e.target.value) } }, "Pausa salva.")}>
{[...new Set([...COOLDOWN_OPTIONS, settings.fallback.cooldownMin])].sort((a, b) => a - b)
.map((m) => <option key={m} value={m}>{m < 60 ? `${m} minutos` : `${m / 60} hora${m > 60 ? "s" : ""}`}</option>)}
</Select>
</Field>
</div>
<div className="grid content-start gap-2">
<span className="text-[0.8125rem] font-medium text-fg-muted">Ordem de uso</span>
<ol className="grid gap-2">
{settings.order.map((id, index) => {
const p = byId[id];
const badge = statusBadge(p);
return (
<li key={id} className={cx("flex items-center gap-3 rounded-control border border-line bg-sunken/60 px-3 py-2", !p.ready && "opacity-70")}>
<span className="grid size-6 shrink-0 place-items-center rounded-full bg-overlay text-xs font-semibold tabular-nums text-fg-muted">{index + 1}</span>
<span className="min-w-0 flex-1 truncate text-sm font-medium text-fg">{p.label}</span>
<Badge tone={badge.tone}>{badge.text}</Badge>
<span className="flex gap-1">
<Button variant="ghost" size="sm" aria-label={`Subir ${p.label}`} disabled={index === 0 || busy !== null}
onClick={() => move(index, -1)} className="px-2"><ArrowLeftIcon size={14} className="rotate-90" /></Button>
<Button variant="ghost" size="sm" aria-label={`Descer ${p.label}`} disabled={index === settings.order.length - 1 || busy !== null}
onClick={() => move(index, 1)} className="px-2"><ArrowLeftIcon size={14} className="-rotate-90" /></Button>
</span>
</li>
);
})}
</ol>
<p className="text-xs text-fg-subtle">IA desligada ou sem login/chave é pulada.</p>
</div>
</div>
{message && <div className="mt-5"><Feedback ok={message.ok}>{message.text}</Feedback></div>}
</Card>
);
}
/* ---------- Cartão de cada IA ---------- */
function ProviderCard({ status: p, onChange }: { status: ProviderStatus; onChange: (next: Payload) => void }) {
const [busy, setBusy] = useState<string | null>(null);
const [message, setMessage] = useState<Message>(null);
const [key, setKey] = useState("");
const badge = statusBadge(p);
async function act(name: string, call: () => Promise<Result<Payload>>, 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 (
<article aria-labelledby={`ia-${p.id}`}
className={cx("grid content-start gap-5 rounded-card border border-line bg-surface p-5 shadow-card", !p.settings.enabled && "opacity-80")}>
<header className="grid gap-3">
<div className="flex items-start justify-between gap-3">
<div className="min-w-0">
<h3 id={`ia-${p.id}`} className="flex flex-wrap items-center gap-2 text-base font-semibold text-fg">
<CpuIcon size={17} />{p.label}<span className="text-xs font-normal text-fg-subtle">{p.vendor}</span>
</h3>
<p className="mt-1 text-xs leading-relaxed text-fg-subtle">{PROVIDER_TAGLINE[p.id]}</p>
</div>
<Badge tone={badge.tone}>{badge.text}</Badge>
</div>
<Switch label="Usar esta IA" checked={p.settings.enabled} busy={busy === "enabled"}
hint={p.settings.enabled ? "Pode ser escolhida e entra na reserva." : "Nunca é chamada, nem como reserva."}
onChange={(enabled) => void act("enabled", () => aiCall("", "PUT", { providers: { [p.id]: { enabled } } }))} />
</header>
<InstallSection p={p} busy={busy} onInstall={() => void act("install", post("install"))} />
{p.installed && (
<section className="grid gap-3 border-t border-line pt-4" aria-label={`Como o ${p.label} entra`}>
<ChoiceGroup<AuthMode> 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: <span className="inline-flex items-center gap-1.5"><UsersIcon size={14} />Conta</span> },
{ value: "apiKey", label: <span className="inline-flex items-center gap-1.5"><KeyIcon size={14} />Chave de API</span> },
]} />
{p.settings.authMode === "oauth"
? <OAuthSection p={p} busy={busy}
onLogin={() => 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.")} />
: <ApiKeySection p={p} busy={busy} value={key} onValue={setKey}
onSave={() => 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.")} />}
</section>
)}
{p.installed && p.settings.enabled && (
<footer className="grid gap-3 border-t border-line pt-4">
{p.cooldown && (
<div className="flex flex-wrap items-center gap-2 rounded-control border border-danger/30 bg-danger-soft/50 px-3 py-2 text-xs text-danger">
<PauseIcon size={14} /><span className="min-w-0 flex-1">Em pausa até {time(p.cooldown.until)}: {p.cooldown.reason}</span>
<Button variant="ghost" size="sm" disabled={busy !== null} onClick={() => void act("resume", post("resume"), () => "Saiu da pausa.")}>
<PlayIcon size={14} />Tirar da pausa
</Button>
</div>
)}
<div className="flex flex-wrap items-center gap-3">
<Button variant="secondary" size="sm" disabled={busy !== null || !p.ready}
onClick={() => void act("test", post("test"))}>
{busy === "test" ? <><Spinner className="size-3.5" />Testando…</> : <><CheckIcon size={15} />Testar</>}
</Button>
<span className="text-xs text-fg-subtle">Faz uma pergunta mínima (poucos tokens) fora do projeto.</span>
</div>
{p.lastTest && (
<p className={cx("text-xs", p.lastTest.ok ? "text-success" : "text-danger")} role="status">
{p.lastTest.ok ? "Funcionou" : "Falhou"} às {time(p.lastTest.at)} · {(p.lastTest.ms / 1000).toFixed(1)} s · {p.lastTest.text}
</p>
)}
</footer>
)}
{message && <Feedback ok={message.ok}>{message.text}</Feedback>}
</article>
);
}
function InstallSection({ p, busy, onInstall }: { p: ProviderStatus; busy: string | null; onInstall: () => void }) {
const job = p.install;
const running = job?.status === "running";
return (
<section className="grid gap-3 border-t border-line pt-4" aria-label={`Instalação do ${p.label}`}>
{p.installed ? (
<div className="flex flex-wrap items-center justify-between gap-2">
<div className="grid min-w-0 gap-0.5">
<span className="flex items-center gap-1.5 text-sm text-fg"><CheckIcon size={14} className="text-success" />Instalada</span>
<span className="truncate font-mono text-[0.6875rem] text-fg-subtle" title={p.path ?? undefined}>{p.version}</span>
</div>
<Button variant="ghost" size="sm" disabled={running || busy !== null} onClick={onInstall}>
{running ? <><Spinner className="size-3.5" />Atualizando…</> : <><DownloadIcon size={14} />Atualizar</>}
</Button>
</div>
) : (
<div className="grid gap-3">
<p className="text-sm text-fg-muted">A CLI não foi encontrada neste computador.</p>
<div className="flex items-center gap-2 rounded-control border border-line bg-sunken px-3 py-2">
<code className="min-w-0 flex-1 truncate font-mono text-xs text-fg-muted">{p.meta.installCommand}</code>
<CopyButton text={p.meta.installCommand} label="Copiar comando" variant="ghost" size="sm" />
</div>
<Button variant="flame" size="sm" className="justify-self-start" disabled={running || busy !== null} onClick={onInstall}>
{running ? <><Spinner className="size-3.5" />Instalando…</> : <><DownloadIcon size={15} />Instalar {p.label}</>}
</Button>
</div>
)}
{job && (job.status !== "success" || !p.installed) && (
<details open={job.status !== "success"} className="rounded-control border border-line bg-sunken">
<summary className="cursor-pointer px-3 py-2 text-xs text-fg-muted">
{job.status === "running" ? "Instalando…" : job.status === "success" ? "Instalação concluída" : "A instalação falhou"} · log
</summary>
<pre className="max-h-48 overflow-auto px-3 pb-3 font-mono text-[0.6875rem] leading-relaxed whitespace-pre-wrap text-fg-subtle">{job.log.slice(-40).join("\n")}</pre>
</details>
)}
{job?.status === "success" && !p.installed && (
<Feedback ok={false}>Instalou, mas o painel ainda não acha a CLI (o PATH dele é o de quando abriu). Clique em &quot;Procurar de novo&quot; ou reinicie o <code>pnpm panel</code>.</Feedback>
)}
</section>
);
}
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 (
<div className="grid gap-3">
<p className="text-xs text-fg-subtle">{p.meta.oauthLabel}. O login é feito pela própria CLI: o painel nunca vê a senha.</p>
{p.oauth.detail && <p className={cx("text-sm", tone)}>{p.oauth.detail}</p>}
{p.meta.oauthNote && (
<p className="flex gap-2 rounded-control border border-warning/30 bg-warning-soft/40 px-3 py-2 text-xs leading-relaxed text-warning">
<AlertIcon size={14} className="mt-0.5 shrink-0" />{p.meta.oauthNote}
</p>
)}
<div className="flex flex-wrap gap-2">
{p.meta.canLogin && (
<Button variant={p.oauth.state === "yes" ? "ghost" : "primary"} size="sm" disabled={busy !== null} onClick={onLogin}>
{busy === "login" ? <Spinner className="size-3.5" /> : <LinkIcon size={14} />}{p.oauth.state === "yes" ? "Trocar de conta" : "Entrar com a conta"}
</Button>
)}
<Button variant="secondary" size="sm" disabled={busy !== null} onClick={onVerify}>
{busy === "verify" ? <Spinner className="size-3.5" /> : <RefreshIcon size={14} />}Verificar
</Button>
</div>
</div>
);
}
function ApiKeySection({ p, busy, value, onValue, onSave, onRemove }: {
p: ProviderStatus; busy: string | null; value: string; onValue: (v: string) => void; onSave: () => void; onRemove: () => void;
}) {
return (
<form className="grid gap-3" onSubmit={(e) => { e.preventDefault(); onSave(); }}>
{p.apiKey.saved && (
<div className="flex flex-wrap items-center justify-between gap-2 text-sm">
<span className="flex items-center gap-1.5 text-success"><KeyIcon size={14} />Chave salva <span className="font-mono text-xs text-fg-subtle">{p.apiKey.hint}</span></span>
<Button type="button" variant="ghost" size="sm" disabled={busy !== null} onClick={onRemove}><TrashIcon size={14} />Apagar</Button>
</div>
)}
<Field label={p.apiKey.saved ? "Trocar a chave" : p.meta.apiKeyLabel}
hint={<>Fica cifrada neste PC (DPAPI do Windows) e nunca volta para a tela. Vai para a CLI como <code>{p.meta.apiKeyEnv}</code> só na hora da chamada.</>}>
<Input type="password" autoComplete="off" spellCheck={false} value={value} onChange={(e) => onValue(e.target.value)} placeholder="Cole a chave aqui" />
</Field>
<div className="flex flex-wrap items-center gap-3">
<Button type="submit" size="sm" disabled={busy !== null || value.trim().length < 16}>
{busy === "key" ? <Spinner className="size-3.5" /> : <KeyIcon size={14} />}Salvar chave
</Button>
<ExternalLink href={p.meta.apiKeyUrl}>Criar uma chave</ExternalLink>
</div>
</form>
);
}
function ExternalLink({ href, children }: { href: string; children: ReactNode }) {
return (
<a href={href} target="_blank" rel="noreferrer" className="inline-flex items-center gap-1 text-xs text-fg-muted underline underline-offset-2 hover:text-fg">
{children}<LinkIcon size={12} />
</a>
);
}
+2 -2
View File
@@ -341,7 +341,7 @@ export function ConnectWizard({ accountId, accountName, platform, network, recon
)} )}
<div aria-live="assertive" className="empty:hidden"> <div aria-live="assertive" className="empty:hidden">
{error && <Feedback ok={false}>{error}{/app|client/i.test(error) && <> Veja <Link className="underline" href="/settings?tab=apps">Configurações › Apps das redes</Link>.</>}</Feedback>} {error && <Feedback ok={false}>{error}{/app|client/i.test(error) && <> Veja <Link className="underline" href="/settings/apps">Configurações › Apps das redes</Link>.</>}</Feedback>}
</div> </div>
</section> </section>
)} )}
@@ -417,7 +417,7 @@ function ModeCard({ platform, mode, checked, appMissing, onSelect }: {
{appMissing && ( {appMissing && (
<span className="ml-8 flex gap-2 rounded-control border border-info/30 bg-info-soft px-3 py-2 text-[0.8125rem] leading-relaxed text-info"> <span className="ml-8 flex gap-2 rounded-control border border-info/30 bg-info-soft px-3 py-2 text-[0.8125rem] leading-relaxed text-info">
<AlertIcon size={15} className="mt-0.5" /> <AlertIcon size={15} className="mt-0.5" />
<span>O app do {label} ainda não foi configurado. Faça isso antes em <Link href="/settings?tab=apps" className="font-semibold underline">Configurações › Apps das redes</Link>.</span> <span>O app do {label} ainda não foi configurado. Faça isso antes em <Link href="/settings/apps" className="font-semibold underline">Configurações › Apps das redes</Link>.</span>
</span> </span>
)} )}
</label> </label>
+1 -1
View File
@@ -132,7 +132,7 @@ export function MetricsSyncControls({ syncs, accountId, everyHours, showAccount
<h2 className="text-sm font-semibold text-fg">Números das redes</h2> <h2 className="text-sm font-semibold text-fg">Números das redes</h2>
<p className="text-xs leading-relaxed text-fg-subtle"> <p className="text-xs leading-relaxed text-fg-subtle">
{everyHours > 0 ? `O painel lê sozinho a cada ${everyHours} h (com o painel aberto).` : "Leitura automática desligada: só pelo botão."}{" "} {everyHours > 0 ? `O painel lê sozinho a cada ${everyHours} h (com o painel aberto).` : "Leitura automática desligada: só pelo botão."}{" "}
Muda em <Link href="/settings" className="underline underline-offset-2 hover:text-fg">Configurações</Link>. Muda em <Link href="/settings/publishing" className="underline underline-offset-2 hover:text-fg">Configurações</Link>.
TikTok e Instagram abrem a janela do navegador por alguns segundos. TikTok e Instagram abrem a janela do navegador por alguns segundos.
</p> </p>
</div> </div>
+1 -1
View File
@@ -251,7 +251,7 @@ export function PublishingBoard() {
action={<Button size="sm" onClick={() => void resume()} disabled={resumeBusy}> action={<Button size="sm" onClick={() => void resume()} disabled={resumeBusy}>
{resumeBusy ? <Spinner className="size-3.5" /> : <PublishIcon size={15} />}Retomar {resumeBusy ? <Spinner className="size-3.5" /> : <PublishIcon size={15} />}Retomar
</Button>}> </Button>}>
Nada sai para as redes até você retomar. Dá para aprovar e agendar normalmente. A pausa também fica em <TextLink href="/settings">Configurações</TextLink>. Nada sai para as redes até você retomar. Dá para aprovar e agendar normalmente. A pausa também fica em <TextLink href="/settings/publishing">Configurações</TextLink>.
</NoticeBar> </NoticeBar>
)} )}
</div> </div>
+12 -31
View File
@@ -1,11 +1,12 @@
"use client"; "use client";
// Configurações do painel (por enquanto, tudo da publicação nas redes), em abas: // Seções de Configurações da publicação nas redes, cada uma numa subpágina (/settings/<seção>, ver settings-shell.tsx):
// Publicação — pausar tudo, horários bons por rede, fuso e de quanto em quanto tempo ler os números dos posts // 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); // (GET/PUT /api/settings);
// Apps das redes — passo a passo para criar o app de cada rede e os campos Client ID/Secret // 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; // (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; // BrowserTab — 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". // 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 { useCallback, useEffect, useState, type FormEvent, type ReactNode } from "react";
import type { Platform } from "@/lib/types"; import type { Platform } from "@/lib/types";
import { askConfirm } from "./confirm-dialog"; import { askConfirm } from "./confirm-dialog";
@@ -17,10 +18,8 @@ import {
type AppState, type PublisherStatus, type AppSettings, type AppState, type PublisherStatus, type AppSettings,
} from "./publishing-client"; } from "./publishing-client";
import { NoticeBar, PlatformName, TextLink } from "./publishing-ui"; 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"; 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; type Message = { ok: boolean; text: string } | null;
/** Ordem de exibição das redes nestas telas (a mais usada primeiro). */ /** 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" }, { value: "UTC", label: "UTC" },
]; ];
export function SettingsPanel() {
return (
<Tabs<TabId> label="Seções das configurações"
items={[
{ id: "publicacao", label: "Publicação", icon: <ClockIcon size={16} /> },
{ id: "apps", label: "Apps das redes", icon: <KeyIcon size={16} /> },
{ id: "navegador", label: "Navegador", icon: <GlobeIcon size={16} /> },
{ id: "modos", label: "Sobre os modos", icon: <InfoIcon size={16} /> },
]}
panels={{
publicacao: <PublishingTab />,
apps: <AppsTab />,
navegador: <BrowserTab />,
modos: <ModesTab />,
}} />
);
}
/* ---------- Publicação ---------- */ /* ---------- Publicação ---------- */
function PublishingTab() { export function PublishingTab() {
const [settings, setSettings] = useState<AppSettings | null>(null); const [settings, setSettings] = useState<AppSettings | null>(null);
const [draft, setDraft] = useState<AppSettings | null>(null); const [draft, setDraft] = useState<AppSettings | null>(null);
const [error, setError] = useState<string | null>(null); const [error, setError] = useState<string | null>(null);
@@ -244,7 +225,7 @@ const GUIDES: Record<"youtube" | "tiktok", Guide> = {
}, },
}; };
function AppsTab() { export function AppsTab() {
return ( return (
<div className="grid gap-6"> <div className="grid gap-6">
<p className="max-w-[75ch] text-sm leading-relaxed text-fg-muted"> <p className="max-w-[75ch] text-sm leading-relaxed text-fg-muted">
@@ -403,7 +384,7 @@ function ExternalLink({ href, children }: { href: string; children: ReactNode })
/* ---------- Navegador ---------- */ /* ---------- Navegador ---------- */
function BrowserTab() { export function BrowserTab() {
const [status, setStatus] = useState<PublisherStatus | null>(null); const [status, setStatus] = useState<PublisherStatus | null>(null);
const [busy, setBusy] = useState(false); const [busy, setBusy] = useState(false);
const load = useCallback(async () => { const load = useCallback(async () => {
@@ -474,7 +455,7 @@ const MODES_TABLE: Record<Platform, { official: string[]; session: string[] }> =
}, },
}; };
function ModesTab() { export function ModesTab() {
return ( return (
<div className="grid gap-6"> <div className="grid gap-6">
<Card title="Os dois jeitos de conectar uma rede" <Card title="Os dois jeitos de conectar uma rede"
+55
View File
@@ -0,0 +1,55 @@
"use client";
// Moldura das subpáginas de Configurações: cabeçalho + sub-navegação (a barra lateral usa a mesma lista).
// Cada seção é uma página própria (/settings/<seção>), 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 (
<div className="grid gap-6">
<PageHeader eyebrow="Painel" title={current ? `Configurações · ${current.label}` : "Configurações"}
description={current?.description ?? "Tudo fica só neste computador."} />
<nav aria-label="Seções das configurações" className="flex flex-wrap items-center gap-1 border-b border-line">
{SETTINGS_SECTIONS.map((s) => {
const active = current?.href === s.href;
const Icon = s.icon;
return (
<Link key={s.href} href={s.href} aria-current={active ? "page" : undefined}
className={cx("group relative flex h-11 items-center gap-2 rounded-t-control px-3 text-sm font-medium transition-colors",
"focus-visible:outline-2 focus-visible:outline-accent",
active ? "text-fg" : "text-fg-muted hover:bg-raised/70 hover:text-fg")}>
<span className={cx("flex", active ? "text-accent" : "text-fg-subtle group-hover:text-fg-muted")}><Icon size={16} /></span>
<span className="max-sm:sr-only">{s.label}</span>
{active && <span aria-hidden="true" className="absolute inset-x-2 -bottom-px h-0.5 rounded-full bg-accent" />}
</Link>
);
})}
</nav>
{children}
</div>
);
}
+7 -2
View File
@@ -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 { ChartIcon, CubeIcon, FilmIcon, MicIcon, PublishIcon, ScissorsIcon, SettingsIcon, SparkIcon, TerminalIcon, UsersIcon } from "./icons";
import { LogoMark, Wordmark } from "./logo"; import { LogoMark, Wordmark } from "./logo";
import { getSummary } from "./publishing-client"; import { getSummary } from "./publishing-client";
import { SETTINGS_SECTIONS, activeSettingsSection } from "./settings-shell";
import { cx } from "./ui"; import { cx } from "./ui";
type SubItem = { href: string; label: string; icon?: ComponentType<{ size?: number }> }; 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: "/characters", label: "Personagens", hint: "Elenco reaproveitável", icon: UsersIcon },
{ href: "/assets", label: "Assets", hint: "Biblioteca e envios", icon: CubeIcon }, { href: "/assets", label: "Assets", hint: "Biblioteca e envios", icon: CubeIcon },
{ href: "/voices", label: "Vozes", hint: "Narração e legenda", icon: MicIcon }, { 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. */ /** 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 }, { 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 { function useAwaitingCount(pathname: string): number | null {
const [count, setCount] = useState<number | null>(null); const [count, setCount] = useState<number | null>(null);
+11 -7
View File
@@ -13,7 +13,7 @@ import { Button, ChoiceGroup, Feedback, Input, Kbd, Select, Spinner, Textarea, c
const MIN_CHARS = 20; const MIN_CHARS = 20;
const MAX_CHARS = 20_000; const MAX_CHARS = 20_000;
const PROVIDER_NAME: Record<Provider, string> = { codex: "GPT · Codex", claude: "Claude" }; const PROVIDER_NAME: Record<Provider, string> = { codex: "GPT · Codex", claude: "Claude", gemini: "Gemini" };
export function StoryComposer({ autoProvider, available, models }: { export function StoryComposer({ autoProvider, available, models }: {
/** Agente que o modo automático vai usar agora (Codex, se estiver instalado). */ /** 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 [state, action, pending] = useActionState(createStoryFromTextAction, null);
const [length, setLength] = useState(0); const [length, setLength] = useState(0);
const [provider, setProvider] = useState<"" | "claude">(""); const [provider, setProvider] = useState<"" | Provider>("");
const [kind, setKind] = useState<StoryKind>(DEFAULT_STORY_FORMAT); const [kind, setKind] = useState<StoryKind>(DEFAULT_STORY_FORMAT);
const [model, setModel] = useState(""); const [model, setModel] = useState("");
const short = length > 0 && length < MIN_CHARS; 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"; const documentary = kind === "documentary";
return ( return (
@@ -85,8 +86,9 @@ export function StoryComposer({ autoProvider, available, models }: {
<ChoiceGroup name="provider" legend="Quem escreve" value={provider} <ChoiceGroup name="provider" legend="Quem escreve" value={provider}
onChange={(next) => { setProvider(next); setModel(""); }} onChange={(next) => { setProvider(next); setModel(""); }}
options={[ options={[
{ value: "", label: autoProvider === "codex" ? "GPT · Codex" : "Automático" }, { value: "", label: `Automático (${PROVIDER_NAME[autoProvider]})` },
{ value: "claude", label: "Claude", disabled: !available.claude }, ...(["claude", "codex", "gemini"] as const).filter((p) => p !== autoProvider)
.map((p) => ({ value: p, label: PROVIDER_NAME[p], disabled: !available[p] })),
]} /> ]} />
<label className="grid content-start gap-2"> <label className="grid content-start gap-2">
<span className="text-[0.8125rem] font-medium text-fg-muted">Modelo</span> <span className="text-[0.8125rem] font-medium text-fg-muted">Modelo</span>
@@ -96,8 +98,10 @@ export function StoryComposer({ autoProvider, available, models }: {
</label> </label>
</div> </div>
{!available.codex && ( {noneReady ? (
<p className="text-xs text-warning">O Codex não está instalado aqui: o modo automático vai usar o Claude. Instale com <code>npm install -g @openai/codex</code> e rode <code>codex login</code>.</p> <p className="text-xs text-warning">Nenhuma IA está pronta neste computador. Instale e entre com a conta (ou cole uma chave) em <a href="/settings/ai" className="underline">Configurações → IA</a>.</p>
) : !available.codex && (
<p className="text-xs text-fg-subtle">O Codex não está pronto: o automático usa {PROVIDER_NAME[autoProvider]}. Ajuste em <a href="/settings/ai" className="underline">Configurações → IA</a>.</p>
)} )}
<div className="flex flex-wrap items-center gap-x-5 gap-y-3 border-t border-line pt-6"> <div className="flex flex-wrap items-center gap-x-5 gap-y-3 border-t border-line pt-6">
+173 -68
View File
@@ -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"): // 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; // - 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; // - o pedido vai como argumento (sem shell); stdin fechado;
// - um agente por vez; cancelar encerra a árvore de processos. // - 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. // 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 fs from "node:fs";
import path from "node:path"; import path from "node:path";
import { all, get, now, run } from "./db"; import { all, get, now, run } from "./db";
import { DATA_DIR, REPO_ROOT, rel } from "./paths"; import { DATA_DIR, REPO_ROOT, rel } from "./paths";
import { buildPrompt } from "./prompts"; 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 { onAgentRunClosed } from "./branches";
import { UserError, getEpisodeById, getStory, syncStoryMeta } from "./stories"; import { UserError, getEpisodeById, getStory, syncStoryMeta } from "./stories";
import { AGENT_KINDS, type AgentEvent, type AgentKind, type AgentRun, type Provider } from "./types"; 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. */ /** Modelos que o seletor oferece por agente. */
export function models(): Record<Provider, ModelOption[]> { export function models(): Record<Provider, ModelOption[]> {
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). */ /** Modelo sugerido por tipo de tarefa (economia de tokens). */
@@ -106,15 +110,14 @@ export const DEFAULT_MODEL: Record<AgentKind, string> = { free: "", story: "", s
*/ */
export const PREFERRED_PROVIDER: Record<AgentKind, Provider> = { free: "claude", story: "codex", script: "codex", scene: "claude", branches: "codex", godot: "claude", character: "claude" }; export const PREFERRED_PROVIDER: Record<AgentKind, Provider> = { 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 { export function defaultProviderFor(kind: AgentKind): Provider {
const list = providers(); return readyChain(PREFERRED_PROVIDER[kind])[0] ?? PREFERRED_PROVIDER[kind];
const preferred = PREFERRED_PROVIDER[kind];
if (list.find((p) => p.id === preferred)?.available) return preferred;
return list.find((p) => p.available)?.id ?? preferred;
} }
/** Modelo padrão: o do tipo de tarefa só vale para o Claude; no Codex, o do config.toml. */ /** 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 { export function defaultModelFor(kind: AgentKind, provider: Provider): string {
if (provider === "gemini") return "";
return provider === "claude" ? DEFAULT_MODEL[kind] : CODEX_DEFAULT_MODEL[kind]; 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<AgentKind, string> = { free: "", story: "gpt-6.1-sol", script: "gpt-6.1-sol", branches: "gpt-6.1-sol", scene: "", godot: "", character: "" }; const CODEX_DEFAULT_MODEL: Record<AgentKind, string> = { 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). */ /** Uma IA como o console do agente a vê. `available` = pronta (ligada, instalada e com login ou chave). */
type ProviderInfo = { type ProviderInfo = { id: Provider; available: boolean; path: string | null; version: string | null; note: string };
id: Provider; available: boolean; path: string | null; version: string | null; note: string;
command: string | null; prefixArgs: string[];
};
/** /**
* Execução em andamento. `followUp`: mensagem do usuário enviada durante a execução; quando ela * 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. * fecha (sozinha ou interrompida), a mesma sessão é retomada com essa mensagem.
@@ -141,8 +141,10 @@ type ActiveRun = {
followUp: string | null; followUp: string | null;
/** O agente já deu um passo (texto ou ferramenta). Antes disso a sessão ainda não guardou o pedido. */ /** O agente já deu um passo (texto ou ferramenta). Antes disso a sessão ainda não guardou o pedido. */
progressed: boolean; 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<number, ActiveRun>; __cenaforgeProviders?: { at: number; list: ProviderInfo[] } }; const g = globalThis as unknown as { __cenaforgeAgents?: Map<number, ActiveRun> };
const active = (g.__cenaforgeAgents ??= new Map()); const active = (g.__cenaforgeAgents ??= new Map());
/** Há um agente trabalhando? (o executor roda um por vez) */ /** Há um agente trabalhando? (o executor roda um por vez) */
@@ -150,52 +152,23 @@ export function busy(): boolean {
return active.size > 0; return active.size > 0;
} }
/** const PROVIDER_NOTE: Record<Provider, string> = {
* Executável de um provedor. No Windows o npm instala o Codex como `codex.cmd` (que o Node claude: "Claude Code CLI em modo não interativo (-p, stream-json); edição automática dentro do projeto e comandos liberados.",
* não executa sem shell); nesse caso rodamos o `codex.js` do pacote diretamente pelo Node. 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).",
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;
}
/** 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[] { export function providers(): ProviderInfo[] {
// Cache curto: instalar ou remover uma CLI aparece sem reiniciar o painel. return providerStatus().map((p) => {
if (g.__cenaforgeProviders && Date.now() - g.__cenaforgeProviders.at < 60_000) return g.__cenaforgeProviders.list; const pause = p.cooldown
const detect = (id: Provider, envVar: string, note: string): ProviderInfo => { ? ` Em pausa até ${new Date(p.cooldown.until).toLocaleTimeString("pt-BR", { hour: "2-digit", minute: "2-digit" })} (${p.cooldown.reason}).`
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 { return {
id, available: !!resolved && version !== null, path: resolved?.path ?? null, version, id: p.id, available: p.ready, path: p.path, version: p.version,
note: resolved ? note : `${note} Não encontrado: instale e faça login${id === "codex" ? " (npm install -g @openai/codex; codex login)" : ""}.`, note: p.ready ? `${PROVIDER_NOTE[p.id]}${pause}` : `${PROVIDER_NOTE[p.id]} ${p.problem} Ajuste em Configurações → IA.`,
command: resolved?.command ?? null, prefixArgs: resolved?.prefixArgs ?? [],
}; };
}; });
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[] { export function listRuns(limit = 30): AgentRun[] {
@@ -209,9 +182,14 @@ export function getRun(id: number): AgentRun | undefined {
export function startRun(input: { export function startRun(input: {
provider: Provider; model: string; kind: AgentKind; request: string; provider: Provider; model: string; kind: AgentKind; request: string;
storyId?: string | null; episodeId?: number | null; resumeRunId?: number | null; 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 { }): AgentRun {
const info = providers().find((p) => p.id === input.provider); 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."); 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(); const request = input.request.trim();
if (request.length < 2) throw new UserError("Escreva o pedido."); 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."); 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"); const logDir = path.join(DATA_DIR, "logs", "agents");
fs.mkdirSync(logDir, { recursive: true }); 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) 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', '', ?)`, VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'running', '', ?)`,
input.provider, input.model, input.kind, request, story?.id ?? null, episode?.id ?? null, resume?.id ?? null, now()); 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 id = Number(row.lastInsertRowid);
const logPath = path.join(logDir, `${id}.jsonl`); const logPath = path.join(logDir, `${id}.jsonl`);
run("UPDATE agent_runs SET log_path = ? WHERE id = ?", rel(logPath), id); 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] : []), ...(resume?.session_id ? ["--resume", resume.session_id] : []),
...CLAUDE_LEAN_FLAGS, "--max-budget-usd", String(CLAUDE_BUDGET_USD[input.kind]), ...CLAUDE_LEAN_FLAGS, "--max-budget-usd", String(CLAUDE_BUDGET_USD[input.kind]),
"--allowedTools", CLAUDE_ALLOWED_TOOLS] "--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 listeners = new Set<(e: AgentEvent | null) => void>();
const log = fs.createWriteStream(logPath); const log = fs.createWriteStream(logPath);
const gemini: GeminiState = { text: "" };
const emit = (e: Omit<AgentEvent, "at">) => { const emit = (e: Omit<AgentEvent, "at">) => {
if (e.kind !== "system" && e.kind !== "stderr" && e.kind !== "error") entry.progressed = true; 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; const event = { ...e, at: now() } as AgentEvent;
log.write(JSON.stringify(event) + "\n"); log.write(JSON.stringify(event) + "\n");
for (const l of listeners) l(event); 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); 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) => { child.stdout.setEncoding("utf8").on("data", lineSplitter((line) => {
let obj: Record<string, unknown>; let obj: Record<string, unknown>;
@@ -269,7 +264,8 @@ export function startRun(input: {
emit({ kind: "text", text: line.slice(0, 2000) }); emit({ kind: "text", text: line.slice(0, 2000) });
return; 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); events.forEach(emit);
})); }));
child.stderr.setEncoding("utf8").on("data", lineSplitter((line) => { 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("error", (error) => emit({ kind: "error", text: `não iniciou: ${error.message}`, isError: true }));
child.on("close", (code) => { 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. // 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); if (input.kind === "story" && story && code === 0) syncStoryMeta(story.id);
const current = getRun(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); ok ? "success" : "error", ok ? null : `saiu com código ${code}`, now(), id);
} }
active.delete(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). // Vertentes: fecha o preparo desta execução e começa o próximo da fila (o executor já está livre).
try { try {
onAgentRunClosed(id, getRun(id)?.status === "success"); 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 { 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 { 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). // 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\]/]; /\[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<AgentEvent, "at">[] {
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<string, unknown>, runId: number, state: GeminiState): Omit<AgentEvent, "at">[] {
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<string, unknown> | 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 --------------------------------------------------------------- // --- normalização ---------------------------------------------------------------
type Block = { type?: string; text?: string; name?: string; input?: Record<string, unknown>; content?: unknown; is_error?: boolean }; type Block = { type?: string; text?: string; name?: string; input?: Record<string, unknown>; content?: unknown; is_error?: boolean };
+127
View File
@@ -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<string, unknown>) => 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);
});
});
+629
View File
@@ -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<Provider, ProviderSettings>;
/** 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<Provider, ProviderMeta> = {
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<AiSettings> = {};
try {
raw = JSON.parse(fs.readFileSync(SETTINGS_PATH, "utf8")) as Partial<AiSettings>;
} catch { /* ausente ou inválido: padrão */ }
const providers = {} as Record<Provider, ProviderSettings>;
for (const id of PROVIDERS) {
const item = (raw.providers as Record<string, Partial<ProviderSettings>> | 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<Record<Provider, Partial<ProviderSettings>>>;
order?: unknown;
fallback?: Partial<AiSettings["fallback"]>;
};
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<Record<Provider, string>>;
const g = globalThis as unknown as {
__cenaforgeAiVault?: { mtimeMs: number; data: VaultData };
__cenaforgeAiStatus?: { at: number; list: ProviderRuntime[] };
__cenaforgeAiInstalls?: Map<Provider, InstallJob>;
__cenaforgeAiCooldown?: Map<Provider, { until: number; reason: string }>;
__cenaforgeAiTests?: Map<Provider, TestResult>;
__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<string, unknown>;
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<string, string | undefined> = 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 "<linha>": 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<TestResult> {
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;
}
+4
View File
@@ -401,6 +401,10 @@ export const MIGRATIONS: string[] = [
` `
ALTER TABLE accounts ADD COLUMN language TEXT NOT NULL DEFAULT 'pt-BR'; 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 }; const g = globalThis as unknown as { __cenaforgeDb?: DatabaseSync };
+3 -2
View File
@@ -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`). " + "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. " + "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.", "Ao terminar, liste os arquivos criados ou alterados e o que ficou pendente.",
provider === "codex" provider !== "claude"
? "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. " + ? `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` " + "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 <json> --profile preview`." "(o `pnpm.ps1` é bloqueado pela política de execução): `pnpm.cmd render -- --config <json> --profile preview`."
: null, : null,
+1 -1
View File
@@ -61,7 +61,7 @@ describe("migração v5", () => {
it("migra com backup, preserva ids e não quebra chaves estrangeiras", () => { it("migra com backup, preserva ids e não quebra chaves estrangeiras", () => {
const version = dbm.get<{ user_version: number }>("PRAGMA user_version")!.user_version; const version = dbm.get<{ user_version: number }>("PRAGMA user_version")!.user_version;
assert.equal(version, dbm.MIGRATIONS.length); 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.equal(fs.readdirSync(path.join(ROOT, "data", "backups")).filter((f) => f.startsWith("cenaforge-v4-")).length, 1);
assert.deepEqual(dbm.all("PRAGMA foreign_key_check"), []); assert.deepEqual(dbm.all("PRAGMA foreign_key_check"), []);
}); });
+4 -1
View File
@@ -123,7 +123,8 @@ export type Decision = {
snapshot_json: string; 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). // 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 type AgentKind = "free" | "story" | "script" | "scene" | "branches" | "godot" | "character";
export const AGENT_KINDS: 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; story_id: string | null;
episode_id: number | null; episode_id: number | null;
resume_of: 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; status: AgentStatus;
session_id: string | null; session_id: string | null;
cost_usd: number | null; cost_usd: number | null;