Documentação
TokenEconomizer
Como integrámos o TokenEconomizer no Brain do VibeiDE
O Economizer do VibeiDE é a nossa própria implementação da arquitetura publicada do TokenEconomizer da Microsoft Research, Microsoft Security e UC Berkeley, não o próprio plugin. Não faz chamadas a modelos, não escreve nada no seu repositório e não carrega nada enquanto o Brain estiver desativado num projeto. Esta página explica o que mantivemos, o que alterámos e o que deixámos de fora.
Uma implementação da arquitetura, não do plugin
O TokenEconomizer é distribuído como um plugin Python que escreve no repositório e pede a um modelo que tome algumas decisões. O Brain do VibeiDE tem requisitos mais rigorosos: nenhuma chamada a modelos, nenhuma chave, nenhum Python, nenhum ficheiro escrito no seu repositório e nada carregado enquanto o Brain estiver desativado num projeto. Por isso, reimplementámos os três mecanismos no VibeiDE, com base na arquitetura publicada e nas suas constantes, e mantivemos apenas o que respeita esses requisitos. Nenhum componente do plugin é incluído, instalado ou executado.
Duas formas de ler uma chamada a ferramenta
O Economizer precisa de ver o que um agente executou e o resultado que recebeu. No caso do Claude Code num terminal, lê os hooks do próprio Claude Code e responde-lhes antes de o Claude ler o resultado da ferramenta. No caso do Codex, e do Claude Code quando é executado sem hooks, lê o fluxo de eventos que o VibeiDE já mantém para a Atividade da tarefa. Ambos são convertidos para um formato único: a ferramenta, o comando, os caminhos, a saída e a indicação de falha. A saída é truncada, lida uma única vez e nunca é guardada.
Os factos são frases fixas, porque os comandos não são de confiança
Um facto é transmitido a todas as tarefas seguintes e tem origem em comandos escritos por um agente e em saídas produzidas por um repositório. Por isso, o Economizer nunca guarda texto livre. Um facto é uma de quatro frases fixas com parâmetros validados: uma forma curta de comando expressa em palavras simples, um nome de ferramenta, um nome de anfitrião ou um nome de variável. O valor de uma variável só é indicado quando é curto e simples e o nome da variável não sugere informação sensível. Tudo o resto não dá origem a nenhum facto.
Quando um facto é guardado, transmitido e retirado
Usamos o ciclo de vida do TokenEconomizer. Um candidato torna-se um facto depois de três tarefas o confirmarem. Só é transmitido enquanto o desperdício que evita surgir em pelo menos 40 por cento de um mínimo de quatro tarefas em que foi relevante. Uma pontuação que dá mais peso às tarefas recentes determina a sua retirada, por exemplo quando a forma anterior de escrever um comando volta a funcionar em duas tarefas seguidas.
Proteção contra ciclos sem um modelo avaliador
O plugin pergunta a um modelo se um turno sinalizado está realmente bloqueado. O Brain não tem um modelo a quem perguntar, pelo que a proteção usa a predefinição conservadora da arquitetura: espera até que sete turnos tenham terminado com sucesso no projeto e nunca atua antes de ser ultrapassada a duração habitual de um turno bem-sucedido. Um turno só é considerado bloqueado quando se prolonga, continua a editar os mesmos ficheiros, apresenta uma elevada frequência de erros e repete a mesma falha.
A reorientação segue na resposta ao próprio hook do Claude Code
A nota chega ao Claude Code como contexto adicional na resposta ao seu próprio hook de ferramenta, associada ao resultado dessa ferramenta e lida no mesmo turno. Apresenta ao agente as suas próprias contagens, indica que é automática e não contém conhecimento externo. O Codex não tem esse canal no VibeiDE: a única forma de intervir num turno do Codex em curso é enviar uma instrução de orientação, que seria interpretada como palavras suas. Por isso, um turno bloqueado do Codex recebe apenas a linha destinada a si.
O que deixámos de fora e como verificámos
Não implementámos a remoção das ferramentas integradas do Claude Code nem dos pacotes de capacidades do Codex, e não nos cabe remover as ferramentas que instalou. Apenas os dois servidores de ferramentas associados pelo VibeiDE são candidatos à exclusão. Verificámos todo o processo com o Claude Code e o Codex reais numa cópia isolada da aplicação: um facto foi consolidado ao longo de quatro tarefas, e a tarefa seguinte recebeu-o e executou diretamente o comando que funciona. Não indicamos um valor de poupança.
Fontes: TokenEconomizer no GitHub, artigo científico do TokenEconomizer.