Struct FileRead 

pub struct FileRead;

Capability that reads the contents of a file.

Opens file with O_NOFOLLOW to prevent TOCTOU symlink escape, uses bounded reader regardless of metadata to prevent size bypass, detects binary content, and handles UTF-8 boundary splits.

Trait Implementations

impl Capability for FileRead

fn name(&self) -> &'static str

Returns the capability name (e.g., "FileRead", "FileWrite").

fn description(&self) -> &'static str

Returns a one-line human-readable description of what this capability does.

fn schema(&self) -> Value

Returns the JSON Schema for the capability’s arguments.

fn validate(&self, args: &Value) -> Result<()>

Validates the arguments against the schema.

fn execute(&self, args: &Value, _ctx: &Context) -> Result<Output>

Executes the capability with the given arguments and context.