
Trilhas de auditoria à prova de adulteração para agentes de IA: Registros de Runtime encadeados por hash, sem dependências, verificáveis por qualquer pessoa.
Trilhas de auditoria à prova de adulteração para agentes de IA — Runtime Records encadeados por hash, renderizados como um Runtime Report que seus clientes podem verificar por conta própria.
Cada ação capturada pela sua instrumentação (chamadas de ferramentas, chamadas de modelo, acesso a dados, aprovações) torna-se um Runtime Record em um log somente de acréscimo, encadeado por hash; o Runtime Report é essa cadeia renderizada como uma página HTML que recalcula a cadeia de hashes no navegador do leitor e renderiza o que exibe a partir dos registros que verificou (para uma verificação que não depende do próprio código da página, execute halo verify no JSONL). Qualquer parte que detenha um checkpoint da cadeia pode verificar que os registros até aquele checkpoint não foram alterados desde que ele foi obtido, sem confiar em quem os produziu — esse checkpoint é a peça fundamental: a cadeia sozinha é à prova de adulteração contra todos, exceto contra a parte que opera o gravador (LIMITS.md §1). Quando a equipe de segurança de um cliente pergunta "o que o seu agente fez com os nossos dados?", você entrega um link em vez de um parágrafo. As revisões de segurança já fazem perguntas sobre IA ao lado da checklist SOC 2 — e, cada vez mais, essas perguntas vêm da ISO 42001, dos artigos de manutenção de registros do EU AI Act e dos questionários dos próprios clientes. Hoje, uma garantia por escrito ainda passa. A aposta por trás deste projeto é que isso não durará muito.
"Vinte anos em forense ensinam que uma evidência só é evidência se o outro lado puder verificá-la... em um campo cheio de produtos de IA que pedem confiança, [Halo] é o raro que foi projetado para tornar a confiança desnecessária."
Johannes Stillig, Fundador e CEO da Tidebreak AI e Group CISO em um escritório de investimentos privado
Destacado na Help Net Security · Top 4% dos lançamentos do Show HN naquela semana · Listado em Agentic Trust Controls em relação a cinco controles
O formato de registro é aberto e livre para implementação. Este pacote é a implementação de referência: gravador, verificador, cliente de testemunha e servidor de relatórios.
Usando o halo-record, ou pensando em usá-lo? Conte quem você é e para quê → Quem está usando o halo-record?
Estão pedindo que você coloque um gravador dentro do seu agente. Você não deveria aceitar isso pela fé:
pip install halo-record instala exatamente um pacote.halo serve --verify-email (envia um código de uso único e o nome do sujeito do relatório, por SMTP através do servidor que você configurar em $HALO_SMTP_HOST, para o endereço que um visualizador do relatório inserir). Todas ficam desativadas a menos que você as invoque; nenhum outro conteúdo de registro sai da sua infraestrutura.summaries=False) não mantém resumo algum. A redação é feita na melhor medida do possível (regex sobre formatos comuns de segredos e PII mais uma captura genérica por entropia): trate-a como defesa em profundidade, não como garantia. Campos de resultado que você fornecer além de summary são verificados e mascarados com os mesmos padrões, mas não são cortados em 200 caracteres (LIMITS §13).O que cada camada prova — a distinção fundamental neste projeto (LIMITS.md §1): uma cadeia que você mesmo mantém prova que os registros não foram editados, em relação a um head que alguém já possui; apenas checkpoints mantidos fora do operador provam que nenhum foi removido; e nenhum hash prova que toda ação foi capturada.
| Afirmação | Cadeia auto-mantida | + Checkpoints externos | + Captura confiável |
|---|---|---|---|
| Detectar edições a um artefato estabelecido | ✔ | ✔ | ✔ |
| Detectar reescrita de histórico confirmado | — | ✔ | ✔ |
| Detectar checkpoints ausentes/atrasados | — | ✔ (cadência acordada) | ✔ |
| Provar que toda ação foi registrada | — | — | depende do limite de captura |
Veja um antes de instalar: um Runtime Report de exemplo — dados fictícios, cadeia real, e seu script recalcula a cadeia de hash dos registros embutidos no seu navegador quando você o abre.
Nenhum agente necessário. Com uv, nada a instalar:
uvx --from halo-record halo demo --serve
ou da forma clássica:
pip install halo-record
halo demo --serve
Qualquer um dos dois cria um fornecedor fictício de agente de suporte com dois clientes, testemunha as cadeias (com um arquivo de testemunha local substituindo um fora do operador — veja LIMITS.md §1), serve seus Runtime Reports com acesso restrito e abre o console do operador no seu navegador. Em seguida, experimente o teste de adulteração: exclua uma linha de um dos arquivos .jsonl e recarregue. O relatório detecta a alteração.
Uma linha no limite:
from halo_record import trace
agent = trace(run_my_agent, profile="my-agent", log="audit.jsonl") # wraps your entrypoint; records the run boundary to ./audit.jsonl — add record_call() or a framework adapter at each tool boundary to capture individual calls
Um shim de conveniência from halo import ... também é fornecido — mas o nome halo no PyPI pertence a um pacote de spinner de terminal não relacionado, e se esse pacote estiver instalado, ele vence a importação. halo_record não é ambíguo, então os exemplos o utilizam.
Sem log=, os registros vão para ~/.halo/my-agent.jsonl (uma cadeia por agente). O wrapper sela o limite da execução; a evidência vive nos registros por chamada. Capture-os com um adaptador de framework (matriz abaixo) — ou explicitamente, o que também mostra como a delegação se vincula:
from halo_record import Recorder, record_call
rec = Recorder("audit.jsonl")