Skip to main content

graphrt_core/nodes/
mod.rs

1//! Built-in nodes.
2//!
3//! | kind | role |
4//! |---|---|
5//! | `start` | root |
6//! | `end` | response |
7//! | `answer` | response |
8//! | `if-else` | branch |
9//! | `template-transform` | executable (feature `jinja`) |
10//! | `variable-aggregator` | executable |
11//! | `assigner` | executable |
12//! | `list-operator` | executable |
13//! | `iteration` | container |
14//! | `loop` | container |
15//! | `iteration-start`, `loop-start`, `loop-end` | scope markers |
16//! | `human-input` | branch |
17//!
18//! Node implementations are internal; they are built from workflow documents
19//! through [`register_builtins`] / [`crate::node::Registry::with_builtins`].
20//! Configuration fields are documented in the workflow format reference.
21//!
22//! `variable-assigner` is accepted for both assigner configs (`items`,
23//! `assigned_variable_selector`) and aggregator configs (`variables`),
24//! detected by the configuration shape.
25
26use std::sync::Arc;
27
28use crate::dsl::NodeDoc;
29use crate::node::{ConfigError, Node, Registry, parse_config};
30
31mod aggregator;
32mod answer;
33mod assigner;
34mod descriptors;
35mod end;
36mod human_input;
37mod if_else;
38mod iteration;
39mod list_operator;
40mod loop_node;
41mod markers;
42mod start;
43#[cfg(feature = "jinja")]
44mod template_transform;
45
46/// Register every built-in core node kind.
47pub fn register_builtins(registry: &mut Registry) {
48    registry
49        .register_described(descriptors::start(), |doc| Ok(Arc::new(start::StartNode::new(doc, parse_config(doc)?)?)));
50    registry.register_described(descriptors::end(), |doc| Ok(Arc::new(end::EndNode::new(parse_config(doc)?))));
51    registry.register_described(descriptors::answer(), |doc| Ok(Arc::new(answer::AnswerNode::new(parse_config(doc)?))));
52    registry.register_described(descriptors::if_else(), |doc| {
53        Ok(Arc::new(if_else::IfElseNode::new(doc, parse_config(doc)?)?))
54    });
55    registry.register_described(descriptors::aggregator(), |doc| {
56        Ok(Arc::new(aggregator::AggregatorNode::new(parse_config(doc)?)))
57    });
58    registry.register_described(descriptors::assigner(), build_assigner);
59    registry.register_described(descriptors::variable_assigner(), |doc| {
60        let is_assigner = doc.config.contains_key("items") || doc.config.contains_key("assigned_variable_selector");
61        if is_assigner {
62            build_assigner(doc)
63        } else {
64            Ok(Arc::new(aggregator::AggregatorNode::new(parse_config(doc)?)))
65        }
66    });
67    registry.register_described(descriptors::list_operator(), |doc| {
68        Ok(Arc::new(list_operator::ListOperatorNode::new(doc, parse_config(doc)?)?))
69    });
70    registry.register_described(descriptors::iteration(), |doc| {
71        Ok(Arc::new(iteration::IterationNode::new(doc, parse_config(doc)?)?))
72    });
73    registry.register_described(descriptors::loop_node(), |doc| {
74        Ok(Arc::new(loop_node::LoopNode::new(doc, parse_config(doc)?)?))
75    });
76    registry.register_described(descriptors::iteration_start(), |_| Ok(Arc::new(markers::ScopeStartNode)));
77    registry.register_described(descriptors::loop_start(), |_| Ok(Arc::new(markers::ScopeStartNode)));
78    registry.register_described(descriptors::loop_end(), |_| Ok(Arc::new(markers::LoopEndNode)));
79    registry.register_described(descriptors::human_input(), |doc| {
80        Ok(Arc::new(human_input::HumanInputNode::new(doc, parse_config(doc)?)?))
81    });
82    crate::tool_node::register(registry);
83    #[cfg(feature = "jinja")]
84    registry.register_described(descriptors::template_transform(), |doc| {
85        Ok(Arc::new(template_transform::TemplateTransformNode::new(doc, parse_config(doc)?)?))
86    });
87}
88
89fn build_assigner(doc: &NodeDoc) -> Result<Arc<dyn Node>, ConfigError> {
90    Ok(Arc::new(assigner::AssignerNode::new(doc, parse_config(doc)?)?))
91}