Struct AgentTurnGuard 

pub struct AgentTurnGuard<'a> { /* private fields */ }

Drop-safe lifecycle bracket for one logical agent turn.

Construction emits exactly one ObserverEvent::AgentStart. Calling finish, or dropping the guard during an error or panic, emits exactly one matching ObserverEvent::AgentEnd. Entry points that invoke the tool loop directly should use this guard instead of open-coding lifecycle events so in-flight observers cannot be left unbalanced.

Implementations

impl<'a> AgentTurnGuard<'a>

pub fn start( observer: &'a dyn Observer, model_provider: impl Into<String>, model: impl Into<String>, channel: Option<String>, agent_alias: Option<String>, turn_id: Option<String>, ) -> Self

Open a lifecycle bracket and emit its start event.

pub fn set_model_route( &mut self, model_provider: impl Into<String>, model: impl Into<String>, )

Attribute the closing event to the model route actually used.

pub fn set_usage( &mut self, tokens_used: Option<TurnTokenUsage>, cost_usd: Option<f64>, )

Attach aggregate usage to the closing event.

pub fn finish(&mut self)

Emit the matching end event once. Later calls and Drop are no-ops.

Trait Implementations

impl Drop for AgentTurnGuard<'_>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.