Tool
Read Signal Feature (Bool)
feature.read_bool
Inputs
The carrier for the signal whose feature bag you want to read — wire in the signal context this stage is evaluating.
Outputs
A boolean carrying the named feature’s truthiness — its stored value if present (numbers compared against truthy_threshold), or the default when the feature is missing.
Read Signal Feature (Bool) pulls a named value out of a signal’s feature bag and returns it as a true/false. It lets a downstream stage react to a feature an earlier stage recorded — for example “was the entry confirmed?”
How it works
You give the node a `feature_name` and it reads that feature from the signal currently flowing through the pipeline, wired in via `value`. If the feature is numeric it’s compared to `truthy_threshold` to decide true/false; if the feature is missing, the `default` you set is returned instead.
Configuration
The name of the feature to read from the signal’s feature bag. It must match the name the upstream stage recorded; a typo or unknown name falls back to the default.
The boolean returned when the named feature is absent from the signal, so the node has a defined answer even when nothing was recorded.
When the stored feature is a number rather than a plain boolean, this is the level at or above which it is read as true; below it the node returns false.
Connects to
Examples
- Gate on an earlier decision: set feature_name to “confirmed” with default false so a position stage only proceeds when the signal stage marked the setup confirmed.
- Threshold a numeric feature: read a stored confidence score with truthy_threshold 0.7 to treat only high-confidence signals as true.
Common mistakes
- Misspelling feature_name so the read always falls through to the default, masking the bug as a constant output.
- Reading a numeric feature without setting a sensible truthy_threshold, so any non-zero value flips to true unexpectedly.