Uma regra deny é o único limite que você tem

· 5 min de leitura

Todo o resto que um harness de agentes chama de permissão é um julgamento sobre custo. Vale dizer isso com todas as letras, porque a interface não diz: um pedido de aprovação, um modo chamado Auto e uma configuração de diretórios graváveis parecem a mesma espécie de coisa, e só um deles é uma linha que o sistema vai manter aconteça o que acontecer.

O OHarness tem cinco modos de permissão. Manual pergunta antes de qualquer coisa que altere o estado. Aceitar edições deixa passar a gravação de arquivos e pergunta sobre o resto. Plan recusa toda alteração e só lê. Auto deixa passar edições e comandos de rotina e pergunta sobre os arriscados. Bypass aprova tudo.

Quatro desses cinco são um botão que regula com que frequência você é interrompido. O quinto nem é um modo.

O que o classificador realmente mede

Auto é o modo em que a maioria das pessoas se acomoda, então vale saber o que decide. O classificador por trás dele mede o raio de impacto, não a intenção: rm, sudo, git push, kubectl, npm publish, uma gravação em um caminho absoluto fora de /tmp. Tudo o que ele não reconhece como rotina continua perguntando.

Esse viés é deliberado e é o único sensato. A falha que custa algo é aprovar um comando que destrói trabalho. A falha na outra direção é ser perguntado sobre mais um ls, o que custa uma tecla. Um classificador ajustado para ser esperto sobre o segundo caso é um classificador que, cedo ou tarde, vai errar no primeiro.

Mas um classificador conservador continua sendo um classificador. Ele lê um comando e chuta. bash -c 'python -c "..."' é uma linha de shell cujo raio de impacto simplesmente não aparece nos argumentos, e nenhum trabalho com padrões resolve isso, porque a informação não está lá para ser lida.

As regras que não são chutes

Abaixo dos modos ficam três listas, comparadas tanto com o nome da ferramenta quanto com a forma Tool(argument):

{
  "allow": ["Bash(npm run test:*)", "mcp__github__get_*"],
  "ask":   ["Bash(git push*)"],
  "deny":  ["Bash(rm -rf *)", "write(.env*)"]
}

deny vence tudo, inclusive o modo bypass. Essa é a única frase do sistema de permissões em que uma pessoa pode confiar de forma absoluta: não existe modo, aprovação nem “sempre permitir” que reabra um caminho fechado por uma regra deny. Tudo acima disso — os modos, o classificador, os pedidos — é um andaime em torno da pergunta de quanto você quer ser consultado.

As aprovações persistem, e onde elas persistem importa. “Sempre permitir” é gravado em um arquivo de configurações em um de três escopos: ~/.oharness/settings.json para um hábito pessoal, .oharness/settings.json para algo que pertence ao repositório e pode ser revisado em um pull request, e .oharness/settings.local.json para uma escolha por checkout que fica fora do Git. As negações se acumulam nos três e nunca são sobrescritas por um escopo mais restrito, porque um projeto precisa poder proibir o que um usuário permitiu globalmente.

O que é gravado é o padrão mais específico que cobre o que você aprovou. Aprovar Bash(npm test) não pode conceder silenciosamente todo Bash(...), e aprovar uma ferramenta de um app conectado não pode conceder o resto desse app, muito menos todos os apps que você conectou. Um sistema de permissões que se amplia enquanto você clica é pior do que nenhum sistema de permissões, porque produz um arquivo de configurações que parece uma política e se comporta como um bypass.

Diretórios graváveis são uma barreira de política, não um sandbox

workspaceMode é read-only, workspace-write ou full-access, e a verificação roda antes do pedido de aprovação — oferecer a alguém uma escolha que a política já proíbe é um bom jeito de ensinar que os pedidos são decorativos.

Vale ser exato sobre o que essa verificação é. Ela inspeciona os argumentos das ferramentas e recusa caminhos fora dos diretórios permitidos. Ela não confina o processo. Um comando de shell alcança qualquer caminho que você alcança, e o caso python -c acima derrota completamente a inspeção de argumentos. Confinamento de verdade é um recurso do sistema operacional — um contêiner, uma VM, uma conta de usuário com menos direitos — e um harness que afirma o contrário está vendendo a sensação de um limite.

Ou seja: uma proteção contra erros, que são a maior parte do que dá errado. Não uma proteção contra um comando determinado, que é o que as pessoas acham que compraram.

O registro é a parte que você vai querer depois

Cada decisão de permissão é registrada ao lado da transcrição que a gerou, em duas linhas pareadas pelo id:

{"kind":"decision","id":"dec_9f2c","tool":"bash","behavior":"ask","principal":"Bash(npm test)"}
{"kind":"answer","id":"dec_9f2c","outcome":"allowed","remembered":"Bash(npm test)"}

A decisão é o que as regras disseram. A resposta é o que a pessoa disse. Um ask sem resposta significa que o processo parou enquanto a pergunta ainda estava na tela — exatamente o estado que você não consegue reconstruir de memória uma semana depois. outcome: "unavailable" é o caso fail-closed: nada conseguiu perguntar, então a chamada foi recusada sem ninguém no loop.

Ele fica ligado a menos que você o desligue, porque o registro custa algumas linhas curtas por turno e o estado em que ele falta é, de forma confiável, o estado em que ele teria sido necessário. Ele fica na máquina que tomou as decisões: a sincronização envia transcrições e artefatos e, de propósito, não envia isto, e ele é apagado junto com a sua sessão.

As gravações nele são fire-and-forget, mas serializadas. É uma troca feita de propósito — o registro não pode atrasar nem fazer falhar uma chamada de ferramenta, então uma gravação com falha vira um aviso no log, e não um comando recusado. Esse registro descreve o que aconteceu. Ele não o controla. O que é, mais uma vez, a mesma distinção: saiba quais dos seus controles são julgamentos e qual deles é um limite.


O OHarness é um harness de agentes open source, sob licença MIT. A referência de permissões traz a tabela completa de modos, escopos e formas de regra, e a referência de arquitetura mostra onde a camada de permissões fica em relação ao modelo e às ferramentas.