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 TypedCapability for FileRead

type Args = FileReadArgs

The typed arguments struct for this capability.

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

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

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

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

fn schema(&self) -> Value

Returns the JSON Schema for the capability’s arguments.

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

Executes the capability with typed arguments.

fn dry_run( &self, args: Self::Args, ctx: &Context, ) -> Result<Output, CapabilityError>

Dry-run execution — same as execute but the capability should skip side effects.