Skip to main content

Module pool

Module pool 

Source
Expand description

Selectors and the variable pool.

A Selector addresses a value as namespace.name[.path...], where the namespace is a node id or one of the reserved namespaces (SYS, ENV, CONVERSATION). The VariablePool stores one Variables map per namespace (shared on clone), and the namespace table itself is shared too: cloning a pool (for a node context, an iteration item or a loop round) is O(1), and writes copy only the touched namespace (plus the table, when it is shared). A node’s outputs become its namespace without being copied.

Structs§

InvalidSelector
Error for malformed selectors.
PathError
Error writing a nested path.
PoolSnapshot
Persistable variable pool contents (namespace -> name -> value).
Selector
Address of a value: [namespace, name, path...].
VariablePool
Variable storage for one execution frame.

Constants§

CONVERSATION
Conversation-scoped variables. Persisted by the host between runs.
ENV
Environment variables / secrets. Supplied by the host, never persisted in snapshots.
SYS
System variables (sys.query, sys.files, sys.run_id, …). Written by the host only.