Struct GraphBuilder 

pub struct GraphBuilder<'r> { /* private fields */ }

Graph builder with alias and basic port validation using the registry.

Implementations

impl<'r> GraphBuilder<'r>

pub fn new(registry: &'r Registry) -> Self

pub fn graph_metadata( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Attach string graph-level metadata to the built graph (Graph.metadata).

For typed graph metadata visible to nodes at runtime, prefer graph_metadata_value.

pub fn graph_metadata_value(self, key: impl Into<String>, value: Value) -> Self

Attach graph-level metadata (typed Value) to the built graph (Graph.metadata_values).

Nodes can read this via ExecutionContext.graph_metadata at runtime.

pub fn inject_node_metadata(self, key: impl Into<String>, value: Value) -> Self

Inject a key/value into every node’s metadata, without overwriting existing keys.

This is the ergonomic way to “broadcast” host-provided metadata to all nodes so it shows up in each node’s ExecutionContext.metadata at runtime.

pub fn inject_node_metadata_overwrite( self, key: impl Into<String>, value: Value, ) -> Self

Inject a key/value into every node’s metadata, overwriting existing keys.

pub fn node_spec(self, spec: NodeSpec, alias: &str) -> Self

Add a node via a pre-built spec (useful with plugin helpers).

pub fn node_pair<T>(self, pair: T, alias: &str) -> Self

where T: Into<NodeSpec>,

Add a node from an id/version pair (e.g., produced by a plugin helper).

pub fn node_handle_like(self, handle: &dyn NodeHandleLike) -> Self

Add a node using any handle that exposes id/alias.

pub fn node<H>(self, handle: H) -> Self

where H: NodeHandleLike,

Add a node using a typed handle (preferred).

pub fn node_from_id(self, id: &str, alias: &str) -> Self

Add a node by id.

pub fn node_id(self, id: &str, alias: &str) -> Self

Add a node using its descriptor default compute affinity (or override via node_with_compute).

pub fn node_with_compute( self, id: &str, alias: &str, compute: ComputeAffinity, ) -> Self

Add a node with an explicit compute affinity override.

pub fn sync_groups(self, groups: Vec<SyncGroup>) -> Self

Attach sync groups metadata to the most recently added node.

pub fn node_metadata( self, handle: &impl NodeHandleLike, key: impl Into<String>, value: Value, ) -> Self

Attach or override metadata for a node handle. Values can store arbitrary UI hints (e.g. positions, styles) without changing core types.

pub fn node_metadata_by_id( self, node_alias: impl Into<String>, key: impl Into<String>, value: Value, ) -> Self

Attach or override metadata for a node alias. Values can store arbitrary UI hints (e.g. positions, styles) without changing core types.

pub fn node_metadata_map<H, K, I>(self, handle: &H, metadata: I) -> Self

where H: NodeHandleLike, K: Into<String>, I: IntoIterator<Item = (K, Value)>,

Bulk metadata helper for a node handle.

pub fn node_metadata_map_by_id<K, I>( self, node_alias: impl Into<String>, metadata: I, ) -> Self

where K: Into<String>, I: IntoIterator<Item = (K, Value)>,

Bulk metadata helper for a node alias.

pub fn const_input(self, port: &PortHandle, value: Option<Value>) -> Self

Set or unset a constant value for a node alias/port. None unsets/ignores default.

pub fn host_bridge(self, alias: impl Into<String>) -> Self

Ensure a host-bridge node exists with the provided alias (one per graph).

pub fn const_input_by_id( self, node_alias: impl Into<String>, port: impl Into<String>, value: Option<Value>, ) -> Self

Set or unset a constant value by explicit id/port tuple.

pub fn nest( self, nested: &NestedGraph, alias: impl Into<String>, ) -> (Self, NestedGraphHandle)

Inline another graph by prefixing node labels with alias and wiring its host bridge to return a handle representing the nested inputs/outputs.

pub fn connect<F, T>(self, from: F, to: T) -> Self

where F: IntoPortSpec, T: IntoPortSpec,

pub fn connect_with_metadata<F, T, K>( self, from: F, to: T, metadata: impl IntoIterator<Item = (K, Value)>, ) -> Self

where F: IntoPortSpec, T: IntoPortSpec, K: Into<String>,

Connect two ports and attach metadata to the edge.

pub fn edge_metadata<F, T>( self, from: F, to: T, key: impl Into<String>, value: Value, ) -> Self

where F: IntoPortSpec, T: IntoPortSpec,

Attach/override metadata for an existing connection edge.

pub fn connect_handles(self, from: &PortHandle, to: &PortHandle) -> Self

Connect using PortHandle pairs for string-free wiring.

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

Connect by explicit id/port tuples (old-style, but structured).

pub fn inputs(self, _ports: &[PortHandle]) -> Self

No-op helpers to mirror the desired API shape for host I/O handles.

pub fn outputs(self, _ports: &[PortHandle]) -> Self

pub fn connect_ports<F, T>(self, from: F, to: T) -> Self

where F: IntoPortSpec, T: IntoPortSpec,

Connect using explicit tuple arguments instead of a colon string, e.g. .connect_ports(("src", "out"), ("dst", "inp")).

pub fn connect_to_nested<F>( self, from: F, nested: &NestedGraphHandle, port: impl AsRef<str>, ) -> Self

where F: IntoPortSpec,

Connect an outer node/port to a nested graph input port.

pub fn connect_from_nested<T>( self, nested: &NestedGraphHandle, port: impl AsRef<str>, to: T, ) -> Self

where T: IntoPortSpec,

Connect a nested graph output port to a node/port in the outer graph.

pub fn build(self) -> Graph