# Owlen Hooks

Plugin hook system for the Owlen AI agent.

## Overview
This crate enables extending the agent's behavior through a flexible hook system. It allows various parts of the application to emit events that plugins can intercept and respond to.

## Features
- **Lifecycle Hooks:** Register callbacks for key agent events (session start, tool execution, response generated).
- **Synchronous & Asynchronous:** Supports both immediate and future-based hook handlers.
- **Priority-Based Execution:** Fine-grained control over the order in which hooks are processed.

## Common Hooks
- `on_session_start`: Setup tasks when a new conversation begins.
- `before_tool_execution`: Validate or modify tool arguments before they run.
- `after_tool_execution`: Process or log tool results.
- `on_message_received`: Intercept incoming user messages.