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.register_lazily_described("start", descriptors::start, |doc| {
49        Ok(Arc::new(start::StartNode::new(doc, parse_config(doc)?)?))
50    });
51    registry
52        .register_lazily_described("end", descriptors::end, |doc| Ok(Arc::new(end::EndNode::new(parse_config(doc)?))));
53    registry.register_lazily_described("answer", descriptors::answer, |doc| {
54        Ok(Arc::new(answer::AnswerNode::new(parse_config(doc)?)))
55    });
56    registry.register_lazily_described("if-else", descriptors::if_else, |doc| {
57        Ok(Arc::new(if_else::IfElseNode::new(doc, parse_config(doc)?)?))
58    });
59    registry.register_lazily_described("variable-aggregator", descriptors::aggregator, |doc| {
60        Ok(Arc::new(aggregator::AggregatorNode::new(parse_config(doc)?)))
61    });
62    registry.register_lazily_described("assigner", descriptors::assigner, build_assigner);
63    registry.register_lazily_described("variable-assigner", descriptors::variable_assigner, |doc| {
64        let is_assigner = doc.config.contains_key("items") || doc.config.contains_key("assigned_variable_selector");
65        if is_assigner {
66            build_assigner(doc)
67        } else {
68            Ok(Arc::new(aggregator::AggregatorNode::new(parse_config(doc)?)))
69        }
70    });
71    registry.register_lazily_described("list-operator", descriptors::list_operator, |doc| {
72        Ok(Arc::new(list_operator::ListOperatorNode::new(doc, parse_config(doc)?)?))
73    });
74    registry.register_lazily_described("iteration", descriptors::iteration, |doc| {
75        Ok(Arc::new(iteration::IterationNode::new(doc, parse_config(doc)?)?))
76    });
77    registry.register_lazily_described("loop", descriptors::loop_node, |doc| {
78        Ok(Arc::new(loop_node::LoopNode::new(doc, parse_config(doc)?)?))
79    });
80    registry.register_lazily_described("iteration-start", descriptors::iteration_start, |_| {
81        Ok(Arc::new(markers::ScopeStartNode))
82    });
83    registry
84        .register_lazily_described("loop-start", descriptors::loop_start, |_| Ok(Arc::new(markers::ScopeStartNode)));
85    registry.register_lazily_described("loop-end", descriptors::loop_end, |_| Ok(Arc::new(markers::LoopEndNode)));
86    registry.register_lazily_described("human-input", descriptors::human_input, |doc| {
87        Ok(Arc::new(human_input::HumanInputNode::new(doc, parse_config(doc)?)?))
88    });
89    crate::tool_node::register(registry);
90    #[cfg(feature = "jinja")]
91    registry.register_lazily_described("template-transform", descriptors::template_transform, |doc| {
92        Ok(Arc::new(template_transform::TemplateTransformNode::new(doc, parse_config(doc)?)?))
93    });
94}
95
96fn build_assigner(doc: &NodeDoc) -> Result<Arc<dyn Node>, ConfigError> {
97    Ok(Arc::new(assigner::AssignerNode::new(doc, parse_config(doc)?)?))
98}