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