Struct Handle 

pub struct Handle {
    pub id: HandleId,
    pub kind: HandleKind,
    pub residency: Residency,
    pub tokens: u32,
    pub source: Option<CompactString>,
}

One addressable resource the agent holds.

Fields

id: HandleId

kind: HandleKind

residency: Residency

tokens: u32

Token cost of the resident form (used by the eviction planner).

source: Option<CompactString>

Link back to the source object in working context — for HandleKind::ToolResult this is the tool call_id, letting the renderer project a handle’s residency onto its message (read-time projection) without mutating the stored message. None for handles with no in-context anchor.

Implementations

impl Handle

pub fn resident(id: HandleId, kind: HandleKind, tokens: u32) -> Self

pub fn resident_for( id: HandleId, kind: HandleKind, tokens: u32, source: impl Into<CompactString>, ) -> Self

A resident handle anchored to a source object (e.g. a tool call_id).

Trait Implementations

impl Clone for Handle

fn clone(&self) -> Handle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Handle

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Handle

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Handle

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

where __S: Serializer,

Serialize this value into the given Serde serializer.