Справочник хуков

🔵 Хуки перехватывают жизненный цикл агента. Это YAML-файлы в config/agents/<agent>/hooks/, подключаются через hook_files: (или по имени в hooks:). Поле kind: выбирает хук. Ниже — сводная таблица всех хуков со ссылками на разделы.

Виды хуков

kind	Назначение	Раздел
`faq_cache`	кэш (вопрос → ответ) в DuckDB; отдавать повторы, пропуская LLM	Контекст и память
`inject`	декларативно впрыскивать системные/пользовательские сообщения	Контекст и память
`escalate`	эскалация на человека, когда агент не может помочь	Маршрутизация и надёжность
`memory`	долговременная память на пользователя (факты + сводка)	Контекст и память
`rag`	ретривал из архива: впрыскивает релевантные чанки в контекст (BM25, без эмбеддингов)	Контекст и память
`tool_cache`	кэш результатов read-only инструментов по `(scope, tool, args)`; short-circuit повторов	Контекст и память
`link_check`	output-guardrail: проверяет ссылки финального ответа на заземлённость (по архиву) и структурную безопасность; opt-in `live` HTTP	Безопасность и качество
`condense`	конденсация follow-up'ов в самостоятельный запрос по истории; полный аудит	Контекст и память
`compact_results`	сжатие длинных выводов инструментов (head/tail + сохранение ссылок)	Контекст и память
`context_summary`	LLM-суммаризация вытесненной истории в контекстном окне (заменяет грубую склейку)	Контекст и память
`format_guard`	детерминированное оформление ответа: bare URL → ссылки, дедуп, по строке на ссылку	Безопасность и качество
`schema_guard`	валидация ответа или аргументов тула по JSON Schema; `notice` / `rework` / `deny`	Безопасность и качество
`language_guard`	язык ответа: захват языка пользователя, опц. директива, `notice`/`rework` при расхождении	Безопасность и качество
`guard`	DLP-мембрана без состояния: детект сущностей (email/тел/карты/ИНН/СНИЛС/ключи…) и действие — `redact`/`deny`/`suppress`/`notice`/`rework` на входе, выходе и границах тулов	Безопасность и качество
`pseudonymize`	реверсивная псевдонимизация: суррогаты `[EMAIL_1]` в модель, локальный DuckDB-vault, детокенизация ответа/аргументов тулов	Безопасность и качество
`loop_guard`	разрыв зацикливания вызовов инструментов: `deny` повтора сверх порога	Маршрутизация и надёжность
`groundedness`	output-guardrail: проверяет утверждения финального ответа на подтверждение RAG-архивом; `notice`/`rework`	Безопасность и качество
`circuit_breaker`	конфиг нативного circuit breaker провайдеров (per-agent): пропускать упавший провайдер, уходя на failover	Маршрутизация и надёжность
`model_router`	классификаторная маршрутизация модели (ONNX/LLM/hybrid): выбрать `model_config` на сообщение	Маршрутизация и надёжность
`intent_router`	классификаторный триаж: `reply`/`inject`/`notice`/`escalate` по намерению	Маршрутизация и надёжность
`lexicon`	самообучающийся нормализатор запроса: слоты + gap + golden-gated автообучение (паки YAML + оверлей DuckDB)	Контекст и память
`llm_cache`	нативный кэш инференса: повтор точного промпта отдаётся из DuckDB без провайдера (turn loop, `llm(...)`, `ask`-судьи)	Маршрутизация и надёжность
`script_hook`	скриптовый хук на Rhai/JavaScript (см. `07-scripts`)	Расширение
`agent_events`	нативный журнал действий агента: пишет событие на выбранных точках жизненного цикла; маршрут `GET /v1/events` отдаёт его наружу с long-poll и cursor drain	Расширение
`dll_hook`	хук из нативного Rust DLL (C ABI, см. `20-native-plugins`)	Расширение

Разделы

Основы — точки жизненного цикла, композиция, HookContext, локальное тестирование.
Контекст и память — faq_cache, inject, memory, rag, tool_cache, condense, compact_results, context_summary, lexicon.
Безопасность и качество — guard, pseudonymize, link_check, groundedness, language_guard, format_guard, schema_guard.
Маршрутизация и надёжность — escalate, loop_guard, circuit_breaker, model_router, intent_router, llm_cache.
Расширение — script_hook, dll_hook, нативный agent_events (журнал действий агента).