Struct LlmHandle 

pub struct LlmHandle {
    pub uuid: Uuid,
    pub started_at: DateTime<Utc>,
    pub name: String,
    pub data: Option<Json>,
    pub metadata: Option<Json>,
    pub attributes: LlmAttributes,
    pub parent_uuid: Option<Uuid>,
    pub model_name: Option<String>,
    pub optimization_recorder: LlmOptimizationRecorder,
    /* private fields */
}

Runtime-owned handle identifying an active or completed LLM call.

Fields

uuid: Uuid

Unique LLM-call identifier.

started_at: DateTime<Utc>

Timestamp captured when the LLM handle was created.

name: String

Provider or logical call name recorded on lifecycle events.

Gateway-managed provider calls use provider route names such as anthropic.messages; event normalization may reuse those route names as codec hints when raw request shapes overlap across providers.

data: Option<Json>

Optional application payload stored on the handle.

metadata: Option<Json>

Optional metadata attached to the LLM span.

attributes: LlmAttributes

LLM behavior flags.

parent_uuid: Option<Uuid>

UUID of the parent scope, if any.

model_name: Option<String>

Optional normalized model name for observability.

optimization_recorder: LlmOptimizationRecorder

Bounded, in-memory optimization evidence recorder for this call.

Implementations

impl LlmHandle

pub fn builder() -> LlmHandleBuilder<((), (), (), (), (), (), (), (), ())>

Create a builder for building LlmHandle. On the builder, call .uuid(...)(optional), .started_at(...)(optional), .name(...), .data(...)(optional), .metadata(...)(optional), .attributes(...)(optional), .parent_uuid(...)(optional), .model_name(...)(optional), .optimization_recorder(...)(optional) to set the values of the fields. Finally, call .build() to create the instance of LlmHandle.

Trait Implementations

impl Clone for LlmHandle

fn clone(&self) -> LlmHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LlmHandle

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LlmHandle

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LlmHandle

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.