Struct Spec 

pub struct Spec {
    pub name: String,
    pub description: String,
    pub model: ModelRef,
    pub data_policy: DataPolicy,
    pub read_roots: Vec<PathBuf>,
    pub nodes: NodeGraph,
    pub branches: Branches,
}

A parsed spec.

Fields

name: String

Job name, used to submit against it.

description: String

Trigger conditions for a calling agent — when to use this, never how it works. A description that summarises the workflow invites an agent to act on the summary instead of reading the real contract.

model: ModelRef

Which model serves this job’s inference.

data_policy: DataPolicy

Data-handling policy; see DataPolicy.

read_roots: Vec<PathBuf>

Directories this job may read beneath. Empty means none.

nodes: NodeGraph

The proc-blocks implementing the job, as a graph of nodes.

Each node’s declared input is typechecked against the nodes feeding it before anything runs. block = "..."; is sugar for a one-node graph — see crate::graph::NodeGraph::single.

branches: Branches

Conditional dispatch: which branch target fires for each labeled route a branching node produces. Empty when the spec has none.

Implementations

impl Spec

pub fn validate_host_read_paths(&self) -> Result<(), SpecError>

Refuse a spec whose host-read paths sit outside its granted roots.

Fan-out manifests and acceptance schemas are read by the host, which is not sandboxed — so nothing would otherwise stop either reading a path the spec never granted. Requiring them inside a declared Read root keeps the capability list a truthful description of everything the job touches, which is the property the whole capability model rests on.

Call this after resolving read_roots, over and schema paths against the spec’s directory, so both sides are absolute and canonical. Comparing them as written cannot work: a spec that grants an absolute root and names a relative manifest is entirely ordinary, and lexically a relative path never starts with an absolute one.

Trait Implementations

impl Clone for Spec

fn clone(&self) -> Spec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Spec

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

Formats the value using the given formatter.

impl PartialEq for Spec

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Spec