Struct ToolArtifact 

pub struct ToolArtifact {
    pub path: String,
    pub uri: String,
    pub filename: String,
    pub title: String,
    pub mime: String,
    pub size: u64,
}

Structured metadata for a tool that produced a file artifact (e.g. deliver_file). Carried on TurnEvent::ToolResult so a channel attaches the file from typed fields instead of parsing a text trailer out of the free-form output string. Trailer parsing let a crafted filename forge the delivered path (arbitrary-file-read / confused-deputy class).

Fields

path: String

Absolute path of the delivered file on the agent host.

uri: String

Stable citation URI the client can reference (e.g. attachment://…).

filename: String

Original filename.

title: String

Human-readable chat label; defaults to the filename.

mime: String

MIME type.

size: u64

Size in bytes.

Implementations

impl ToolArtifact

pub fn from_delivered_data(data: &Value) -> Option<Self>

Build from a tool’s structured output_data when it declares a delivered file (delivered: true with a non-empty path). Returns None for any other structured output, keeping this a channel-neutral convention rather than a hook tied to one tool name.

Trait Implementations

impl Clone for ToolArtifact

fn clone(&self) -> ToolArtifact

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolArtifact

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

Formats the value using the given formatter.

impl PartialEq for ToolArtifact

fn eq(&self, other: &ToolArtifact) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ToolArtifact