Enum NodeKind 

pub enum NodeKind {
    Agent {
        system_prompt: String,
        model: String,
        tools: Vec<String>,
        provider: Option<String>,
    },
    Tool {
        tool_name: String,
    },
    Router {
        max_iterations: u32,
    },
    Respond,
    Supervisor {
        system_prompt: String,
        model: String,
        routes: Vec<SupervisorRoute>,
        provider: Option<String>,
    },
    Parallel,
    Join,
    Approval {
        title: String,
        mode: String,
        risk_threshold: Option<f64>,
        confidence_threshold: Option<f64>,
        deadline_ms: Option<u64>,
    },
}

The role a node plays in the graph, plus its per-kind configuration.

Serialised with "kind" as the tag field; variant names are lowercase.

Variants

Agent

An LLM agent that may invoke tools.

Fields

system_prompt: String

model: String

tools: Vec<String>

provider: Option<String>

LLM provider override (e.g. "anthropic", "openai"). Absent in existing graphs — defaults to None, which the executor maps to "openai" for backward compatibility.

Tool

A deterministic tool call node.

Fields

tool_name: String

Router

A routing decision node (loop vs. resolved).

Fields

max_iterations: u32

Respond

Terminal node that emits the final reply.

Supervisor

LLM-routing supervisor — picks a branch from its route list.

Requires schemaVersion: 2.

Fields

system_prompt: String

model: String

routes: Vec<SupervisorRoute>

provider: Option<String>

LLM provider override (e.g. "anthropic", "openai"). Absent in existing graphs — defaults to None, which the executor maps to "openai" for backward compatibility.

Parallel

Fan-out node — spawns one branch per outgoing edge.

Requires schemaVersion: 2.

Join

Fan-in node — waits for all parallel branches to arrive.

Requires schemaVersion: 2.

Approval

Human-in-the-loop approval node. Parks the run awaiting a human decision (RunStatus::AwaitingInput) and advances along the approved/denied/ timeout edge once decided. The decision itself is supplied by the host’s ApprovalFn closure.

Requires schemaVersion: 2.

Fields

title: String

mode: String

risk_threshold: Option<f64>

confidence_threshold: Option<f64>

deadline_ms: Option<u64>

Implementations

impl NodeKind

pub fn kind_name(&self) -> &'static str

Returns the lowercase string name of this kind (matches the serde tag).

Trait Implementations

impl Clone for NodeKind

fn clone(&self) -> NodeKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NodeKind

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NodeKind

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for NodeKind

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.