hooks

Rust AI Agent SDK Hooks Module for PraisonAI Rust SDK. Provides a powerful hook system for intercepting and modifying agent behavior at various lifecycle points. Unlike callbacks (which are for UI events), hooks can intercept, modify, or block tool execution.

Features

Event-based hook system (BeforeTool, AfterTool, BeforeAgent, etc.)
Function hooks for in-process customization
Matcher patterns for selective hook execution
Decision outcomes (allow, deny, block)

Usage

use praisonai::hooks::{HookRegistry, HookEvent, HookResult};

let mut registry = HookRegistry::new();

registry.add_hook(HookEvent::BeforeTool, |input| {
if input.tool_name == Some("dangerous_tool".to_string()) {
return HookResult::deny("Tool blocked by policy");
}
HookResult::allow()
});

let agent = Agent::new()
.hooks(registry)
.build()?;

Import

use praisonai::hooks::*;

Classes

HookInput

Input data for hooks

HookResult

Result from a hook execution

HookDefinition

Hook definition

HookRegistry

Hook registry for managing hooks

HookRunner

Hook runner for executing hooks in a workflow

HookEvent

Event names for the hook system

HookDecision

Decision types for hook outputs

Rust Hooks

Rust Events

Rust Callbacks

handoff • Rust AI Agent SDK

knowledge • Rust AI Agent SDK

​hooks

​Features

​Usage

​Import

​Classes