Struct GraphBuilder 

pub struct GraphBuilder { /* private fields */ }

Accumulates nodes and edges, then freezes them into a Graph.

Every node-adding method takes a per-kind spec and returns self, so a whole document reads as one chain ending in build. The builder stamps SCHEMA_VERSION onto the document, so an author never writes the version by hand.

Implementations

impl GraphBuilder

pub fn new() -> Self

Starts an empty builder.

pub fn agent(self, spec: AgentSpec) -> Self

Adds an agent node from its AgentSpec.

pub fn tool(self, spec: ToolSpec) -> Self

Adds a tool node from its ToolSpec.

pub fn gate(self, spec: GateSpec) -> Self

Adds a gate node from its GateSpec.

pub fn branch(self, spec: BranchSpec) -> Self

Adds a branch node from its BranchSpec.

pub fn map(self, spec: MapSpec) -> Self

Adds a map node from its MapSpec.

pub fn fold(self, spec: FoldSpec) -> Self

Adds a fold node from its FoldSpec.

pub fn edge(self, from: impl Into<String>, to: impl Into<String>) -> Self

Adds a plain edge from one node id to another.

pub fn labeled_edge( self, from: impl Into<String>, to: impl Into<String>, label: impl Into<String>, ) -> Self

Adds a labeled edge. The label names the BranchCase this edge realizes when the source is a branch.

pub fn build(self) -> Graph

Freezes the accumulated nodes and edges into a Graph, stamping the current SCHEMA_VERSION.

Structure only: run [crate::validate] on the result to check the semantic rules (hash shape, referential integrity, acyclicity, and the rest).

Trait Implementations

impl Clone for GraphBuilder

fn clone(&self) -> GraphBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GraphBuilder

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

Formats the value using the given formatter.

impl Default for GraphBuilder

fn default() -> GraphBuilder

Returns the “default value” for a type.