Struct GraphRunner 

pub struct GraphRunner { /* private fields */ }

Runs a graph spec in a Python subprocess rooted at the project.

Implementations

impl GraphRunner

pub fn new(project_dir: impl Into<PathBuf>) -> Self

A runner for project_dir, using $SOMA_PYTHON when set.

The interpreter matters: it must be one that can import soma and import the project’s own modules. Defaulting to python3 is right far more often than guessing, and when it is wrong the error says which interpreter could not find soma.

pub fn run(&self, spec: &Value) -> Result<Value, String>

Run spec, returning the driver’s JSON payload.

Err is for the subprocess itself going wrong — no interpreter, a crash, no answer written. A graph that failed to build or to run comes back as Ok with "ok": false, because that is a result the model can act on rather than an infrastructure problem.