Struct File 

pub struct File {
    pub id: String,
    pub name: String,
    pub format: Option<String>,
    pub mime_type: Option<String>,
    pub bytes: u64,
    pub created_at: u64,
    pub source: FileSource,
    pub content: FileContent,
}

A file produced by an agentic run.

Fields

id: String

file_<run>_r<round>_<idx>.

name: String

format: Option<String>

csv, json, png, parquet, etc. Inferred from the filename extension if not set.

mime_type: Option<String>

bytes: u64

created_at: u64

Unix epoch seconds.

source: FileSource

content: FileContent

Implementations

impl File

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

Full text body if present.

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

Preview, falling back to the full text.

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

Base64 body if present.

pub fn is_truncated(&self) -> bool

True when this File is the elided wire form (body stripped, bytes > 0).

pub fn elide_for_wire(&self) -> File

Clone with the body dropped if it exceeds WIRE_EMBED_LIMIT_BYTES. Use before sending over the wire; the full body should already be in the FileStore.

pub fn is_text(&self) -> bool

pub fn is_binary(&self) -> bool

pub fn is_error(&self) -> bool

pub fn is_image(&self) -> bool

pub fn is_video(&self) -> bool

pub fn save<P: AsRef<Path>>(&self, path: P) -> Result<()>

Write the file to path. Errors if the body was elided or the file is an error placeholder.

Trait Implementations

impl Clone for File

fn clone(&self) -> File

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for File

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for File

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for File

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

where __S: Serializer,

Serialize this value into the given Serde serializer.