# IA do CenaForge — provedores, login e reserva Três IAs, sempre pela **CLI oficial** instalada no PC (nunca SDK/HTTP direto): | Provedor | CLI | Instalação (Windows) | Login com a conta (OAuth) | Chave de API (variável) | |---|---|---|---|---| | `claude` | Claude Code (`claude`) | `irm https://claude.ai/install.ps1 \| iex` | `claude auth login` | `ANTHROPIC_API_KEY` | | `codex` | Codex (`codex`) | `npm install -g @openai/codex@latest` | `codex login` (ChatGPT) | `CODEX_API_KEY` (só no `codex exec`) | | `gemini` | Gemini CLI (`gemini`) | `npm install -g @google/gemini-cli@latest` | `gemini` interativo → "Login with Google" | `GEMINI_API_KEY` | > **Gemini + OAuth (verificado em 18/11/2026, gemini-cli 0.68.0):** o login gratuito "Gemini Code Assist for > individuals" foi encerrado (`IneligibleTierError: UNSUPPORTED_CLIENT`, o Google manda migrar para o Antigravity). > OAuth só funciona com plano elegível (Code Assist Standard/Enterprise, Workspace). Para conta pessoal, use a > **chave de API** do Google AI Studio. Quem usa: os **agentes do painel** (`panel/src/lib/agents.ts`) e o **juiz do Clipador** (`clipper/app/judge.py`). A configuração fica no painel em **Configurações → IA** (`/settings/ai`). ## Arquivos compartilhados (contrato painel ↔ Clipador) Ambos em `data/ai/`. Quem escreve é só o painel; o Clipador apenas lê (relê se o `mtime` mudar). ### `data/ai/settings.json` (sem segredo) ```json { "version": 1, "providers": { "claude": { "enabled": true, "authMode": "oauth" }, "codex": { "enabled": true, "authMode": "oauth" }, "gemini": { "enabled": false, "authMode": "apiKey" } }, "order": ["claude", "codex", "gemini"], "fallback": { "enabled": true, "cooldownMin": 15 } } ``` - `enabled`: a IA pode ser usada (como principal ou reserva). Desligada, nunca é chamada. - `authMode`: `"oauth"` = a sessão já logada da CLI; `"apiKey"` = a chave guardada no cofre. - `order`: prioridade da **reserva**. A tarefa usa a IA escolhida (ou a preferida dela); se falhar por indisponibilidade, tenta a próxima da lista que estiver ligada e pronta. - `fallback.enabled`: liga a troca automática. `cooldownMin`: depois de uma falha de indisponibilidade, a IA fica "em pausa" esse tempo e é pulada (cada processo guarda a sua pausa em memória). - Arquivo ausente ou inválido = padrão acima, com `claude` e `codex` ligados em `oauth` e `gemini` desligado. ### `data/ai/vault.bin` (chaves de API) Um JSON `{"claude": "sk-ant-…", "codex": "sk-…", "gemini": "AIza…"}` (só as que existirem) cifrado com a **DPAPI do Windows**, escopo do usuário (`CurrentUser`), entropia `b"CenaForge.AI.vault.v1"`. O arquivo é o blob cru da DPAPI. Só a mesma conta do Windows nesta máquina abre. A chave **nunca** volta para a tela: a API do painel só diz se existe e os 4 últimos caracteres. ## Ambiente de cada chamada Montado a partir do ambiente do processo, por provedor: | Provedor | `authMode = "oauth"` | `authMode = "apiKey"` | |---|---|---| | `claude` | remove `ANTHROPIC_API_KEY` | `ANTHROPIC_API_KEY=` | | `codex` | remove `CODEX_API_KEY` | `CODEX_API_KEY=` | | `gemini` | `GOOGLE_GENAI_USE_GCA=true`, remove `GEMINI_API_KEY` | `GEMINI_API_KEY=`, remove `GOOGLE_GENAI_USE_GCA` | Assim o login global de cada CLI não é tocado: o modo chave só vale para a chamada. ## O que conta como "indisponível" (dispara a reserva) Falha que não é culpa do pedido: limite de uso ou cota (`rate limit`, `429`, `quota`, `usage limit`, `credit balance`), sobrecarga (`overloaded`, `529`, `503`, `unavailable`), login ou chave (`401`, `403`, `unauthorized`, `not logged in`, `invalid api key`, `IneligibleTier`), rede (`ECONN`, `ETIMEDOUT`, `ENOTFOUND`, `network`), CLI que não iniciou ou não foi encontrada, e tempo esgotado. Erro de conteúdo (JSON inválido, schema) **não** troca de IA. ## Gemini CLI em modo headless (0.68.0) - Agente: `gemini -p -o stream-json --approval-mode auto_edit --skip-trust [-m ] [--resume ]`. - Eventos JSONL: `init {session_id, model}`, `message {role, content, delta}` (texto do assistente chega em pedaços), `tool_use {tool_name, tool_id, parameters}`, `tool_result {tool_id, status, output, error}`, `error {severity: warning|error, message}`, `result {status, error?, stats}`. - Respostas estruturadas (juiz): `-o json` devolve `{"response": "", "stats": …}`; não há `--output-schema`, então o schema vai no prompt e o JSON é extraído do texto. Leitura somente: `--approval-mode plan --skip-trust`, rodando numa pasta temporária fora do repositório (o `@arquivo` respeita o `.gitignore`). - Modelos: `gemini models -o json` (não exige login). - No Windows o npm instala `gemini.cmd`; rode `node /node_modules/@google/gemini-cli/bundle/gemini.js`.