Struct ToolInvocation 

pub struct ToolInvocation { /* private fields */ }

Record of a single tool call made by an agent during a Run.

One ToolInvocation per tool call. The chronological sequence of ToolInvocations within a Run forms the agent’s action log. See module documentation for lifecycle position and Libra calling guidance.

Implementations

impl ToolInvocation

pub fn new( created_by: ActorRef, run_id: Uuid, tool_name: impl Into<String>, ) -> Result<Self, String>

Create a new tool invocation record for one run-local tool call.

pub fn header(&self) -> &Header

Return the immutable header for this tool invocation.

pub fn run_id(&self) -> Uuid

Return the owning run id.

pub fn tool_name(&self) -> &str

Return the registered tool name.

pub fn io_footprint(&self) -> Option<&IoFootprint>

Return the file I/O footprint, if captured.

pub fn args(&self) -> &Value

Return the raw JSON arguments passed to the tool.

pub fn status(&self) -> &ToolStatus

Return the tool execution status.

pub fn result_summary(&self) -> Option<&str>

Return the short human-readable output summary, if present.

pub fn artifacts(&self) -> &[ArtifactRef]

Return artifact references produced by the tool call.

pub fn set_io_footprint(&mut self, io_footprint: Option<IoFootprint>)

Set or clear the file I/O footprint.

pub fn set_args(&mut self, args: Value)

Replace the raw JSON arguments.

pub fn set_status(&mut self, status: ToolStatus)

Set the tool execution status.

pub fn set_result_summary(&mut self, result_summary: Option<String>)

Set or clear the short human-readable output summary.

pub fn add_artifact(&mut self, artifact: ArtifactRef)

Append one persistent artifact reference.

Trait Implementations

impl Clone for ToolInvocation

fn clone(&self) -> ToolInvocation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolInvocation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolInvocation

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ToolInvocation

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

Formats the value using the given formatter.

impl ObjectTrait for ToolInvocation

fn from_bytes(data: &[u8], _hash: ObjectHash) -> Result<Self, GitError>

where Self: Sized,

Creates a new object from a byte slice.

fn get_type(&self) -> ObjectType

Returns the type of the object.

fn get_size(&self) -> usize

fn to_data(&self) -> Result<Vec<u8>, GitError>

fn from_buf_read<R: BufRead>(read: &mut ReadBoxed<R>, size: usize) -> Self

where Self: Sized,

Generate a new Object from a ReadBoxed<BufRead>. the input size,is only for new a vec with directive space allocation the input data stream and output object should be plain base object .

fn object_hash(&self) -> Result<ObjectHash, GitError>

impl Serialize for ToolInvocation

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

where __S: Serializer,

Serialize this value into the given Serde serializer.