Struct LoggingHook 

pub struct LoggingHook { /* private fields */ }

A hook that logs all lifecycle events for debugging.

Example

use lc_agents::hooks::LoggingHook;

let hook = LoggingHook::new();
let executor = AgentExecutor::new(agent, tools).hook(hook);

Implementations

impl LoggingHook

pub fn new() -> Self

Creates a new LoggingHook.

pub fn with_tokens() -> Self

Creates a LoggingHook that also logs stream tokens.

pub fn with_log_tokens(self, log: bool) -> Self

Sets whether to log stream tokens.

Trait Implementations

impl AgentHook for LoggingHook

fn on_before_completion(&self, ctx: &mut CompletionContext) -> CompletionAction

Called before an LLM completion. Can modify messages or reject the call.

fn on_after_completion( &self, ctx: &mut CompletionResult, ) -> Result<(), HookError>

Called after an LLM completion. Can modify the response.

fn on_before_tool_call(&self, ctx: &mut ToolCallContext) -> ToolCallAction

Called before a tool call. Can approve, reject, modify, or skip.

fn on_after_tool_call( &self, ctx: &mut ToolResultContext, ) -> Result<(), HookError>

Called after a tool call. Can modify the result.

fn on_stream_chunk(&self, chunk: &str) -> StreamAction

Called for each streaming token. Can filter, replace, or forward.

fn on_agent_start(&self, input: &str) -> Result<(), HookError>

Called when the agent starts execution.

fn on_agent_end(&self, output: &str) -> Result<(), HookError>

Called when the agent finishes execution.

fn on_error(&self, error: &HookError) -> ErrorAction

Called when an error occurs. Can retry, ignore, or propagate.

impl Default for LoggingHook

fn default() -> Self

Returns the “default value” for a type.