> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Hook Runner • AI Agent SDK
> HookRunner: Executes hooks from a registry.
# HookRunner
> Defined in the [**runner**](../modules/runner) module.
AI Agent
Executes hooks from a registry.
Supports:
* Python function hooks (sync and async)
* Shell command hooks
* Sequential and parallel execution
* Timeout handling
* Result aggregation
```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#8B0000', 'primaryTextColor': '#fff', 'primaryBorderColor': '#710101', 'lineColor': '#189AB4', 'secondaryColor': '#189AB4', 'tertiaryColor': '#fff' }}}%%
graph TD
event["Event Trigger"] --> hook["Hook: HookRunner"]
hook --> decision{"Decision"}
decision -- "Allow" --> proc["Process"]
decision -- "Deny" --> block["Block"]
style hook fill:#189AB4,color:#fff
style event fill:#8B0000,color:#fff
style proc fill:#8B0000,color:#fff
style block fill:#8B0000,color:#fff
```
## Constructor
No description available.
No description available.
No description available.
## Methods
Get the hook registry.
Execute all hooks for an event.
Synchronous version of execute.
Check if any hook blocked execution.
Get the reason for blocking from results.
Aggregate additional context from all results.
## Usage
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
registry = HookRegistry()
runner = HookRunner(registry)
# Execute hooks for an event
results = await runner.execute(
event=HookEvent.BEFORE_TOOL,
input_data=BeforeToolInput(
tool_name="write_file",
tool_input={"path": "/tmp/test.txt"}
)
)
# Check if any hook blocked
if runner.is_blocked(results):
print("Tool execution blocked by hook")
```
## Source
`praisonaiagents/hooks/runner.py` at line 30
***
## Related Documentation