Choose the lifetime of script state

Constants and event valuesCopy Anchor Link

Use an inline input or constant node for a value that stays fixed in the graph. Use a trigger output for the value associated with that event, such as the bot or chat text. An event value is not a durable record of every earlier event.

Bot variablesCopy Anchor Link

Connection variable nodes store temporary values for one bot connection. A new connection starts without those values. Persistent bot variable nodes use the account's saved metadata. Use them for behavior that needs state across multiple events for that bot. Choose a stable variable name and a documented value type. Initialize the value before the first read, or use a defined fallback.

Check the actual variable nodes and their ports in the node reference. Do not assume that every storage node has the same lifetime or scope.

Project variablesCopy Anchor Link

Project runtime variable nodes keep temporary state while bots stop and start. Their values reset when the SoulFire server restarts. Persistent project variable nodes use saved project metadata. The node types retain their existing variable.*_instance and variable.*_bot names. See names and compatibility for the earlier labels and unchanged IDs.

Caches and persistent storageCopy Anchor Link

The state nodes include cache and persistent-storage operations. A cache suits temporary reuse. Persistent storage suits values that must survive the lifecycle supported by that node. Read the node's implementation link for its scope and storage behavior before relying on restart persistence.

Use unique keys per workflow when state belongs to separate test runs. A reused key can carry a previous run's result into a new experiment.

Verify the required lifetimeCopy Anchor Link

1. Write a known value through the chosen node.
2. Read it in a second event from the same bot.
3. Reconnect the bot and read it again.
4. Restart the backend if the workflow requires restart persistence.
5. Record which steps preserve the value on your installed version.

Reset or remove test state during cleanup. A script export preserves the graph and its inputs. It does not export every value stored by runtime nodes.