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.
## 1.51.0 — 18/11/2026
IA: três provedores (Claude Code, Codex, Gemini CLI), login ou chave de API no cofre e IA reserva.
- `references/ai.md` (novo): onde mexer (`panel/src/lib/ai.ts`, `agents.ts`, `app/api/ai/`, `ai-settings.tsx`,
`clipper/app/ai_settings.py`, `judge.py`), regras (só o painel escreve `data/ai/`, chave só no ambiente da chamada,
quando a reserva troca), estado verificado. Contrato completo em `doc/ia.md`.
- `references/panel.md`: banco v10 (`agent_runs.fallback_of`); "Agentes e modelos" com 3 provedores, reserva e
Configurações em subpáginas (`SETTINGS_SECTIONS`).
- `references/clipper.md`: juiz com `gemini` e reserva por chamada; chave só pelo cofre do painel.
- `references/gotchas.md`: seção "IA" com 168–172 (OAuth do Gemini encerrado, `CODEX_API_KEY`, terminal de login no
Windows, custo da DPAPI, CLI fora do PATH). O 167 já era do perfil de jogo (1.50.0); numeração ajustada.
- `references/tools.md`: Gemini CLI como candidata (não instalada aqui, nunca executada); `--version` de Claude e Codex.
- `SKILL.md`: versão, `description`, esquema v10, linha "IA" em "Onde mexer", invariante da chave de API.
- Evidência (reexecutada): `claude` 2.1.314, `codex-cli` 0.169.0, `gemini` ausente; `ai.test.ts` 21/21; `pnpm test:clipper`
335 passed. Informado, não reexecutado: painel 104/104, ida e volta do cofre. Não verificado: Gemini com chave, `@arquivo`
de imagem no juiz, envelope de erro do `-o json`, UI no navegador.
## 1.50.0 — 18/11/2026
Clipador: perfis de jogo bilíngues, missões e gatilhos de fim, cadastro de jogo pelo painel, semente do GTA VI.
- `references/clipper.md`: banco em v12; seção "Perfil do jogo" reescrita (`profile` pt × `profileAi` en, aliases,
`missions`, `end_triggers`, rotas novas `POST/DELETE /v1/games`, `translate`, `PUT ?lang=`, seções novas do refine,
sementes, proxy/timeouts); linhas de "Onde mexer" e de páginas; evidência.
- `references/panel.md`: `/clipper/games` em lista + modal (`clipper-game-dialog.tsx`, `clipper-game-parts.tsx`);
ícones dos subitens da sidebar.
- `references/gotchas.md`: novo 167 (serviço sem reiniciar, `profileAi: null`, alias, missões não oficiais do GTA VI).
- `SKILL.md`: versão, `description` (perfil bilíngue, missões, cadastro de jogo) e faixa de itens do Clipador.
- Evidência: conferido em `clipper/app/main.py`, `db.py` (v12), `judge.py` (`mission_lines`), `intel.py`,
`panel/src/lib/clipper.ts` e `doc/clipador/JOGOS.md`; `pnpm test:clipper` → 335 passed (reexecutado). Não verificado:
IA real, UI no navegador, banco real em v12, `pnpm typecheck`.
## 1.49.0 — 18/11/2026
Clipador: interface em subpáginas, parar à mão pausa o monitor, idioma por fonte/sessão/canal.
- `references/clipper.md`: banco em v11; linha "Páginas `/clipper/*`" reescrita (grupo `(studio)`, provider, shell, páginas);
linha nova de pausa do monitor e idioma em "Onde mexer"; seção "Parar é parar e idioma"; evidência.
- `references/panel.md`: seção `/clipper` reescrita (tabela rota, conteúdo, arquivos; `clipper-studio.tsx` apagado,
`clipper-queue.tsx` e `clipper-sessions.tsx` reduzidos); esquema do painel v9 (`accounts.language`, `languages.ts`).
- `references/gotchas.md`: novo 166 (fonte que não volta a gravar depois de parar à mão; rotas novas exigem reiniciar o Clipador).
- `SKILL.md`: versão, `description`, linhas de página e de armadilhas.
- Evidência: conferido em `doc/clipador/REDESIGN.md`, `clipper-shell.tsx` (`CLIPPER_SECTIONS`), `clipper/app/db.py` (v11),
`main.py` (`StopIn`, `check_language`), `panel/src/lib/db.ts` (v9) e `languages.ts`; `pnpm test:clipper` → 287 passed
(reexecutado). Não verificado: páginas no navegador, banco real em v11, `pnpm typecheck` e testes do painel.
## 1.48.0 — 17/11/2026
Cartoon: acabamento de ilustração dos personagens (detalhe de rosto/corpo, acessórios, enquadramento e textura).
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 |
|---|---|
| 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/`) |
| 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` |
@@ -29,12 +29,13 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You
| Busca de quadro dentro de bloco `.ts` (`seek_args`, `grab_frame`) e emenda de resolução/codec (`uniform_segments`) | `clipper/app/media.py`; `clipper/app/editor_render.py`; `face.grab_bgr` e tamanho do quadro por bloco (`_frame_size`) em `face.py` | gotchas, itens 107–108 |
| Retomada de live (`Engine.live_check`, `keep_live`, `RESUME_DELAYS_S`, `resume_interrupted`), render que falha (`recover_orphan_renders`, `ORPHAN_RENDER_S` 300, `MAX_RENDER_ATTEMPTS` 3), cortes duplicados (`SAME_PEAK_S` 10, `SAME_MOMENT_OVERLAP` 0,6, `KEPT_STATUSES`/`VETO_STATUSES`, `discard_pending_duplicates`) | `clipper/app/worker.py` | `clipper/tests/test_resume.py`, `clipper/tests/test_render_and_duplicates.py` |
| Apagar cortes (`delete_clip`, `delete_many`, `select_ids`, `MAX_BATCH` 500, recusas `BUSY`/`PUBLISHED`/`CHANGED`, marca `marks`/`mark_spans`, arquivos só dentro das pastas do Clipador) | `clipper/app/clip_delete.py`; rotas em `main.py` (`ClipsDeleteIn`); marca lida em `worker.py` (veto depois do juiz) e na varredura (`intel.py`) | `clipper/tests/test_clip_delete.py`; `METHODS` em `panel/src/lib/clipper.ts`; seção "Apagar cortes" abaixo |
| Parar à mão e pausa do monitor (`Engine.stop_session(id, pause_monitor=True)`, `StopIn.pauseMonitor`), idioma por fonte/sessão (`check_language`, visões de fonte/sessão/corte com `language` resolvido; Whisper e `judge.output_language_note`) | `clipper/app/worker.py`, `main.py`, `db.py` (v11), `judge.py`; painel `ACCOUNT_LANGUAGES` em `panel/src/lib/languages.ts` | `clipper/tests/test_monitor_pause_and_language.py` (9); seção "Parar é parar e idioma" abaixo |
| Chat (IRC anônimo da Twitch com `CAP REQ :twitch.tv/tags` → emotes nativos e `room-id`; Pusher da Kick, emotes `[emote:id:NOME]`) | `clipper/app/chat.py` | — |
| Heurística: pesos, base de 3 min, mínimo proporcional (`_required_messages`), reações (`min_reactions`), chat fraco (`sparse_rate` 0,5 msg/s), momentos do chat/áudio/rosto (`_chat_moments`/`_audio_moments`/`_face_moments`; `face_*` em `Params`), `pick_peaks`, `fit_window` (duração de todo corte automático) | `Params` e funções em `clipper/app/scoring.py`; alvo `min_target` em `layout.py` | `clipper/tests/test_scoring.py` (regressões de falso positivo, chat fraco e rosto), `test_duration_banner_fonts.py` |
| Rastreio de reação — E/S: backends (MediaPipe; plano B OpenSeeFace), download sob demanda com sha256, recorte FFmpeg 6 qps, laço `face` | `clipper/app/face.py` (`for_scoring`, `must_wait`, `view`, `reset`); laço `_face_loop` e uso de `must_wait` na decisão do corte em `worker.py`; bancada `clipper/tools/face_bench.py` | `clipper/tests/test_face.py`, `clipper/models.lock.json`, `doc/FACE_BAKEOFF.md` |
| Rastreio de reação — lógica pura: sinal por segundo contra o neutro do streamer, rótulos, `reaction_moments`, `summarize` (linha do analista), `locate_cam` (câmera pelo rosto) | `ReactionParams` e funções em `clipper/app/reaction.py` | `clipper/tests/test_reaction.py` |
| Emotes: catálogo 7TV/BTTV/FFZ (canal + global, TTL 1 h, fonte que falha é ignorada), emojis, peso aprendido (`LEARN_UP`/`LEARN_DOWN` 0,3/0,15) | `clipper/app/emotes.py`; ingestão e aprendizado em `clipper/app/intel.py` (`ingest_chat`, `learn_from_clip`) | `clipper/tests/test_intel.py` |
| Contexto do jogo (categoria a cada `GAME_CHECK_S` 600, `screen_game`, perfil pela web; `clean_profile`, `save_profile`, `refine`, `delete_note`), varredura (`SCAN_*`), webcam (`detect_cam`: YuNet local primeiro, IA só se não achar ou `use_ai`; `CAM_RETRY_S` 300), opções `OPTION_DEFAULTS` (inclui `faceTrack`) | `clipper/app/intel.py` | README do Clipador |
| Contexto do jogo (categoria a cada `GAME_CHECK_S` 600, `screen_game`, perfil pela web; `clean_profile`, `save_profile`, `refine`, `delete_note`; perfis bilíngues, `add_game`, `delete_game`, `translate`, aliases, `import_seeds` de `clipper/app/seeds/games/*.json`; contrato em `doc/clipador/JOGOS.md`), varredura (`SCAN_*`), webcam (`detect_cam`: YuNet local primeiro, IA só se não achar ou `use_ai`; `CAM_RETRY_S` 300), opções `OPTION_DEFAULTS` (inclui `faceTrack`) | `clipper/app/intel.py` | README do Clipador |
| Juízes (analista + editor), prompts, glossário `CHAT_GLOSSARY`, linha "Rosto do streamer: …" do analista, schemas, chamada da CLI, pesquisa e refino do jogo (`PROFILE_SYSTEM`/`research_game`, `REFINE_SYSTEM`/`refine_game`), câmera | `clipper/app/judge.py`; montagem dos 6 frames do analista (8 se o trecho passa de 80 s) em `worker.py` | README do Clipador |
| Hashtags da legenda (`to_tag`, `fold`, `split_hashtags`, `compose`, `build_caption`; `MAX_TAGS` 8, `GAME_TAGS` 3, `MOMENT_TAGS` 4) | `clipper/app/hashtags.py`; uso em `judge_clip` de `worker.py`; campo `hashtags` em `judge.py` (`VERDICT_SCHEMA`, `PROFILE_SCHEMA`, `Verdict.hashtags`) e `PROFILE_LISTS`/`clean_profile`/`Intel.session_game` em `intel.py` — ver "Hashtags da legenda" abaixo | `clipper/tests/test_hashtags.py` |
| Configuração do corte: camadas padrão ← canal ← sessão ← projeto (`DEFAULTS`, `merge`, `validate`), `format.aspect` (`ASPECTS`, `FRAME_SIZES`, `CANVAS_SIZES`, `aspect()`), `MODES` (5 modos, inclui `cam_only`), `resolved_mode` (queda para `blur` sem câmera; `full` no horizontal), retângulos, legenda, crédito, `duration` (`min_target`), `hook` (`HOOK_STYLES`, `HOOK_ANIMS`, `HOOK_FONT`), `capture`; fontes empacotadas (`PACKAGED_FONTS`, `font_files`, `ass_filter` = `ass=` com `fontsdir` só se o ASS usar uma delas); cadeia de layout reutilizável `layout_chain(settings, src, dst, tail, suffix, mode)` (usada por `video_filter` e pelo editor) | `clipper/app/layout.py`; rotas de settings em `main.py` (devolvem `aspects`, `frames`, `fontFiles`, `hookStyles`, `hookAnims` e `captureQualities`) | `clipper/tests/test_format_and_captions.py` (o vertical precisa continuar batendo com `clipper/tests/data/vertical_golden_sha256.json`); modo novo também em `LayoutMode`/`MODE_LABEL` de `panel/src/components/clipper-client.ts` e `resolvedMode` de `clip-editor-model.ts`; grupo novo também em `CutSettings` (`Aspect`, `aspectOf`, `withFormat` para serviço antigo) |
@@ -45,7 +46,7 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You
| Legenda (tempo saneado: `clean_words`, `group_words`, `caption_blocks`; `build_ass`) e crédito — usada pelo render do editor e pelo worker, nos dois formatos | `clipper/app/subtitles.py` (`MIN_WORD_S` 0,06, `MIN_STEP_S` 0,04). `media.render_vertical` ainda existe em `media.py`, mas **não** é mais usado pelo render de cortes | `clipper/tests/test_format_and_captions.py`; [gotchas.md](gotchas.md) itens 57–58, 70, 90 |
| Rotas HTTP | `clipper/app/main.py` (editor: `editor_api.py`) | `ALLOWED` em `panel/src/lib/clipper.ts` (o proxy recusa caminho fora da regex) e o timeout por rota no mesmo arquivo |
| Variáveis do `.env` | `clipper/app/config.py` + `clipper/.env.example` | tabela do README do Clipador |
| Página `/clipper` | `panel/src/app/clipper/page.tsx`, `panel/src/components/clipper-*.tsx` (`clipper-cut-settings.tsx` modal do corte em 5 abas, com Gancho e "Qualidade da gravação"; `clipper-games.tsx` aba Jogos e emotes (editar perfil, pedir à IA, pedidos guardados); `clipper-queue.tsx` cartão com a análise, reação do rosto (`FaceSignal`, `FACE_LABEL`), recuo do início `START_STEPS`, botão "Editar"/"Continuar edição", "Apagar" e seleção discreta (`SelectionPill`); `clipper-judge.tsx` interruptor "Rastrear a reação do streamer"; `clipper-sessions.tsx` cartão da sessão (`sessionHealth`, selo de quem achou a câmera, relógio `RecordingClock`, cadência `SummaryCadence`) e cabeçalho em `clipper-studio.tsx`), cliente `clipper-client.ts` | [panel.md](panel.md) |
| Páginas `/clipper/*` (grupo de rotas `panel/src/app/clipper/(studio)/`, layout com `ClipperProvider` + `ClipperShell`) | `clipper-provider.tsx` (dados + consulta periódica, `useClipper()`), `clipper-shell.tsx` (`CLIPPER_SECTIONS`, cabeçalho, bloco "Ao vivo agora · N"), páginas `clipper-clips-page.tsx` (+ `clipper-clip-table.tsx` `ClipTable`, `clipper-clip-dialog.tsx` `ClipDialog`, `clipper-clip-parts.tsx`), `clipper-sessions-page.tsx`, `clipper-session-detail.tsx`, `clipper-channels.tsx` (Fontes), `clipper-games-page.tsx` + `clipper-game-dialog.tsx` + `clipper-game-parts.tsx` + `clipper-games.tsx` (emotes), `clipper-settings-page.tsx`; peças compartilhadas em `clipper-sessions.tsx` (`PlatformIcon`, `CutNow`, `RecordForm`, relógio, `sessionHealth`) e utilitários da lista em `clipper-queue.tsx`; `clipper-cut-settings.tsx` modal do corte em 5 abas; `clipper-judge.tsx`; cliente `clipper-client.ts`. Mapa de rotas e papéis em [panel.md](panel.md#página-clipper-clipador) | [panel.md](panel.md) |
| Página do editor `/clipper/edit/[clipId]` | `panel/src/app/clipper/edit/[clipId]/page.tsx` + `panel/src/components/clip-editor*.ts(x)` (papel de cada arquivo em [panel.md](panel.md#editor-de-cortes)); tokens `--color-nle-*` e bloco `.nle` em `panel/src/app/globals.css` | [panel.md](panel.md#editor-de-cortes) |
| Ponte e proxy do painel | `panel/src/lib/clipper.ts` + `panel/src/app/api/clipper/[...path]/route.ts` | — |
| Fontes (canais de live) nos canais de publicação | `linkChannel`/`endChannel`/`accountsForChannel` em `panel/src/lib/accounts.ts`; rotas `panel/src/app/api/accounts/[id]/channels/`; card "Fontes de corte" em `account-manager.tsx`. Na UI "Canais" virou **"Fontes"**; código e rotas seguem `channels` | [panel.md](panel.md) |
@@ -64,10 +65,17 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You
- **Aprendizado dos emotes:** aprovar/rejeitar no painel = ±0,3/0,15 nos emotes de −10 s a +6 s do pico, uma vez por
corte (`clips.learned`); a decisão da IA conta com `factor=0.5`. Peso limitado a −1…3.
## Juízes (decisão do usuário: pela CLI, sem chave de API)
## Juízes (decisão do usuário: pela CLI; chave de API só pelo cofre do painel)
- Provedores `codex` (padrão `gpt-6-luna`; lista de `~/.codex/models_cache.json`), `claude` (`haiku`/`sonnet`/`opus`)
ou `off` (só a heurística).
- Provedores `codex` (padrão `gpt-6-luna`; lista de `~/.codex/models_cache.json`), `claude` (`haiku`/`sonnet`/`opus`),
`gemini` (`Judge._gemini`: `gemini -p <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`,
`chat_meaning`, `confidence` (0–1) e início/fim da ação. **EDITOR** vê só texto + a análise e escreve título,
legenda, nota e corte. Os dois podem recuar até `duration.backtrackS` (padrão 120 s) antes do candidato.
@@ -77,7 +85,7 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You
- Custo fixo: cada chamada é um processo novo (2 por candidato). `codex_lean_overrides(search, config_file=None)` em
`judge.py` enxuga o Codex; o Claude leva `--setting-sources project,local`. Números e limites em
[token-economy.md](token-economy.md); teste: `test_codex_lean_overrides`. Vale após reiniciar o Clipador (gotcha 136).
- Não adicione chave de API ao juiz sem pedido do usuário. Corte manual é renderizado mesmo com nota baixa.
- Chave de API do juiz vem só do cofre do painel (`authMode: "apiKey"`, variável só na chamada); não crie outro caminho de chave sem pedido do usuário. Corte manual é renderizado mesmo com nota baixa.
## Hashtags da legenda (`hashtags.py`)
@@ -322,18 +330,59 @@ Teste local do editor sem tocar no serviço do usuário: instância na faixa 450
banco, com as regras do item 77 de [gotchas.md](gotchas.md). Teste de UI no painel do usuário sobre um corte real:
intercepte as escritas (item 86) e ache as camadas do canvas pelo cursor (item 85).
## Parar é parar e idioma (18/11/2026)
Texto completo no README do Clipador ("Parar é parar", "Idioma por fonte e por sessão").
- **Parar à mão pausa o monitor da fonte.** `POST /v1/sessions/{id}/stop` (corpo opcional `{"pauseMonitor": false}`;
padrão `true`) grava `channels.monitor_paused_at` + `monitor_paused_session`; o monitor pula a fonte pausada. Limpam a
pausa: `PATCH /v1/channels/{id}` com `{"monitor": true}`, `POST /v1/sessions` (gravar pelo link) e `resume` pelo painel.
Queda de live (captura cai sozinha) **não** passa pela pausa: continua `keep_live`, na mesma sessão. Na UI: a fonte
mostra "monitor pausado · você parou a sessão #N" com **Religar**; o diálogo de parar tem a opção de voltar a gravar
sozinho (marcada = não pausa).
- **Idioma.** `language` em `channels` e `sessions` (`pt-BR`, `en-US`, `es-419`; `''` = `CLIPPER_LANGUAGE`), aceito em
`POST/PATCH /v1/channels` e `POST /v1/sessions`; as visões de fonte, sessão e corte devolvem o idioma **já resolvido**.
O Whisper usa o idioma da sessão; fora de pt-BR os prompts do editor e da varredura recebem a nota de idioma de saída.
No painel, `accounts.language` (migração v9 do painel, padrão `pt-BR`) e o aviso no diálogo Publicar quando o idioma do
canal difere do idioma do corte. Versões traduzidas de um mesmo corte: **ainda não existem** (próxima etapa).
- Sem reiniciar o Clipador as rotas novas não valem; o painel trata `language`/pausa como opcionais e não quebra
(gotchas, item 166).
## Perfil do jogo (aba Jogos)
Toda rota abaixo devolve a lista inteira (mesma forma de `GET /v1/games`).
Fonte do contrato: `doc/clipador/JOGOS.md`; seção "Contexto do jogo" de `clipper/README.md`. Toda rota abaixo devolve a
lista inteira (mesma forma de `GET /v1/games`), exceto onde dito.
**Dois idiomas.** `profile` = português (o que o painel mostra); `profileAi` = inglês (vai nos prompts; `null` = não
traduzido, a IA usa `profile`); `aiLanguage` `en-US`; `translatedAt`; `aliases` (união dos dois perfis). Campos novos do
perfil: `aliases` (≤ 10), `missions` `[{name, chapter, summary, completion_triggers ≤ 8 de 200 caracteres}]` (até 120;
`[]` quando não há lista pública — a IA nunca inventa) e `end_triggers` (≤ 12, sinais gerais de fim de missão).
`game_context` (`judge.mission_lines`: `MISSIONS_IN_PROMPT` 25, `MISSIONS_PROMPT_CHARS` 1500) manda terminar o corte de
missão logo depois do gatilho de fim. Busca por nome casa `id` **ou** alias (categoria "Grand Theft Auto VI" e tela
"GTA 6" = mesmo jogo).
| Rota | Faz |
|---|---|
| `GET /v1/games` | perfis com `status`, `model`, `researchedAt`, `editedAt`, `notes` (`[{text, at, section?}]`) e `profile` |
| `POST /v1/games/{id}/research` | refaz o perfil do zero pela web (`RESEARCH_TIMEOUT_S` 420); os pedidos guardados entram no prompt |
| `PUT /v1/games/{id}` | grava o perfil editado à mão: `name`, `summary`, `genre`, `mechanics`, `clip_worthy`, `avoid`, `jargon`, `news`, `hashtags`, `sources` |
| `POST /v1/games/{id}/refine` | `{instruction, search, section, history}` → `{games, reply}`. `instruction` 3–1500 caracteres; `search` padrão `true` (`false` = sem web, `TIMEOUT_S` 240); `section` `""` \| `summary` \| `clip_worthy` \| `avoid` \| `mechanics` \| `news` \| `jargon` \| `hashtags` \| `sources` (`Literal` em `GameRefineIn` de `main.py`, inválido dá 422); `history` `[{role: "user"\|"ai", text ≤1500}]`, máx. 20. A IA devolve o perfil inteiro + `reply` (1–2 frases do que mudou); guarda o pedido (com `section`) e marca `edited_at` |
| `GET /v1/games` | perfis com `status`, `error`, `model`, `researchedAt`, `editedAt`, `translatedAt`, `notes` (`[{text, at, section?}]`), `aliases`, `profile`, `profileAi` |
| `POST /v1/games` `{name, notes?}` | cadastra (201, `{games, id}`, status `pending`) e pesquisa em segundo plano; 409 se o `id` ou um alias já existe |
| `DELETE /v1/games/{id}` | apaga o jogo (sessões não mudam; volta a ser pesquisado se o jogo reaparecer); 404 se não existe |
| `POST /v1/games/{id}/research` | refaz o perfil do zero pela web **em inglês** e traduz para português (`RESEARCH_TIMEOUT_S` 420); os pedidos guardados entram no prompt |
| `POST /v1/games/{id}/translate` | gera o inglês a partir do português (jogo de antes dos perfis bilíngues) |
| `PUT /v1/games/{id}?lang=pt\|en` | grava a edição à mão no idioma `lang` (padrão `pt`) e traduz para o outro; sem IA, grava e deixa o outro desatualizado. Campos: `name`, `summary`, `genre`, `mechanics`, `clip_worthy`, `avoid`, `jargon`, `news`, `hashtags`, `sources`, `aliases`, `missions`, `end_triggers` |
| `POST /v1/games/{id}/refine` | `{instruction, search, section, history}` → `{games, reply}`. Aplica no inglês e responde em português. `instruction` 3–1500 caracteres; `search` padrão `true` (`false` = sem web, `TIMEOUT_S` 240); `section` `""` \| `summary` \| `clip_worthy` \| `avoid` \| `mechanics` \| `news` \| `jargon` \| `hashtags` \| `sources` \| `missions` \| `end_triggers` \| `aliases` (`Literal` em `GameRefineIn` de `main.py`, inválido dá 422); `history` `[{role: "user"\|"ai", text ≤1500}]`, máx. 20. A IA devolve o perfil inteiro + `reply`; guarda o pedido (com `section`) e marca `edited_at` |
| `DELETE /v1/games/{id}/notes/{index}` | esquece um pedido guardado (o perfil atual fica como está) |
- Tradução que falha (ou IA desligada): a outra versão fica como estava (na pesquisa, as duas em inglês), `error`
explica e `translatedAt` não muda. Tradução nunca mexe em nome, hashtags, fontes e outros nomes, e é recusada se
perder missões.
- **Sementes:** `clipper/app/seeds/games/*.json` (`{name, aliases, researchedAt, sources, profileAi, profile}`) é
importado na subida **só se o jogo não existe**. Hoje: `gta-vi.json` (GTA VI lança 19/11/2026, sem lista oficial de
missões; a semente traz 4 do vídeo "An Extended Look" com nomes descritivos **não oficiais** — pesquisar de novo
depois do lançamento; gotchas, item 167).
- Proxy do painel (`panel/src/lib/clipper.ts`): `ALLOWED` aceita `games/<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.
São guardados os últimos 30 pedidos.
- **Pedido guardado sobrevive a "Pesquisar de novo"** (`research_game(name, title, notes)`; `PROFILE_SYSTEM` manda
@@ -344,13 +393,10 @@ Toda rota abaixo devolve a lista inteira (mesma forma de `GET /v1/games`).
`history`, 400 caracteres cada. `REFINE_SYSTEM` manda mexer só na seção em foco e transformar pedido genérico
em item concreto ("reação do streamer conta" → "Streamer grita, xinga ou ri alto logo depois de uma morte ou fuga").
`Intel.refine(...)` (`intel.py`) devolve `(profile, reply)`.
- Painel (`clipper-games.tsx`): o cabeçalho tem selo de iniciais e os botões "Conversar com a IA" (perfil inteiro),
"Editar" (uma linha por item) e "Pesquisar de novo". Cada seção é um cartão com "Pedir à IA", que abre o chat
daquela seção (`AiChat`: Enter envia, Shift+Enter quebra linha, chave "Confirmar na web" **desligada** por
padrão no painel, embora a API use `search=true` por padrão). Item recém-acrescentado aparece com selo "novo".
"Memória da IA" lista os pedidos guardados (com a seção) e tem X. A conversa só existe enquanto o chat está
aberto. O que fica salvo é o pedido. Tipo `Game` em `panel/src/components/clipper-client.ts`
(`editedAt?`, `notes?[].section?`). Detalhes visuais em [panel.md](panel.md).
- Painel: lista em `/clipper/games` e modal por `?game=ID` (`clipper-game-dialog.tsx`, `clipper-game-parts.tsx`); o chat
`AiChat` tem a chave "Confirmar na web" **desligada** por padrão, embora a API use `search=true`. A conversa só existe
enquanto o chat está aberto; o que fica salvo é o pedido (aba "Pedidos à IA", com X). Tipos `Game`, `GameProfile`,
`GameMission` em `panel/src/components/clipper-client.ts`. Detalhes visuais em [panel.md](panel.md).
## Regras
@@ -371,6 +417,17 @@ Toda rota abaixo devolve a lista inteira (mesma forma de `GET /v1/games`).
## Testes e evidência
Perfis de jogo bilíngues, missões, cadastro e semente do GTA VI (18/11/2026): `pnpm test:clipper` → **335 passed**
(reexecutado nesta manutenção, 108 s; bate com o informado); 10 testes em `clipper/tests/test_game_profiles.py`. Não
verificado: IA real na pesquisa, tradução e refino bilíngues; modal e lista no navegador; serviço real em v12 (precisa
reiniciar); `pnpm typecheck` e testes do painel.
IA reserva e Gemini no juiz (18/11/2026): `pnpm test:clipper` → **335 passed** (reexecutado pela skill; `test_ai_fallback.py` novo).
Reformulação da interface e regras de pausa/idioma (18/11/2026): `pnpm test:clipper` → **287 passed** (reexecutado
nesta manutenção; 9 testes novos em `clipper/tests/test_monitor_pause_and_language.py`). Não verificado: as páginas no
navegador e o banco real em v11 (o serviço precisa reiniciar).
Os testes não chamam a CLI de IA: `FakeJudge.ask` (`clipper/tests/test_sources_and_api.py`) sempre falha, e o serviço
segue pelo caminho de "IA fora". Juiz falso novo precisa cobrir `ask` também.
@@ -485,7 +542,7 @@ Não verificado:
contra o serviço reiniciado;
- apagar: rota no serviço real do usuário; arquivo em uso no Windows (deve voltar em `left`); pedido do editor em
andamento gravando em `edit-<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
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
+46 -2
View File
@@ -3,7 +3,7 @@
Cada item: **sintoma → causa → correção → onde está tratado**. Observadas na implementação da
prova de conceito com Godot 4.7.2 / FFmpeg 7.1.1 / pnpm 11.22 (16/11/2026). Registro formal em
`doc/TEST_RESULT.md`: itens 1–5, 7, 13–15, 17 e 18; itens 30–33 estão em `voice/README.md`
("GPU e CPU"); itens 57–61 estão em `clipper/README.md` ("Armadilhas já resolvidas"); itens 74–76, 87–90 e 103–108 também estão lá e o 78 na seção "Limitações" do editor; itens 79, 81–84 e 92–95 estão em `doc/FACE_BAKEOFF.md` (o 93 também em "Variáveis" de `clipper/README.md`) (o 80, no comentário de `clipper/requirements.txt`); itens 118–128 (publicação) seguem `doc/publicacao/` e o código; itens 151–154 foram informados em 17/11/2026 (parte conferida no código); itens 129–132 foram informados em 17/11/2026 e conferidos no código (`doc_main.gd`, `doc/godot/cenas.md`) e no banco (`agent_runs` 5, 7 e 8); itens 62–67, 77, 85–86, 91, 99–102, 109–112 e as ampliações do 52, do 44, 77, 86 e 87 foram informados em 16–17/11/2026 (não estão em `doc/TEST_RESULT.md`); os demais vieram de erros de compilação ou instalação durante a implementação.
("GPU e CPU"); itens 57–61 estão em `clipper/README.md` ("Armadilhas já resolvidas"); itens 74–76, 87–90 e 103–108 também estão lá e o 78 na seção "Limitações" do editor; itens 79, 81–84 e 92–95 estão em `doc/FACE_BAKEOFF.md` (o 93 também em "Variáveis" de `clipper/README.md`) (o 80, no comentário de `clipper/requirements.txt`); itens 168–172 (IA) seguem `doc/ia.md`; itens 118–128 (publicação) seguem `doc/publicacao/` e o código; itens 151–154 foram informados em 17/11/2026 (parte conferida no código); itens 129–132 foram informados em 17/11/2026 e conferidos no código (`doc_main.gd`, `doc/godot/cenas.md`) e no banco (`agent_runs` 5, 7 e 8); itens 62–67, 77, 85–86, 91, 99–102, 109–112 e as ampliações do 52, do 44, 77, 86 e 87 foram informados em 16–17/11/2026 (não estão em `doc/TEST_RESULT.md`); os demais vieram de erros de compilação ou instalação durante a implementação.
Ao descobrir uma nova, registre aqui via `cenaforge-skill-updater`. Os números são estáveis
(outros textos os citam): item novo entra na seção do assunto com o próximo número livre.
@@ -764,10 +764,54 @@ observada num envio real ainda. Contexto em [publishing.md](publishing.md).
165. **Cartoon: sombra do corpo/barriga em elipse parece mancha.** Correção: elipse + curva de volume (contorno) e sombra
lateral recortada por `clipPath`. Onde: `cartoon/src/CharacterFigure.tsx`.
166. **Clipador: depois de parar a sessão à mão, a fonte não grava de novo (ou as rotas/campos novos "não pegam").**
Dois lados. (a) Parar à mão pausa o monitor da fonte de propósito (`monitor_paused_at`): live no ar e nada
reabrindo não é falha. Religar = "Religar" em `/clipper/sources`, `PATCH /v1/channels/{id}` `{"monitor": true}`,
gravar pelo link ou retomar a sessão; `{"pauseMonitor": false}` no stop evita a pausa. Queda de live sem ninguém
parar continua retomando na mesma sessão. (b) Serviço sem `--reload` (item 144): sem reiniciar, `stop` não pausa,
`language` não é aceito nem devolvido e a migração v11 não roda; o painel trata os campos como opcionais, então
nada quebra, só não pega. Reinicie (é do usuário) e confira `PRAGMA user_version` = 11. Onde:
`clipper/app/worker.py`, `main.py` (`StopIn`), `db.py` (v11); teste `clipper/tests/test_monitor_pause_and_language.py`.
167. **Clipador: perfil do jogo sem versão em inglês, GTA VI ausente ou "cadastrar jogo" que não funciona.** (a) Serviço
sem reiniciar (item 144): a migração v12 não roda, `POST /v1/games`, `translate`, `DELETE` e `?lang=` não existem e a
semente do GTA VI não é importada (só entra na subida, e só se o jogo não existe: nunca sobrescreve edição).
Reinicie (é do usuário) e confira `PRAGMA user_version` = 12. (b) Jogo antigo tem `profileAi: null`: a IA usa o
português até rodar `POST /v1/games/{id}/translate` ("Gerar versão em inglês" no modal). (c) Categoria ou tela com
outro nome ("Grand Theft Auto VI" × "GTA 6") só cai no mesmo perfil se o nome estiver em `aliases`; cadastro com nome
já existente (inclusive alias) dá 409. (d) Missões só entram quando a lista é pública; **a semente do GTA VI traz 4
missões do vídeo "An Extended Look" com nomes descritivos, não oficiais** (jogo lança 19/11/2026, sem lista oficial):
pesquisar de novo depois do lançamento, sem apagar o jogo. Edição à mão em um idioma é traduzida para o outro; tradução
que falha deixa a outra versão como estava e `error` explica. Onde: `clipper/app/intel.py` (`import_seeds`,
`add_game`, `translate`), `main.py`, `db.py` (v12), `seeds/games/`; teste `clipper/tests/test_game_profiles.py`.
## IA: provedores, login e reserva
Itens 168–172 informados em 18/11/2026 e conferidos contra `doc/ia.md` e o código. Contexto em [ai.md](ai.md).
168. **Gemini CLI com login Google: `IneligibleTierError: UNSUPPORTED_CLIENT`** (gemini-cli 0.68.0). Causa: o OAuth gratuito
"Code Assist for individuals" foi encerrado; o Google manda migrar para o Antigravity. OAuth só com plano elegível
(Code Assist Standard/Enterprise, Workspace). Correção: conta pessoal usa **chave do AI Studio** (`authMode: "apiKey"`).
O erro conta como indisponibilidade (`IneligibleTier`) e aciona a reserva. Onde: `panel/src/lib/ai.ts`, `doc/ia.md`.
169. **`CODEX_API_KEY` só vale no `codex exec`** (confirmado no binário 0.169.0). Para chave sem mexer na conta do usuário,
ponha a variável só na chamada (`providerEnv`); **não** use `codex login --with-api-key`, que troca o login global.
Mesma regra para `ANTHROPIC_API_KEY` e `GEMINI_API_KEY`. Onde: `providerEnv` em `panel/src/lib/ai.ts`.
170. **Terminal de login no Windows: aspas do `cmd` e caminho com espaço ("Program Files").** Forma que funcionou:
`cmd /d /c start "<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:
- Patch por script em arquivos CRLF do painel (`lib/metrics.ts`, `components/metrics-view.tsx`, `dashboard-controls.tsx`,
`app/dashboard/page.tsx`): item 63 — uma substituição com "\n" não acha o trecho; normalize e grave de volta em CRLF.
- `codex.cmd` sem shell: item 28.
- Script de patch com regex (`\b`) passado por heredoc: item 44.
- Publicador roda sem `--reload`: mudança em `publisher/app/` só vale depois de reiniciar o `pnpm dev` (itens 137, 139, 140, 142, 143, 145 e 147; o Clipador também: 144).
- Migração do painel (v3 … v8) é aplicada na 1ª requisição depois da recarga do `db.ts`; reiniciar o `pnpm panel`/`pnpm dev` só se isso não bastar: itens 51 e 138 (reiniciar mata agente em execução: item 131).
- Migração do painel (v3 … v10) é aplicada na 1ª requisição depois da recarga do `db.ts`; reiniciar o `pnpm panel`/`pnpm dev` só se isso não bastar: itens 51 e 138 (reiniciar mata agente em execução: item 131).
+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.
- `Button` (`components/ui.tsx`) tipa as props como `ComponentProps<"button">` e aceita `ref` (React 19).
## Banco (`data/cenaforge.db`, esquema v7)
## Banco (`data/cenaforge.db`, esquema v10)
- Migração em `panel/src/lib/db.ts` (lista `MIGRATIONS`). Banco com dados → cópia em `data/backups/`
antes de migrar (`cenaforge-v<atual>-<data>.db`). `foreign_keys = OFF` fora da transação e `PRAGMA
foreign_key_check` antes do `COMMIT` de cada versão.
- v3: `account_channels` (conta ↔ canal de live do Clipador; `status` `active`/`ended`). O canal
vive em `data/clipper/clipper.db`, então não há chave estrangeira para ele.
- v9: `accounts.language` (idioma e público do canal de publicação; padrão `pt-BR`; opções em `ACCOUNT_LANGUAGES` de
`panel/src/lib/languages.ts`). A v8 (última leitura dos números das redes) não está descrita aqui: ver publishing.md.
- v4: reconstrói `stories` (SQLite não altera CHECK) para `kind` aceitar `'documentary'`; mesmas
colunas e ids.
- v5: publicação real — `publish_jobs`, `app_settings`, `clip_auto_approvals`; `account_networks` e `publications`
@@ -35,6 +37,7 @@ Fonte: código em `panel/src/lib/` e `panel/README.md`. O painel é do usuário:
- v6: reconstrói `publish_jobs` (ids preservados) com `schedule_source` (`auto`/`manual`/`now`) e `cancel_reason`
`unlinked`. Banco real em v6 (`PRAGMA user_version`, conferido em 17/11/2026, antes da v7).
- v7: `publish_jobs.origin` (`link`/`manual`, padrão `link`): job criado pelo botão "Publicar" do corte. Ver publishing.md.
- v10: `agent_runs.fallback_of` (execução que continuou outra que caiu por indisponibilidade; IA reserva — [ai.md](ai.md)).
- API: toda rota `/api/**` passa por `panel/src/proxy.ts` (Host local; escrita exige `Origin` do painel) e corpo por
`readJson` (415 sem `Content-Type: application/json`) — gotchas, item 125.
- A conexão fica em `globalThis.__cenaforgeDb`; a marca de módulo `checkedThisModule` faz a 1ª chamada de `db()` depois
@@ -248,7 +251,13 @@ Cada trecho vira um MP4 de desenho 2D montado por peças a partir do texto; pers
informando o formato (o subagente é uma casca que lê `doc/roteiro/`; sem WebSearch, fato sem fonte fica
"a confirmar"); no **Codex** manda ler os guias e escrever sozinho, sem usar `.claude/agents/` (mesma
regra no `AGENTS.md`).
- Lista de modelos = `models()` (não há mais constante fixa):
- **Três provedores** (`claude`, `codex`, `gemini`), configurados em **Configurações → IA** (`/settings/ai`: ligar/desligar,
conta ou chave de API, ordem da reserva, instalar, entrar, testar). **IA reserva:** agente que termina com erro de
indisponibilidade é pausado e a mesma tarefa recomeça na próxima IA pronta (`agent_runs.fallback_of`; o console segue
o `followUpRunId` também nesse caso; vertentes religadas à nova execução). Contrato, API e armadilhas em
[ai.md](ai.md). Configurações são subpáginas `/settings/{ai,publishing,apps,browser,modes}` (`/settings` → IA;
`SETTINGS_SECTIONS` em `settings-shell.tsx`, também no menu lateral); link antigo `/settings?tab=apps` não existe mais.
- Lista de modelos = `models()` (não há mais constante fixa; o Gemini usa `geminiModels()` de `lib/ai.ts`):
- Codex: lê `models_cache.json` de `$CODEX_HOME` (padrão `~/.codex`), que a CLI do Codex atualiza
sozinha; filtra `visibility === "list"`, ordena por `priority`. Primeira opção "Padrão da CLI (…)"
= `model = "..."` do `config.toml`. O id vai em `codex exec -m <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?,
model?}` (`app/api/stories/route.ts`; `kind` padrão `documentary`, texto 20–20.000 caracteres) cria a história + ep01
e dispara o agente `story` → `{storyId, episodeId, runId}` (cabeçalho `Origin`: gotchas, item 125).
- O agente roda dentro do processo do painel: reiniciar o `pnpm panel` o mata (gotchas, item 131). Limite de uso do
Claude/Codex para a tarefa no meio: continue no outro provedor com o contexto (item 132).
- O agente roda dentro do processo do painel: reiniciar o `pnpm panel` o mata (gotchas, item 131). Limite de uso no
meio da tarefa: com a reserva ligada o painel recomeça sozinho na próxima IA (item 132 vale só com a reserva
desligada ou sem outra IA pronta: continue à mão no outro provedor com o contexto).
- Prompt do Codex manda ler texto no PowerShell com `Get-Content -Raw -Encoding UTF8` (gotchas, item 98).
### Mensagem com o agente rodando
@@ -336,6 +346,29 @@ Limitação: o overlay da Godot só tem `choiceA`/`choiceB` (`scene_config.gd`);
## Página `/clipper` (Clipador)
Reformulada em 18/11/2026 (`doc/clipador/REDESIGN.md`): deixou de ser uma página com 5 abas e virou **subpáginas** no
grupo de rotas `panel/src/app/clipper/(studio)/`. O `layout.tsx` monta `ClipperProvider` (`clipper-provider.tsx`: dados +
consulta periódica; `useClipper()`) e `ClipperShell` (`clipper-shell.tsx`: cabeçalho compacto com estado do serviço,
bloco "Ao vivo agora · N" com uma linha por live, sub-navegação com contadores). Sub-navegação = `CLIPPER_SECTIONS`; a
sidebar (`sidebar-nav.tsx`) mostra os mesmos subitens quando o Clipador está ativo. Seção nova = entrada em
`CLIPPER_SECTIONS` + pasta em `(studio)/`.
| Rota | Conteúdo | Arquivos |
|---|---|---|
| `/clipper` Cortes | lista `ClipTable` (uma linha por corte; ações rápidas Aprovar/Rejeitar/Publicar), filtros na URL (`?stage ?source ?session ?lang`), modal `ClipDialog` por `?clip=ID` com anterior/próximo | `clipper-clips-page.tsx`, `clipper-clip-table.tsx`, `clipper-clip-dialog.tsx`, `clipper-clip-parts.tsx`; ordenar/apagar/selecionar em utilitários de `clipper-queue.tsx` |
| `/clipper/sessions` | lista de sessões; "Gravar pelo link" em diálogo (`RecordForm`) | `clipper-sessions-page.tsx` |
| `/clipper/sessions/[id]` | saúde, resumo da IA, tiles, gráfico do chat, emotes, configuração do corte | `clipper-session-detail.tsx` |
| `/clipper/sources` | fontes em tabela, "Adicionar fonte" em diálogo, monitor ligado/**pausado** + Religar, idioma da live, canais de publicação | `clipper-channels.tsx` |
| `/clipper/games` | jogos em tabela (nome, gênero, estado, missões, última pesquisa/edição), "Adicionar jogo" em diálogo, `?game=ID` abre o modal do jogo e emotes do canal | `clipper-games-page.tsx`, `clipper-game-dialog.tsx` (modal), `clipper-game-parts.tsx` (seções, `AiChat`, editor à mão), `clipper-games.tsx` |
| `/clipper/settings` | abas Juiz (IA) / Serviço / Idiomas e públicos | `clipper-settings-page.tsx`, `clipper-judge.tsx` |
| `/clipper/edit/[clipId]` | editor em tela cheia, **fora** do grupo `(studio)` | ver "Editor de cortes" |
`clipper-studio.tsx` foi **apagado**; `clipper-queue.tsx` virou só utilitários da lista (a lista é `ClipTable`);
`clipper-sessions.tsx` virou peças compartilhadas (`PlatformIcon`, `CutNow`, `RecordForm`, relógio, `sessionHealth`).
Canal de publicação: campo "Idioma e público" em `account-manager.tsx`; aviso de idioma em `clip-publish.tsx`.
Os parágrafos abaixo descrevem o comportamento de cada peça; onde falam em "aba", "cartão" ou "fila", leia "página",
"linha" e "lista de cortes" (a reescrita deles não foi verificada no navegador).
- `clipper-cut-settings.tsx`: modal "Configuração do corte" em cinco abas — Formato e duração (com a seção
"Qualidade da gravação" e o disco por hora de cada opção, de `captureQualities`) · Câmera e layout · Legenda (com
seletor de fonte) · Gancho (estilo, cores, fonte, animação de entrada, "Ver a entrada") · Crédito — com a prévia ao
@@ -345,7 +378,7 @@ Limitação: o overlay da Godot só tem `choiceA`/`choiceB` (`scene_config.gd`);
- `clipper-client.ts`: tipo `Aspect`, `format` em `CutSettings`, `aspect?` em `Clip`, `aspectOf()` (ausente =
vertical) e `withFormat()` (completa a resposta de um serviço antigo sem `format`). Na fila (`clipper-queue.tsx`)
o corte horizontal aparece em 16:9.
- Aba Sessões (`clipper-sessions.tsx`; cabeçalho em `clipper-studio.tsx`): cartão com cabeçalho (tempo gravado,
- Sessão (`clipper-sessions.tsx`, `clipper-session-detail.tsx`): cartão com cabeçalho (tempo gravado,
"gravando em L×A · fps" de `capture` e ações), frase de saúde (`sessionHealth()`), painel "o que está acontecendo" (resumo da IA + jogo), quatro blocos
(Chat, Transcrição, IA assistiu, Cortes) e barra de ferramentas. **Altura fixa por desenho**: nada pode pular na
atualização automática. "Retomar gravação" aparece em toda live que não está gravando (botão principal só em
@@ -358,12 +391,12 @@ Limitação: o overlay da Godot só tem `choiceA`/`choiceB` (`scene_config.gd`);
atrasou, "gerando o próximo resumo…". O intervalo vem de `/status` → `judge.options.scanIntervalS`
(`useScanInterval`; reserva 180 = `OPTION_DEFAULTS` de `intel.py`). Existe porque o dono achou que o resumo
travava (gotchas, item 115).
- `clipper-games.tsx`: aba Jogos e emotes. O card do jogo tem selo de iniciais (primeira + última palavra, cor
por `hueOf`) e os botões "Conversar com a IA", "Editar" e "Pesquisar de novo". Cada seção é um cartão com
barra colorida, contador e "Pedir à IA", que abre o chat inline `AiChat` (balões, atalhos de pedido por seção,
indicador de digitação, "+N itens novos / −N removidos"). Item novo fica verde com selo "novo". Gírias viram
chips, e Fontes e "Memória da IA" ficam recolhidas. A aba também mostra os emotes do canal com usos e peso.
Rotas e regras em [clipper.md](clipper.md#perfil-do-jogo-aba-jogos).
- Jogos (`clipper-games-page.tsx` + `clipper-game-dialog.tsx` + `clipper-game-parts.tsx`; `clipper-games.tsx` guarda
os emotes do canal): lista em tabela; o modal tem alternância **Português (você lê) / English (vai para a IA)** e abas
Visão geral · Rende corte · Missões · Gatilhos de fim · Termos e hashtags · Fontes · Pedidos à IA, com Pesquisar de
novo, Editar, Pedir à IA (`AiChat`: atalhos por seção, "+N itens novos / −N removidos") e Apagar. Editar grava no
idioma da alternância e o serviço traduz o outro. Rotas e regras em [clipper.md](clipper.md#perfil-do-jogo-aba-jogos).
- Sidebar: os subitens do Clipador usam os mesmos ícones das abas do topo (`sidebar-nav.tsx`, `SubItem.icon`).
- `clipper-queue.tsx`: cartão do corte mostra a análise do juiz e recua/avança o início (`START_STEPS`
−30/−10/−5/−2/+2 s). `clipper-judge.tsx`: modelos do editor e do analista, varredura, visão, câmera.
- **Ordenar a fila** (`clipper-queue.tsx`, seletor "Ordenar" ao lado do filtro de sessão; `QUEUE_SORTS`, `useQueueSort`):
@@ -523,4 +556,4 @@ Apagar na fila, relógio da sessão e prévia igual ao render (17/11/2026): `npx
(reconferido pela skill). Informado pelo coordenador: porte da legenda em 22 conferências contra o Python; corte 61
montado no editor e renderizado pelo serviço com enquadramento, inserção e legenda iguais à prévia em
2/3,5/5/6,5/8 s. Não verificado: apagar pela UI contra o serviço real; relógio com movimento reduzido, aba escondida
e larguras de 1024/1280; a faixa do topo de `clipper-studio.tsx` ainda usa o `durationS` real.
e larguras de 1024/1280; a faixa do topo (hoje `clipper-shell.tsx`) pode ainda usar o `durationS` real.
+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 |
| @xyflow/react | 13.0.1 | árvore de vertentes na aba Fluxo (`panel/src/components/story-flow.tsx`) | dependência do painel | 16/11/2026 |
| SQLite | `node:sqlite` (Node 24) | banco do painel, sem dependência nativa | embutido | 16/11/2026 |
| Codex CLI | 0.169.0 (`@openai/codex`) | agente no painel (`codex exec --json -m <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) |
| Claude Code CLI | 2.1.314 | agente chamado pelo painel (`-p`, `stream-json`, `--resume`, `--model claude-*-5-5`/`claude-fable-5-2`) | `CLAUDE_BIN` → `PATH` (`claude.exe`) | 17/11/2026 |
| Claude Code CLI | 2.1.314 | agente chamado pelo painel (`-p`, `stream-json`, `--resume`, `--model claude-*-5-5`/`claude-fable-5-2`) | `CLAUDE_BIN` → `PATH` (`claude.exe`) → `~/.local/bin` | 17/11/2026 (`--version` reconferido em 18/11/2026) |
Estilo Cartoon (`cartoon/`, 17/11/2026; contrato e uso em [cartoon.md](cartoon.md)):
@@ -168,6 +168,7 @@ segurança).
| Ferramenta | Para quê | Situação |
|---|---|---|
| Gemini CLI (`@google/gemini-cli`) | terceiro provedor de IA (agentes do painel e juiz do Clipador; [ai.md](ai.md)) | **código pronto, nunca executado de verdade**: não instalado nesta máquina (18/11/2026, `gemini: command not found`); a versão 0.68.0 do contrato (`doc/ia.md`) vem de teste do dono e não foi reverificada aqui. Coberto só por testes sem CLI (`ai.test.ts`, `test_ai_fallback.py`). OAuth gratuito de conta pessoal encerrado (gotchas, item 168); uso real exige chave do AI Studio, ainda não testada. Passa a "Em uso" depois de uma tarefa real concluída por ele |
| Meshy | gerar modelos GLB (personagens, objetos) e rig | citada na especificação; não testada |
| Mixamo | animações para personagens com rig | citada como não obrigatória; não testada |
| `.glb` carregado por `GLTFDocument` em tempo de execução (Godot) | modelos prontos dentro de cenas da biblioteca (`library/<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."
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">
+2 -2
View File
@@ -7,7 +7,7 @@ import { addManualComments, closeDecision, decisionVotes } from "@/lib/decisions
import { defaultModelFor, defaultProviderFor, startRun } from "@/lib/agents";
import { slugify } from "@/lib/paths";
import { UserError, createEpisode, createStory, deleteStory, getEpisodeById, getStory, provisionalTitle } from "@/lib/stories";
import { CHOICES, type Choice, type Provider, type StoryKind } from "@/lib/types";
import { CHOICES, PROVIDERS, type Choice, type Provider, type StoryKind } from "@/lib/types";
export type FormState = { error?: string; message?: string } | null;
@@ -55,7 +55,7 @@ export async function createStoryFromTextAction(_prev: FormState, form: FormData
// Documental é um vídeo só: sem título de episódio ("Abertura" só faz sentido numa série).
const ep = createEpisode(story.id, { title: kind === "documentary" ? "" : "Abertura" });
const chosen = String(form.get("provider") ?? "");
const provider: Provider = chosen === "claude" || chosen === "codex" ? chosen : defaultProviderFor("story");
const provider: Provider = (PROVIDERS as string[]).includes(chosen) ? (chosen as Provider) : defaultProviderFor("story");
// Modelo escolhido no formulário; vazio = padrão da tarefa (no Codex, o do config.toml). startRun valida.
const model = String(form.get("model") ?? "") || defaultModelFor("story", provider);
const run = startRun({
+2 -2
View File
@@ -24,13 +24,13 @@ export default async function AgentPage({ searchParams }: { searchParams: Promis
const defaults: AgentDefaults = {
provider: map(defaultProviderFor),
preferred: PREFERRED_PROVIDER,
model: map((k) => ({ claude: defaultModelFor(k, "claude"), codex: defaultModelFor(k, "codex") })),
model: map((k) => ({ claude: defaultModelFor(k, "claude"), codex: defaultModelFor(k, "codex"), gemini: defaultModelFor(k, "gemini") })),
};
return (
<>
<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]">
<AgentConsole
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 { slugify } from "@/lib/paths";
import { UserError, createEpisode, createStory, getStory, provisionalTitle } from "@/lib/stories";
import { STORY_KINDS, type Provider, type StoryKind } from "@/lib/types";
import { PROVIDERS, STORY_KINDS, type Provider, type StoryKind } from "@/lib/types";
export async function POST(request: Request) {
try {
@@ -20,7 +20,7 @@ export async function POST(request: Request) {
for (let n = 2; getStory(id); n++) id = `${base}-${n}`;
const story = createStory({ title, id, logline: "", kind, branchCount: 2 });
const ep = createEpisode(story.id, { title: kind === "documentary" ? "" : "Abertura" });
const provider: Provider = body.provider === "claude" || body.provider === "codex" ? body.provider : defaultProviderFor("story");
const provider: Provider = PROVIDERS.includes(body.provider as Provider) ? (body.provider as Provider) : defaultProviderFor("story");
const model = String(body.model ?? "") || defaultModelFor("story", provider);
const run = startRun({ provider, model, kind: "story", request: text, storyId: story.id, episodeId: ep.id });
return Response.json({ storyId: story.id, episodeId: ep.id, runId: run.id });
+2 -2
View File
@@ -10,7 +10,7 @@ import {
} from "@/components/ui";
import { defaultProviderFor, models, providers } from "@/lib/agents";
import { listEpisodes, listStories } from "@/lib/stories";
import type { EpisodeView, Story } from "@/lib/types";
import type { EpisodeView, Provider, Story } from "@/lib/types";
export default async function HomePage() {
await connection();
@@ -18,7 +18,7 @@ export default async function HomePage() {
const totalEpisodes = stories.reduce((sum, s) => sum + s.episodes.length, 0);
const rendered = stories.reduce((sum, s) => sum + s.episodes.filter((e) => e.stage === "renderizado" || e.stage === "decidido").length, 0);
const openVotes = stories.reduce((sum, s) => sum + (s.story.kind === "interactive" ? s.episodes.filter((e) => e.stage === "renderizado").length : 0), 0);
const available = Object.fromEntries(providers().map((p) => [p.id, p.available])) as Record<"claude" | "codex", boolean>;
const available = Object.fromEntries(providers().map((p) => [p.id, p.available])) as Record<Provider, boolean>;
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."
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>
</>} />
<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 { PageHeader } from "@/components/ui";
import { redirect } from "next/navigation";
export const metadata = { title: "Configurações" };
/** Configurações do painel: publicação, apps das redes, navegador da sessão logada e a explicação dos modos. */
/** /settings abre a primeira seção (IA); cada seção tem a própria página. */
export default function SettingsPage() {
return (
<>
<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 />
</>
);
redirect("/settings/ai");
}
@@ -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" },
]} />
<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>
</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 },
];
export const PROVIDER_LABEL: Record<Provider, string> = { claude: "Claude Code", codex: "GPT · Codex" };
const PROVIDER_SHORT: Record<Provider, string> = { claude: "Claude", codex: "GPT" };
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", gemini: "Gemini" };
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.",
@@ -210,7 +210,7 @@ export function AgentConsole(props: {
{/* 2. Agente */}
<fieldset className="grid gap-3">
<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) => (
<ProviderCard key={p.id} info={p} selected={provider === p.id} recommended={preferred === 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="text-sm font-semibold text-fg">{PROVIDER_LABEL[info.id]}</span>
{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 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>}
+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">
{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>
</section>
)}
@@ -417,7 +417,7 @@ function ModeCard({ platform, mode, checked, appMissing, onSelect }: {
{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">
<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>
)}
</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>
<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."}{" "}
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.
</p>
</div>
+1 -1
View File
@@ -251,7 +251,7 @@ export function PublishingBoard() {
action={<Button size="sm" onClick={() => void resume()} disabled={resumeBusy}>
{resumeBusy ? <Spinner className="size-3.5" /> : <PublishIcon size={15} />}Retomar
</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>
)}
</div>
+12 -31
View File
@@ -1,11 +1,12 @@
"use client";
// Configurações do painel (por enquanto, tudo da publicação nas redes), em abas:
// Publicação — pausar tudo, horários bons por rede, fuso e de quanto em quanto tempo ler os números dos posts
// (GET/PUT /api/settings);
// Apps das redes — passo a passo para criar o app de cada rede e os campos Client ID/Secret
// (GET/PUT/DELETE /api/settings/apps/[platform]); o segredo nunca volta para a tela;
// Navegador — navegador encontrado pelo Publicador (modo sessão) e onde ficam as sessões;
// Sobre os modos — comparação simples entre "Conta oficial (API)" e "Sessão logada".
// Seções de Configurações da publicação nas redes, cada uma numa subpágina (/settings/<seção>, ver settings-shell.tsx):
// PublishingTab — pausar tudo, horários bons por rede, fuso e de quanto em quanto tempo ler os números dos posts
// (GET/PUT /api/settings);
// AppsTab — passo a passo para criar o app de cada rede e os campos Client ID/Secret
// (GET/PUT/DELETE /api/settings/apps/[platform]); o segredo nunca volta para a tela;
// BrowserTab — navegador encontrado pelo Publicador (modo sessão) e onde ficam as sessões;
// ModesTab — comparação simples entre "Conta oficial (API)" e "Sessão logada".
// A seção de IA fica em ai-settings.tsx.
import { useCallback, useEffect, useState, type FormEvent, type ReactNode } from "react";
import type { Platform } from "@/lib/types";
import { askConfirm } from "./confirm-dialog";
@@ -17,10 +18,8 @@ import {
type AppState, type PublisherStatus, type AppSettings,
} from "./publishing-client";
import { NoticeBar, PlatformName, TextLink } from "./publishing-ui";
import { Tabs } from "./tabs";
import { Badge, Button, Card, Feedback, Field, Input, Select, Spinner, Switch, Table, Td, Th, THead, Tr, cx } from "./ui";
type TabId = "publicacao" | "apps" | "navegador" | "modos";
type Message = { ok: boolean; text: string } | null;
/** Ordem de exibição das redes nestas telas (a mais usada primeiro). */
@@ -35,27 +34,9 @@ const TIMEZONES: { value: string; label: string }[] = [
{ value: "UTC", label: "UTC" },
];
export function SettingsPanel() {
return (
<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 ---------- */
function PublishingTab() {
export function PublishingTab() {
const [settings, setSettings] = useState<AppSettings | null>(null);
const [draft, setDraft] = useState<AppSettings | 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 (
<div className="grid gap-6">
<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 ---------- */
function BrowserTab() {
export function BrowserTab() {
const [status, setStatus] = useState<PublisherStatus | null>(null);
const [busy, setBusy] = useState(false);
const load = useCallback(async () => {
@@ -474,7 +455,7 @@ const MODES_TABLE: Record<Platform, { official: string[]; session: string[] }> =
},
};
function ModesTab() {
export function ModesTab() {
return (
<div className="grid gap-6">
<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 { LogoMark, Wordmark } from "./logo";
import { getSummary } from "./publishing-client";
import { SETTINGS_SECTIONS, activeSettingsSection } from "./settings-shell";
import { cx } from "./ui";
type SubItem = { href: string; label: string; icon?: ComponentType<{ size?: number }> };
@@ -39,7 +40,7 @@ const NAV: NavItem[] = [
{ href: "/characters", label: "Personagens", hint: "Elenco reaproveitável", icon: UsersIcon },
{ href: "/assets", label: "Assets", hint: "Biblioteca e envios", icon: CubeIcon },
{ href: "/voices", label: "Vozes", hint: "Narração e legenda", icon: MicIcon },
{ href: "/agent", label: "Agente", hint: "Claude e Codex", icon: TerminalIcon },
{ href: "/agent", label: "Agente", hint: "Claude, GPT e Gemini", icon: TerminalIcon },
];
/** Depois do estúdio: onde as histórias vão ao ar. */
@@ -48,7 +49,11 @@ const DISTRIBUTION: NavItem[] = [
{ href: "/publishing", label: "Publicações", hint: "Aprovar, agendar, acompanhar", icon: PublishIcon },
];
const SETTINGS: NavItem = { href: "/settings", label: "Configurações", hint: "Horários, apps e navegador", icon: SettingsIcon };
const SETTINGS: NavItem = {
href: "/settings", label: "Configurações", hint: "IA, publicação e navegador", icon: SettingsIcon,
children: SETTINGS_SECTIONS.map((s) => ({ href: s.href, label: s.label, icon: s.icon })),
activeChild: (pathname) => activeSettingsSection(pathname)?.href ?? null,
};
function useAwaitingCount(pathname: string): number | null {
const [count, setCount] = useState<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 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 }: {
/** Agente que o modo automático vai usar agora (Codex, se estiver instalado). */
@@ -24,11 +24,12 @@ export function StoryComposer({ autoProvider, available, models }: {
}) {
const [state, action, pending] = useActionState(createStoryFromTextAction, null);
const [length, setLength] = useState(0);
const [provider, setProvider] = useState<"" | "claude">("");
const [provider, setProvider] = useState<"" | Provider>("");
const [kind, setKind] = useState<StoryKind>(DEFAULT_STORY_FORMAT);
const [model, setModel] = useState("");
const short = length > 0 && length < MIN_CHARS;
const engine: Provider = provider === "claude" ? "claude" : autoProvider;
const engine: Provider = provider || autoProvider;
const noneReady = !Object.values(available).some(Boolean);
const documentary = kind === "documentary";
return (
@@ -85,8 +86,9 @@ export function StoryComposer({ autoProvider, available, models }: {
<ChoiceGroup name="provider" legend="Quem escreve" value={provider}
onChange={(next) => { setProvider(next); setModel(""); }}
options={[
{ value: "", label: autoProvider === "codex" ? "GPT · Codex" : "Automático" },
{ value: "claude", label: "Claude", disabled: !available.claude },
{ value: "", label: `Automático (${PROVIDER_NAME[autoProvider]})` },
...(["claude", "codex", "gemini"] as const).filter((p) => p !== autoProvider)
.map((p) => ({ value: p, label: PROVIDER_NAME[p], disabled: !available[p] })),
]} />
<label className="grid content-start gap-2">
<span className="text-[0.8125rem] font-medium text-fg-muted">Modelo</span>
@@ -96,8 +98,10 @@ export function StoryComposer({ autoProvider, available, models }: {
</label>
</div>
{!available.codex && (
<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>
{noneReady ? (
<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">
+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"):
// - roda com cwd = raiz do repositório; edições automáticas só dentro dele;
@@ -6,13 +7,16 @@
// - o pedido vai como argumento (sem shell); stdin fechado;
// - um agente por vez; cancelar encerra a árvore de processos.
// Comentários do público NUNCA entram no prompt: só a decisão A/B já fechada.
import { spawn, spawnSync, type ChildProcess } from "node:child_process";
import { spawn, type ChildProcess } from "node:child_process";
import fs from "node:fs";
import path from "node:path";
import { all, get, now, run } from "./db";
import { DATA_DIR, REPO_ROOT, rel } from "./paths";
import { buildPrompt } from "./prompts";
import { findOnPath, killTree, lineSplitter } from "./proc";
import {
PROVIDER_META, geminiModels, isAvailabilityError, markUnavailable, nextFallback, providerEnv, providerStatus, readyChain, resolvedFor,
} from "./ai";
import { killTree, lineSplitter } from "./proc";
import { onAgentRunClosed } from "./branches";
import { UserError, getEpisodeById, getStory, syncStoryMeta } from "./stories";
import { AGENT_KINDS, type AgentEvent, type AgentKind, type AgentRun, type Provider } from "./types";
@@ -92,7 +96,7 @@ function codexModels(): ModelOption[] {
/** Modelos que o seletor oferece por agente. */
export function models(): Record<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). */
@@ -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" };
/** A preferida da tarefa se estiver pronta (e fora de pausa); senão a próxima da ordem da reserva. */
export function defaultProviderFor(kind: AgentKind): Provider {
const list = providers();
const preferred = PREFERRED_PROVIDER[kind];
if (list.find((p) => p.id === preferred)?.available) return preferred;
return list.find((p) => p.available)?.id ?? preferred;
return readyChain(PREFERRED_PROVIDER[kind])[0] ?? PREFERRED_PROVIDER[kind];
}
/** Modelo padrão: o do tipo de tarefa só vale para o Claude; no Codex, o do config.toml. */
export function defaultModelFor(kind: AgentKind, provider: Provider): string {
if (provider === "gemini") return "";
return provider === "claude" ? DEFAULT_MODEL[kind] : CODEX_DEFAULT_MODEL[kind];
}
@@ -125,11 +128,8 @@ export function defaultModelFor(kind: AgentKind, provider: Provider): string {
*/
const CODEX_DEFAULT_MODEL: Record<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). */
type ProviderInfo = {
id: Provider; available: boolean; path: string | null; version: string | null; note: string;
command: string | null; prefixArgs: string[];
};
/** Uma IA como o console do agente a vê. `available` = pronta (ligada, instalada e com login ou chave). */
type ProviderInfo = { id: Provider; available: boolean; path: string | null; version: string | null; note: string };
/**
* Execução em andamento. `followUp`: mensagem do usuário enviada durante a execução; quando ela
* fecha (sozinha ou interrompida), a mesma sessão é retomada com essa mensagem.
@@ -141,8 +141,10 @@ type ActiveRun = {
followUp: string | null;
/** O agente já deu um passo (texto ou ferramenta). Antes disso a sessão ainda não guardou o pedido. */
progressed: boolean;
/** Últimas linhas de erro (stderr e eventos de erro): decidem se a falha foi indisponibilidade. */
errors: string[];
};
const g = globalThis as unknown as { __cenaforgeAgents?: Map<number, ActiveRun>; __cenaforgeProviders?: { at: number; list: ProviderInfo[] } };
const g = globalThis as unknown as { __cenaforgeAgents?: Map<number, ActiveRun> };
const active = (g.__cenaforgeAgents ??= new Map());
/** Há um agente trabalhando? (o executor roda um por vez) */
@@ -150,52 +152,23 @@ export function busy(): boolean {
return active.size > 0;
}
/**
* Executável de um provedor. No Windows o npm instala o Codex como `codex.cmd` (que o Node
* não executa sem shell); nesse caso rodamos o `codex.js` do pacote diretamente pelo Node.
*/
function resolveCommand(id: Provider, envVar: string): { path: string; command: string; prefixArgs: string[] } | null {
const fromEnv = process.env[envVar];
if (fromEnv) {
return fromEnv.endsWith(".js")
? { path: fromEnv, command: process.execPath, prefixArgs: [fromEnv] }
: { path: fromEnv, command: fromEnv, prefixArgs: [] };
}
const exe = findOnPath(id);
if (exe) return { path: exe, command: exe, prefixArgs: [] };
if (id === "codex") {
for (const dir of (process.env.PATH ?? "").split(path.delimiter).filter(Boolean)) {
const js = path.join(dir, "node_modules", "@openai", "codex", "bin", "codex.js");
if (fs.existsSync(path.join(dir, "codex.cmd")) && fs.existsSync(js)) {
return { path: js, command: process.execPath, prefixArgs: [js] };
}
}
}
return null;
}
const PROVIDER_NOTE: Record<Provider, string> = {
claude: "Claude Code CLI em modo não interativo (-p, stream-json); edição automática dentro do projeto e comandos liberados.",
codex: "Codex CLI (codex exec --json) com sandbox workspace-write: escreve só dentro do projeto.",
gemini: "Gemini CLI (-p, stream-json) com edição automática; comandos de shell só os liberados (render e testes).",
};
/** As três IAs para o console: o estado vem de lib/ai.ts (instalada, ligada, login/chave, pausa da reserva). */
export function providers(): ProviderInfo[] {
// Cache curto: instalar ou remover uma CLI aparece sem reiniciar o painel.
if (g.__cenaforgeProviders && Date.now() - g.__cenaforgeProviders.at < 60_000) return g.__cenaforgeProviders.list;
const detect = (id: Provider, envVar: string, note: string): ProviderInfo => {
const resolved = resolveCommand(id, envVar);
let version: string | null = null;
if (resolved) {
const r = spawnSync(resolved.command, [...resolved.prefixArgs, "--version"], { encoding: "utf8", timeout: 20_000, windowsHide: true, shell: false });
version = r.status === 0 ? r.stdout.trim().split(/\r?\n/)[0] : null;
}
return providerStatus().map((p) => {
const pause = p.cooldown
? ` Em pausa até ${new Date(p.cooldown.until).toLocaleTimeString("pt-BR", { hour: "2-digit", minute: "2-digit" })} (${p.cooldown.reason}).`
: "";
return {
id, available: !!resolved && version !== null, path: resolved?.path ?? null, version,
note: resolved ? note : `${note} Não encontrado: instale e faça login${id === "codex" ? " (npm install -g @openai/codex; codex login)" : ""}.`,
command: resolved?.command ?? null, prefixArgs: resolved?.prefixArgs ?? [],
id: p.id, available: p.ready, path: p.path, version: p.version,
note: p.ready ? `${PROVIDER_NOTE[p.id]}${pause}` : `${PROVIDER_NOTE[p.id]} ${p.problem} Ajuste em Configurações → IA.`,
};
};
const list = [
detect("claude", "CLAUDE_BIN", "Claude Code CLI em modo não interativo (-p, stream-json); edição automática dentro do projeto e comandos liberados."),
detect("codex", "CODEX_BIN", "Codex CLI (codex exec --json) com sandbox workspace-write: escreve só dentro do projeto."),
];
g.__cenaforgeProviders = { at: Date.now(), list };
return list;
});
}
export function listRuns(limit = 30): AgentRun[] {
@@ -209,9 +182,14 @@ export function getRun(id: number): AgentRun | undefined {
export function startRun(input: {
provider: Provider; model: string; kind: AgentKind; request: string;
storyId?: string | null; episodeId?: number | null; resumeRunId?: number | null;
/** Execução que caiu por indisponibilidade e que esta continua com a IA reserva. */
fallbackOfRunId?: number | null;
}): AgentRun {
const info = providers().find((p) => p.id === input.provider);
if (!info?.available || !info.command) throw new UserError(`${input.provider} não está disponível neste computador.`);
const resolved = resolvedFor(input.provider);
if (!info?.available || !resolved) {
throw new UserError(`${PROVIDER_META[input.provider]?.label ?? input.provider} não está pronto neste computador. ${info?.note ?? ""}`.trim());
}
if (active.size > 0) throw new UserError("Já existe um agente trabalhando. Aguarde ou cancele antes de enviar outro pedido.");
const request = input.request.trim();
if (request.length < 2) throw new UserError("Escreva o pedido.");
@@ -230,12 +208,18 @@ export function startRun(input: {
throw new UserError("Só é possível continuar uma conversa do mesmo agente, com sessão registrada.");
}
const prompt = resume ? request : buildPrompt({ kind: input.kind, provider: input.provider, request, story, episode });
const fallbackOf = input.fallbackOfRunId ? getRun(input.fallbackOfRunId) : undefined;
const basePrompt = resume ? request : buildPrompt({ kind: input.kind, provider: input.provider, request, story, episode });
// Reserva: a IA anterior pode ter deixado arquivos pela metade; a nova confere antes de refazer.
const prompt = fallbackOf
? `${basePrompt}\n\nObservação: esta tarefa começou com outra IA (${PROVIDER_META[fallbackOf.provider].label}), que parou por indisponibilidade. ` +
"Confira o estado atual dos arquivos citados antes de criar ou refazer algo e continue de onde ela parou."
: basePrompt;
const logDir = path.join(DATA_DIR, "logs", "agents");
fs.mkdirSync(logDir, { recursive: true });
const row = run(`INSERT INTO agent_runs (provider, model, kind, prompt, story_id, episode_id, resume_of, status, log_path, started_at)
VALUES (?, ?, ?, ?, ?, ?, ?, 'running', '', ?)`,
input.provider, input.model, input.kind, request, story?.id ?? null, episode?.id ?? null, resume?.id ?? null, now());
const row = run(`INSERT INTO agent_runs (provider, model, kind, prompt, story_id, episode_id, resume_of, fallback_of, status, log_path, started_at)
VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'running', '', ?)`,
input.provider, input.model, input.kind, request, story?.id ?? null, episode?.id ?? null, resume?.id ?? null, fallbackOf?.id ?? null, now());
const id = Number(row.lastInsertRowid);
const logPath = path.join(logDir, `${id}.jsonl`);
run("UPDATE agent_runs SET log_path = ? WHERE id = ?", rel(logPath), id);
@@ -246,20 +230,31 @@ export function startRun(input: {
...(resume?.session_id ? ["--resume", resume.session_id] : []),
...CLAUDE_LEAN_FLAGS, "--max-budget-usd", String(CLAUDE_BUDGET_USD[input.kind]),
"--allowedTools", CLAUDE_ALLOWED_TOOLS]
: codexArgs(prompt, input.model, resume?.session_id ?? null, input.kind);
: input.provider === "codex"
? codexArgs(prompt, input.model, resume?.session_id ?? null, input.kind)
: geminiArgs(prompt, input.model, resume?.session_id ?? null);
const child = spawn(info.command, [...info.prefixArgs, ...args], { cwd: REPO_ROOT, shell: false, windowsHide: true, stdio: ["ignore", "pipe", "pipe"] });
// providerEnv: chave de API só nesta chamada (modo "chave") ou nenhuma (modo "conta"); ver doc/ia.md.
const child = spawn(resolved.command, [...resolved.prefixArgs, ...args], {
cwd: REPO_ROOT, shell: false, windowsHide: true, stdio: ["ignore", "pipe", "pipe"], env: providerEnv(input.provider),
});
const listeners = new Set<(e: AgentEvent | null) => void>();
const log = fs.createWriteStream(logPath);
const gemini: GeminiState = { text: "" };
const emit = (e: Omit<AgentEvent, "at">) => {
if (e.kind !== "system" && e.kind !== "stderr" && e.kind !== "error") entry.progressed = true;
if (e.kind === "stderr" || e.kind === "error" || (e.kind === "result" && e.isError)) {
entry.errors.push(e.text);
if (entry.errors.length > 20) entry.errors.shift();
}
const event = { ...e, at: now() } as AgentEvent;
log.write(JSON.stringify(event) + "\n");
for (const l of listeners) l(event);
};
const entry: ActiveRun = { child, listeners, emit, followUp: null, progressed: false };
const entry: ActiveRun = { child, listeners, emit, followUp: null, progressed: false, errors: [] };
active.set(id, entry);
emit({ kind: "system", text: `${input.provider}${input.model ? ` · ${input.model}` : ""} · tarefa "${input.kind}"${resume ? ` · continua a execução #${resume.id}` : ""}` });
emit({ kind: "system", text: `${input.provider}${input.model ? ` · ${input.model}` : ""} · tarefa "${input.kind}"` +
`${resume ? ` · continua a execução #${resume.id}` : ""}${fallbackOf ? ` · reserva da execução #${fallbackOf.id}` : ""}` });
child.stdout.setEncoding("utf8").on("data", lineSplitter((line) => {
let obj: Record<string, unknown>;
@@ -269,7 +264,8 @@ export function startRun(input: {
emit({ kind: "text", text: line.slice(0, 2000) });
return;
}
const events = input.provider === "claude" ? normalizeClaude(obj, id) : normalizeCodex(obj, id);
const events = input.provider === "claude" ? normalizeClaude(obj, id)
: input.provider === "codex" ? normalizeCodex(obj, id) : normalizeGemini(obj, id, gemini);
events.forEach(emit);
}));
child.stderr.setEncoding("utf8").on("data", lineSplitter((line) => {
@@ -277,6 +273,7 @@ export function startRun(input: {
}));
child.on("error", (error) => emit({ kind: "error", text: `não iniciou: ${error.message}`, isError: true }));
child.on("close", (code) => {
if (input.provider === "gemini") flushGemini(gemini, id).forEach(emit);
// Tarefa "criar história": a IA grava meta.json com título e premissa definitivos.
if (input.kind === "story" && story && code === 0) syncStoryMeta(story.id);
const current = getRun(id);
@@ -286,6 +283,12 @@ export function startRun(input: {
ok ? "success" : "error", ok ? null : `saiu com código ${code}`, now(), id);
}
active.delete(id);
// IA reserva: caiu por indisponibilidade (cota, login, rede…) e ninguém mandou mensagem → a próxima IA assume.
// Começa antes das vertentes e dos ouvintes: o preparo passa a esperar a reserva e o "end" já leva o id dela.
const fallbackRunId = entry.followUp ? null : startFallback(id, entry);
if (fallbackRunId) {
run("UPDATE episodes SET branches_run_id = ? WHERE branches_run_id = ? AND branches_status = 'running'", fallbackRunId, id);
}
// Vertentes: fecha o preparo desta execução e começa o próximo da fila (o executor já está livre).
try {
onAgentRunClosed(id, getRun(id)?.status === "success");
@@ -339,9 +342,45 @@ export function sendFollowUp(id: number, text: string, mode: "now" | "queue"): v
}
}
/** A execução que continuou esta (mensagem enviada durante ela ou "Continuar esta conversa"). */
/** A execução que continuou esta (mensagem enviada durante ela, "Continuar esta conversa" ou a IA reserva). */
export function followUpRunOf(id: number): number | null {
return get<{ id: number }>("SELECT id FROM agent_runs WHERE resume_of = ? ORDER BY id DESC LIMIT 1", id)?.id ?? null;
return get<{ id: number }>("SELECT id FROM agent_runs WHERE resume_of = ? OR fallback_of = ? ORDER BY id DESC LIMIT 1", id, id)?.id ?? null;
}
/**
* Se a execução terminou com erro de indisponibilidade, põe a IA em pausa e começa a mesma tarefa na próxima IA
* pronta da ordem (Configurações → IA). Cada IA é tentada uma vez por cadeia. Devolve o id da nova execução.
*/
function startFallback(id: number, entry: ActiveRun): number | null {
const closed = getRun(id);
if (!closed || closed.status !== "error") return null;
if (!isAvailabilityError([closed.error ?? "", ...entry.errors].join("\n"))) return null;
markUnavailable(closed.provider, closed.error ?? entry.errors.at(-1) ?? "indisponível");
// IAs já tentadas nesta cadeia (segue fallback_of para trás).
const tried: Provider[] = [];
for (let cursor: AgentRun | undefined = closed; cursor; cursor = cursor.fallback_of ? getRun(cursor.fallback_of) : undefined) {
tried.push(cursor.provider);
}
const next = nextFallback(tried);
if (!next) {
entry.emit({ kind: "system", text: `${PROVIDER_META[closed.provider].label} ficou indisponível e não há outra IA pronta para assumir (Configurações → IA).` });
return null;
}
// Numa continuação, o prompt guardado é só a mensagem nova: o pedido original vem da primeira execução da conversa.
let root: AgentRun = closed;
for (let parent = root.resume_of ? getRun(root.resume_of) : undefined; parent; parent = parent.resume_of ? getRun(parent.resume_of) : undefined) root = parent;
const request = root.id === closed.id ? closed.prompt : `${root.prompt}\n\nMensagem seguinte do usuário:\n${closed.prompt}`;
try {
const started = startRun({
provider: next, model: defaultModelFor(closed.kind, next), kind: closed.kind, request: request.slice(0, 20_000),
storyId: closed.story_id, episodeId: closed.episode_id, fallbackOfRunId: id,
});
entry.emit({ kind: "system", text: `${PROVIDER_META[closed.provider].label} indisponível: a tarefa continua com ${PROVIDER_META[next].label} (execução #${started.id}).` });
return started.id;
} catch (error) {
entry.emit({ kind: "error", text: `A IA reserva não começou: ${(error as Error).message}`, isError: true });
return null;
}
}
export function cancelRun(id: number): void {
@@ -421,6 +460,72 @@ const STDERR_NOISE = [/no stdin data received/, /Reading additional input from s
// O Claude Code avisa de id fora da lista interna dele, mas roda o modelo normalmente (testado com claude-fable-5-2).
/\[claude-code:unrecognized_model\]/];
// --- Gemini ---------------------------------------------------------------------
/**
* Gemini CLI 0.68.0 sem interação (doc/ia.md). `auto_edit` aprova as edições sozinho; de shell, só os comandos
* abaixo (no modo não interativo o resto é recusado). `--skip-trust`: confia na pasta só nesta execução.
*/
const GEMINI_ALLOWED_SHELL = [
"pnpm render", "pnpm verify", "pnpm test", "pnpm typecheck", "pnpm.cmd render", "pnpm.cmd verify", "pnpm.cmd test", SKILL_SCRIPTS,
].map((command) => `run_shell_command(${command})`);
export function geminiArgs(prompt: string, model: string, sessionId: string | null): string[] {
return ["-p", prompt, "-o", "stream-json", "--approval-mode", "auto_edit", "--skip-trust",
...(model ? ["-m", model] : []), ...(sessionId ? ["--resume", sessionId] : []),
"--allowed-tools", ...GEMINI_ALLOWED_SHELL];
}
/** O texto do Gemini chega em pedaços (`delta`): junta e solta um bloco só quando chega outro tipo de evento. */
export type GeminiState = { text: string };
function flushGemini(state: GeminiState, runId: number): Omit<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 ---------------------------------------------------------------
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';
`,
// 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 };
+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`). " +
"Não acione os subagentes `cenaforge-skill-updater` nem `cenaforge-token-auditor` (100–150 mil tokens cada): isso é feito fora do painel. " +
"Ao terminar, liste os arquivos criados ou alterados e o que ficou pendente.",
provider === "codex"
? "Você é o Codex. Arquivos em `.claude/agents/` são subagentes do Claude: você não os aciona; quando o CLAUDE.md mandar delegar a um deles, faça o trabalho você mesmo. " +
provider !== "claude"
? `Você é o ${provider === "codex" ? "Codex" : "Gemini"}. ` +
"Arquivos em `.claude/agents/` são subagentes do Claude: você não os aciona; quando o CLAUDE.md mandar delegar a um deles, faça o trabalho você mesmo. " +
"No PowerShell, leia texto com `Get-Content -Raw -Encoding UTF8` (sem isso os acentos saem quebrados) e rode o pnpm como `pnpm.cmd` " +
"(o `pnpm.ps1` é bloqueado pela política de execução): `pnpm.cmd render -- --config <json> --profile preview`."
: 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", () => {
const version = dbm.get<{ user_version: number }>("PRAGMA user_version")!.user_version;
assert.equal(version, dbm.MIGRATIONS.length);
assert.equal(version, 9);
assert.equal(version, 10);
assert.equal(fs.readdirSync(path.join(ROOT, "data", "backups")).filter((f) => f.startsWith("cenaforge-v4-")).length, 1);
assert.deepEqual(dbm.all("PRAGMA foreign_key_check"), []);
});
+4 -1
View File
@@ -123,7 +123,8 @@ export type Decision = {
snapshot_json: string;
};
export type Provider = "claude" | "codex";
export type Provider = "claude" | "codex" | "gemini";
export const PROVIDERS: Provider[] = ["claude", "codex", "gemini"];
// godot: o agente constrói uma cena nova na biblioteca do Godot (godot/library/, doc/godot/cenas.md).
export type AgentKind = "free" | "story" | "script" | "scene" | "branches" | "godot" | "character";
export const AGENT_KINDS: AgentKind[] = ["free", "story", "script", "scene", "branches", "godot", "character"];
@@ -138,6 +139,8 @@ export type AgentRun = {
story_id: string | null;
episode_id: number | null;
resume_of: number | null;
/** Execução que falhou por indisponibilidade e que esta continuou com a IA reserva. */
fallback_of: number | null;
status: AgentStatus;
session_id: string | null;
cost_usd: number | null;