Struct SpawnPolicy 

pub struct SpawnPolicy { /* private fields */ }

Per-dispatch spawn confinement policy handed to tools via crate::Context::spawn.

runner: None = inert policy: Self::command returns a plain command (the dispatcher counts and warns the degradation).

Implementations

impl SpawnPolicy

pub fn disabled() -> Self

Inert policy — commands run unconfined.

pub const fn from_runner(runner: Option<PathBuf>, allow_net: bool) -> Self

Build from a resolved runner path and network grant.

pub fn detected(allow_net: bool) -> Self

Detect a runner and build a policy with an explicit net grant.

pub fn for_effects(effects: &EffectRow) -> Self

Detect a runner and derive the net grant from the effect row.

pub const fn is_active(&self) -> bool

Whether a runner is attached.

pub fn runner(&self) -> Option<&Path>

The attached runner path, if any.

pub const fn allow_net(&self) -> bool

Whether the spawned command may use the network.

pub fn envelope(&self, program: &str, args: &[&str]) -> Value

Build the envelope the OS runner interprets.

pub fn envelope_json(&self, program: &str, args: &[&str]) -> String

Serialized envelope (what actually lands on the runner’s argv).

pub fn command(&self, program: &str, args: &[&str]) -> Command

Build a command honoring the policy.

Active runner → runner --exec '<envelope>'; inactive → plain program args.... Callers must use this for every external spawn when the tool declares Sandbox::Subprocess.

Trait Implementations

impl Clone for SpawnPolicy

fn clone(&self) -> SpawnPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpawnPolicy

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

Formats the value using the given formatter.

impl Default for SpawnPolicy

fn default() -> SpawnPolicy

Returns the “default value” for a type.