Struct DeclaredExport 

pub struct DeclaredExport {
    pub declared_root: String,
    pub root: PathBuf,
    pub mode: ExportMode,
    pub max_bytes: u64,
}

One exports.files block, with its root already resolved against the session’s accessible workdir.

The root is joined, not canonicalised, at construction: exports.files.root is not required to exist when the capsule launches, because the agent may create it during a task. Every request canonicalises it afresh, which is also what lets a list answer 200 with no entries before the agent has written anything.

Fields

declared_root: String

exports.files.root verbatim, as the operator wrote it (out/). Echoed in every response and every trace line; never used to touch the filesystem.

root: PathBuf

accessible_workdir.join(declared_root).

mode: ExportMode

max_bytes: u64

Per-file read ceiling. A file above it is still listed, with its real size — discovery must not lie about what is there — and refused on read.

Implementations

impl DeclaredExport

pub fn resolve(accessible_workdir: &Path, export: &FileExport) -> Self

Resolves a manifest’s exports.files block against the session’s accessible workdir — the directory the agent’s own tools see at ., and therefore the one out/result.txt means. Not StagedSession::workdir, which is the internal .murmur/<session_id> bookkeeping directory when --workdir is given, and holds trace.jsonl.

pub fn for_peer_files( accessible_workdir: &Path, export: &PeerFilesExport, ) -> Self

Self::resolve for the peer plane’s separate subtree.

The same type because it is the same resolution: exports.peer_files opens a different root under a different authoriser, but a path beneath it is decided by exactly the rules that decide one beneath exports.files. mode is ExportMode::ReadOnly because there is no other kind of peer export and none is declarable — a redeem serves bytes and nothing else.

Trait Implementations

impl Clone for DeclaredExport

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeclaredExport

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

Formats the value using the given formatter.

impl Eq for DeclaredExport

impl PartialEq for DeclaredExport

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DeclaredExport