Skip to main content

AgentEvent

Enum AgentEvent

pub enum AgentEvent {
    GenerationStarted {
        context: TraceContext,
    },
    GenerationFinished {
        context: TraceContext,
    },
    GenerationCommitted {
        context: TraceContext,
    },
    Failure {
        failure: GenerationFailure,
        attempt: u32,
        max_attempts: u32,
        retry_in: Option<Duration>,
        recovery_remaining: Option<Duration>,
        context: TraceContext,
    },
    TextDelta {
        text: String,
        context: TraceContext,
    },
    ThinkingDelta {
        text: String,
        context: TraceContext,
    },
    ToolStarted {
        call_id: Uuid,
        tool_use: ToolUse,
        background: CancelToken,
        context: TraceContext,
    },
    ToolFinished {
        call_id: Uuid,
        tool_use: ToolUse,
        result: ToolResult,
        context: TraceContext,
    },
    TurnFinished {
        context: TraceContext,
    },
}

Expand description

Live events emitted by the agent runtime.

All ongoing work is attributed via TraceContext::agent_id.

Variants§

GenerationStarted

Begin a provisional response. A retry replaces the failed attempt’s draft.

Fields

§context: TraceContext

GenerationFinished

The complete response validated. Its tool calls have not executed yet.

Fields

§context: TraceContext

GenerationCommitted

A validated response was installed in history and its configured checkpoint succeeded. Its tool calls have not executed yet. Emitted only when a checkpoint callback is installed, including when a later checkpoint repairs an earlier save failure.

Fields

§context: TraceContext

Failure

Fields

§failure: GenerationFailure

§attempt: u32

§max_attempts: u32

§retry_in: Option<Duration>

§recovery_remaining: Option<Duration>

Remaining elapsed recovery budget, if configured and recovery started.

§context: TraceContext

TextDelta

Incremental assistant text (for streaming UX).

Fields

§text: String

§context: TraceContext

ThinkingDelta

Incremental thinking summary text (streamed for UI; also stored in history).

Fields

§text: String

§context: TraceContext

ToolStarted

Fields

§call_id: Uuid

§tool_use: ToolUse

§background: CancelToken

§context: TraceContext

ToolFinished

Fields

§call_id: Uuid

§tool_use: ToolUse

§result: ToolResult

§context: TraceContext

TurnFinished

Fields

§context: TraceContext

Trait Implementations§

impl Clone for AgentEvent

fn clone(&self) -> AgentEvent

Returns a duplicate of the value. Read more

1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

impl Debug for AgentEvent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations§

impl Freeze for AgentEvent

impl RefUnwindSafe for AgentEvent

impl Send for AgentEvent

impl Sync for AgentEvent

impl Unpin for AgentEvent

impl UnsafeUnpin for AgentEvent

impl UnwindSafe for AgentEvent

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

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

Performs copy-assignment from self to dest. Read more

impl<T> DynClone for T
where T: Clone,

fn __clone_box(&self, _: Private) -> *mut ()

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> PolicyExt for T
where T: ?Sized,

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more