Struct LoggingPlugin 

pub struct LoggingPlugin;

Plugin that logs agent and tool lifecycle events.

When the tracing-support feature is enabled, uses tracing macros for structured logging. Without the feature, all hooks are silent no-ops.

Implementations

impl LoggingPlugin

pub fn new() -> Self

Create a new logging plugin.

Trait Implementations

impl Default for LoggingPlugin

fn default() -> Self

Returns the “default value” for a type.

impl Plugin for LoggingPlugin

fn name(&self) -> &str

Plugin name for logging/debugging.

fn before_agent<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 InvocationContext, ) -> Pin<Box<dyn Future<Output = PluginResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Called before an agent starts execution.

fn after_agent<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 InvocationContext, ) -> Pin<Box<dyn Future<Output = PluginResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Called after an agent completes execution.

fn before_tool<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, call: &'life1 FunctionCall, _ctx: &'life2 InvocationContext, ) -> Pin<Box<dyn Future<Output = PluginResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Called before a tool is executed. Return Deny to prevent execution.

fn after_tool<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, call: &'life1 FunctionCall, _result: &'life2 Value, _ctx: &'life3 InvocationContext, ) -> Pin<Box<dyn Future<Output = PluginResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Called after a tool completes. Can transform or deny the result.

fn on_event<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, event: &'life1 Event, _ctx: &'life2 InvocationContext, ) -> Pin<Box<dyn Future<Output = PluginResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Called when an event is emitted.

fn on_user_message<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _message: &'life1 str, _ctx: &'life2 InvocationContext, ) -> Pin<Box<dyn Future<Output = PluginResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Called when a user message is received.

fn before_run<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 InvocationContext, ) -> Pin<Box<dyn Future<Output = PluginResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Called before a run starts (before the agent loop).

fn after_run<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 InvocationContext, ) -> Pin<Box<dyn Future<Output = PluginResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Called after a run completes (after the agent loop).

fn before_model<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _request: &'life1 LlmRequest, _ctx: &'life2 InvocationContext, ) -> Pin<Box<dyn Future<Output = PluginResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Called before a model generation request.

fn after_model<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _response: &'life1 LlmResponse, _ctx: &'life2 InvocationContext, ) -> Pin<Box<dyn Future<Output = PluginResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Called after a model generation response.

fn on_model_error<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _error: &'life1 str, _ctx: &'life2 InvocationContext, ) -> Pin<Box<dyn Future<Output = PluginResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Called when a model generation fails.

fn on_tool_error<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, _call: &'life1 FunctionCall, _error: &'life2 str, _ctx: &'life3 InvocationContext, ) -> Pin<Box<dyn Future<Output = PluginResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Called when a tool execution fails.