Node Reference

This section documents all built-in nodes available in FlowDrop. Each node is described with its purpose, input/output ports, configuration options, and usage examples.

Text & Output

Nodes for providing text input, formatting, and output.

Node	Description
Text Input	Provides a static text value as output
Text Output	Outputs text with optional length limits and formatting
Prompt Template	Renders templates with {{variable}} substitution
Chat Input	Accepts chat messages (for Playground workflows)
Chat Output	Outputs chat-style messages
Logger	Logs messages to Drupal's watchdog
Messenger	Displays Drupal status/warning/error messages

Data Processing

Nodes for transforming, extracting, and reshaping data.

Node	Description
Data Shaper	Reshapes data using field mappings and JSON Schema
Data Extractor	Extracts values using JSONPath or property paths
Data Operations	Array operations: filter, sort, group, map, reduce, unique, merge
Split Text	Splits text into chunks by words, sentences, or custom separator
Regex Extractor	Extracts data using regular expressions
Data to JSON	Converts structured data to a JSON string
JSON to Data	Parses a JSON string into structured data
Data to Dataframe	Converts data to dataframe format
Message to Data	Converts messages to structured data (JSON, CSV, XML, YAML)

Control Flow

Nodes for branching, conditional logic, and routing.

Node	Description
IfElse	Conditional branching with text comparison operators
Boolean Gateway	Routes execution based on a boolean value
Switch Gateway	Multi-path routing based on expression matching
A/B	Random A/B split for testing

Entity Operations

Nodes for working with Drupal entities.

Node	Description
Entity Query	Queries entities with conditions, pagination, and sorting
Entity Context	Loads a specific entity by type and ID
Entity Save	Creates or updates entities
Get Workflow Data	Retrieves initial data passed to the workflow

HTTP & Integration

Node	Description
HTTP Request	Makes HTTP requests to external APIs

Utility

Node	Description
Calculator	Mathematical operations (add, subtract, average, etc.)
DateTime	Date/time operations with timezone support
Range	Generates numeric sequences
Repeat	Repeats a value N times
Note	Documentation node (no execution)
Idea	Placeholder for planned functionality

Human-in-the-Loop

Nodes that pause the workflow for user input. Requires flowdrop_interrupt module.

Node	Description
Confirmation	Yes/No confirmation prompt
Choice Input	Select from a list of options
Text Input (Interrupt)	Free-form text input with validation
Form Input	Structured form from JSON Schema

Loops & State (StateGraph)

Nodes for iteration and state management. Requires flowdrop_stategraph module.

Node	Description
ForEach	Iterates over an array
Iterator Start	Initializes iteration
Approval Gate	Pauses for human approval
State Storage	Read/write key-value state

Workflow Composition

Nodes for calling workflows from other workflows. Requires flowdrop_workflow_executor module.

Node	Description
Workflow Executor	Executes a child workflow
Workflow Results Retriever	Retrieves results from a child workflow