Builder class for creating subgraphs with a fluent API.
Subgraphs are reusable graph components that can be referenced by other graphs.
Example
const subgraph = new SubgraphBuilder('my_subgraph')
.addNode(intentNode)
.addNode(llmNode)
.addEdge(intentNode, llmNode)
.setStartNode(intentNode)
.setEndNode(llmNode)
.build();
Constructors
Methods
Constructors
constructor
new SubgraphBuilder(id: string): SubgraphBuilder
Parameters
Unique identifier for the subgraph
Returns
SubgraphBuilder
Methods
addEdge
addEdge(
fromNode: string | Node | AbstractNode,
toNode: string | Node | AbstractNode,
options?: {
conditionExpression?: string;
conditionRef?: CustomEdgeConditionReference;
loop?: boolean;
optional?: boolean;
},
): this
Parameters
fromNode
string | Node | AbstractNode
required
Source node
toNode
string | Node | AbstractNode
required
Destination node
Optional edge configuration
CEL expression for conditional execution
conditionRef
CustomEdgeConditionReference
Reference to a custom edge condition
Whether the edge creates a loop
Whether the edge is optional
Returns
this
The builder instance for method chaining
addNode
addNode(node: Node | AbstractNode): this
Parameters
node
Node | AbstractNode
required
Node to add to the subgraph
Returns
this
The builder instance for method chaining
addParameter
addParameter(
config: {
name: string;
type: "string" | "number" | "boolean" | "integer";
},
): this
Parameters
Parameter configuration
type
'string' | 'number' | 'boolean' | 'integer'
required
Parameter type (‘string’, ‘number’, ‘integer’, ‘boolean’)
Returns
this
The builder instance for method chaining
addParameters
addParameters(
parameters: {
name: string;
type: "string" | "number" | "boolean" | "integer";
}[],
): this
Parameters
parameters
Array<{ name: string; type: 'string' | 'number' | 'boolean' | 'integer' }>
required
Array of parameter configurations
Returns
this
The builder instance for method chaining
build
Builds and returns the final subgraph configuration.
Returns
Subgraph
The completed subgraph configuration
Throws
If the subgraph has no nodes
setEndNode
setEndNode(node: string | Node | AbstractNode): this
Parameters
node
string | Node | AbstractNode
required
End node
Returns
this
The builder instance for method chaining
setStartNode
setStartNode(node: string | Node | AbstractNode): this
Parameters
node
string | Node | AbstractNode
required
Start node
Returns
this
The builder instance for method chaining 
