🪝 Subsystem Deep Dive

utils/hooks/

📁 utils/hooks/ 📄 7 files

Tutorial: hooks

This project implements a robust event-driven hook system for an AI agent, allowing it to react to lifecycle events such as file changes, tool usage, or session starts. It orchestrates a central registry of configuration rules that trigger various execution strategies (like running shell commands, HTTP requests, or sub-agents), while maintaining security through network validation and managing temporary session-scoped logic.

flowchart TD A0["Hook Configuration & Metadata"] A1["Execution Strategies"] A2["Session-Scoped Lifecycle"] A3["Asynchronous Registry & Event Bus"] A4["Environment Watchers"] A5["Security & SSRF Protection"] A0 -->|"Aggregates ephemeral hooks"| A2 A4 -->|"Reads watch patterns"| A0 A1 -->|"Validates network targets"| A5 A1 -->|"Reads allowlists"| A0 A1 -->|"Cleans up session state"| A2 A3 -->|"Refreshes session config"| A0