
halo-record v0.2.32
Защищённые от несанкционированного вмешательства журналы аудита для ИИ-агентов: связанные хэш-цепочкой записи Runtime Records, без зависимостей, проверяемые кем угодно.
halo-record
Аудит-трейлы для AI-агентов с защитой от подделки — Runtime Records, связанные хеш-цепочкой и отображаемые в виде Runtime Report, который ваши клиенты могут проверить самостоятельно.
Каждое действие, зафиксированное вашей инструментацией (вызовы инструментов, вызовы моделей, доступ к данным, подтверждения), становится одной Runtime Record в журнале, доступном только для добавления и связанном хеш-цепочкой; Runtime Report — это та же цепочка, отрендеренная в виде HTML-страницы, которая пересчитывает хеш-цепочку в браузере читателя и отображает то, что показывает, на основе проверенных ею записей (для проверки, не полагающейся на собственный код страницы, запустите halo verify на JSONL). Любая сторона, владеющая контрольной точкой цепочки, может убедиться, что записи до этой контрольной точки не были изменены с момента её создания, не доверяя тому, кто их создал, — эта контрольная точка является ключевым элементом: одна лишь цепочка обеспечивает защиту от подделки для всех, кроме стороны, управляющей регистратором (LIMITS.md §1). Когда служба безопасности клиента спрашивает: «Что ваш агент делал с нашими данными?», вы отправляете им ссылку вместо абзаца текста. Проверки безопасности уже включают вопросы об AI рядом с чек-листом SOC 2 — и всё чаще эти вопросы исходят из ISO 42001, статей EU AI Act о ведении документации и собственных опросников клиентов. Сегодня письменное заверение всё ещё проходит. Ставка этого проекта в том, что так будет недолго.
«Двадцать лет в криминалистике учат тому, что доказательство — это доказательство, только если другая сторона может его проверить... в области, полной AI-продуктов, требующих доверия, [Halo] — редкий из тех, что создан, чтобы сделать доверие ненужным.»
Johannes Stillig, основатель и CEO Tidebreak AI, Group CISO в частном инвестиционном офисе
Отмечен в Help Net Security · В топ-4% запусков Show HN той недели · Указан в Agentic Trust Controls по пяти контролям
Формат записей открыт и свободен для реализации. Этот пакет — эталонная реализация: регистратор, верификатор, клиент-свидетель и сервер отчётов.
Используете halo-record или думаете об этом? Расскажите, кто вы и для чего → Кто использует halo-record?
Проверьте сами
Вас просят внедрить регистратор внутрь вашего агента. Вы не должны принимать это на веру:
- Нулевые зависимости во время выполнения. Только стандартная библиотека.
pip install halo-recordустанавливает ровно один пакет. - Никаких сетевых вызовов, кроме четырёх опциональных — привязка к свидетелю (отправляет id субъекта, количество записей и два отпечатка цепочки — голову и корень цепочки), чтение контрольных точек свидетеля обратно (отправляет id субъекта), метка времени RFC 3161 (отправляет только хеш состояния контрольной точки в Timestamp Authority) и
halo serve --verify-email(отправляет одноразовый код и имя субъекта отчёта по SMTP через сервер, который вы настроите в$HALO_SMTP_HOST, на адрес, введённый просматривающим отчёт). Все они отключены, пока вы их не вызовете; никакое другое содержимое записей не покидает вашу инфраструктуру. - Необработанные аргументы инструментов хешируются, рядом сохраняется отредактированная сводка. Аргументы хранятся в виде канонического хеша плюс сводки: текст аргументов с маскированием известных шаблонов секретов и PII, ограниченный 200 символами. Короткий ввод, не совпадающий ни с одним шаблоном, отображается в сводке полностью; режим только хешей (
summaries=False) не сохраняет сводку вовсе. Редактирование выполняется по мере возможности (регулярные выражения по распространённым форматам секретов и PII плюс универсальный перехват по энтропии): рассматривайте его как дополнительный уровень защиты, а не как гарантию. Поля результата, которые вы передаёте помимоsummary, сканируются и маскируются теми же шаблонами, но не обрезаются до 200 символов (LIMITS §13). - Достаточно мал для аудита. ~8 700 строк Python, включая встроенные JavaScript и CSS страницы отчёта (строки кода, без учёта пустых строк, комментариев и docstring). Всё это можно прочитать за день.
- Apache-2.0.
- Документация — первостепенна. LIMITS.md (что цепочка не может доказать), PRIVACY.md (что содержат записи и что покидает вашу машину), RETENTION.md (работа в условиях политики хранения) и REVIEWERS.md — независимая проверка из четырёх команд плюс формат цитирования для результатов проверки.
Что доказывает каждый уровень — ключевое различие в этом проекте (LIMITS.md §1): цепочка, которую вы храните сами, доказывает, что записи не были отредактированы, относительно головы, которая уже есть у кого-то; только контрольные точки, хранящиеся вне оператора, доказывают, что ни одна не была удалена; и никакой хеш не доказывает, что каждое действие было зафиксировано.
| Утверждение | Собственная цепочка | + Внешние контрольные точки | + Доверенная фиксация |
|---|---|---|---|
| Обнаружение правок в установленном артефакте | ✔ | ✔ | ✔ |
| Обнаружение перезаписи зафиксированной истории | — | ✔ | ✔ |
| Обнаружение отсутствующих/запоздалых контрольных точек | — | ✔ (согласованная периодичность) | ✔ |
| Доказательство того, что каждое действие было записано | — | — | зависит от границы фиксации |
Посмотрите пример перед установкой: образец Runtime Report — вымышленные данные, настоящая цепочка, и его скрипт пересчитывает хеш-цепочку встроенных записей в вашем браузере при открытии.
Демонстрация за 60 секунд
Агент не требуется. С uv ничего устанавливать не нужно:
uvx --from halo-record halo demo --serve
или классическим способом:
pip install halo-record
halo demo --serve
Любой из них создаёт вымышленного поставщика агентов поддержки с двумя клиентами, фиксирует цепочки (при этом локальный файл-свидетель заменяет одного внешнего участника — см. LIMITS.md §1), выдаёт их защищённые Runtime Reports и открывает консоль оператора в вашем браузере. Затем попробуйте тест на подмену: удалите строку из одного из файлов .jsonl и перезагрузите. Отчёт это обнаружит.
Запишите собственного агента
Одна строка на границе:
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
Удобная обёртка from halo import ... также поставляется — но имя halo на PyPI принадлежит несвязанному пакету терминального спиннера, и если этот пакет установлен, он выигрывает импорт. halo_record однозначен, поэтому в примерах используется он.
Без log= записи попадают в ~/.halo/my-agent.jsonl (одна цепочка на агента). Обёртка фиксирует границу запуска; доказательства хранятся в записях отдельных вызовов. Захватывайте их с помощью адаптера фреймворка (матрица ниже) — или явно, что также показывает, как связывается делегирование:
from halo_record import Recorder, record_call
rec = Recorder("audit.jsonl")
with record_call(rec, "crm.lookup", {"account": "acct-9"}) as call: # one sealed record per tool call
call.result = crm.lookup("acct-9")