Optional ReadonlycorrelationThe run's correlation (10.1) — env.traceparent, or env.traceId + env.operationId, resolved once per
leg. The SAME frozen object, by reference, on every stamp of the leg (subflows included) and on
getSnapshot().correlation. Absent — no key — when the env gives none.
ReadonlydepthSubflow nesting depth of the stage's ADDRESS: how many subflow segments its
runtimeStageId carries (0 = top level, 1 = inside a subflow or a
parallelForEach branch, 2 = a subflow inside that, …). One meaning on
every stamp — stage events, the run-boundary root (0) and onResume
(9.37.0; until 9.36.0 stage events stamped the parent-chain length of the
stage's context instead).
Optional ReadonlyforkFork branch ID when inside a parallel or decider branch.
Optional ReadonlyloopHow many times this stage has executed BEFORE in this run — the loop
iteration count when a node is revisited (e.g. via loopTo). Absent on the
first execution; 1 on the first loop-back, 2 on the next, … (i.e.
visitCount - 1). Run-scoped (resets each run()/resume()) and monotonic
across subflow re-mounts. Populated for every stage kind. Mirrors the
narrative recorder's "pass N" count.
Optional ReadonlyparentThe parent EXECUTION step's runtimeStageId — the runtime twin of
parentStageId (RFC-003 D1). Walk up to reconstruct the runtime
ancestor chain; loop re-entries stay unambiguous because runtime ids
(stageId#executionIndex) differ per iteration even when stage ids
repeat. Crosses subflow boundaries: the first stage inside a subflow
points at the MOUNT stage's runtimeStageId in the parent traverser.
Undefined only at the first stage of the top-level chart.
Optional ReadonlyparentParent stage ID — walk up to reconstruct the tree. Undefined at root.
Optional ReadonlyresumedOn the onResume event only (9.37.0): the PAUSED execution this resumed
run continues — a link in the OpenTelemetry sense, not a parent. A resume
is a new runId, so the paused (runId, runtimeStageId) cannot be a
parent of anything in it; it is named here instead. Absent when the
checkpoint predates 9.37.0 (it did not record the paused execution).
ReadonlyrunPer-executor.run() identifier. Generated once at the start of every
run() (and again on resume()); shared by every event of that run;
differs across consecutive runs of the same executor.
Format: ${Date.now()}-${counter} — sortable lexicographically (==
chronologically for runs > 1ms apart). Process-local — for cross-
process correlation use getEnv().traceId (consumer-supplied).
Recorders that accumulate state across runs (fork bookkeeping,
sibling-handoff state, etc.) detect "new run" via
event.traversalContext.runId !== this.lastRunId and reset
transient bookkeeping. Recorders that don't care about scoping
ignore the field.
ReadonlyruntimeUnique per-execution-step identifier. Format: [subflowPath/]stageId#executionIndex.
Counter resets per executor — combine with runId for globally unique step keys.
ReadonlystageStable stage identifier from the builder (matches spec node id).
ReadonlystageHuman-readable stage name.
Optional ReadonlysubflowSubflow ID when inside a subflow. Undefined at root level.
Optional ReadonlysubflowFull subflow path for nested subflows (e.g., "sf-outer/sf-inner").
Traversal context attached to every FlowRecorder event. Created by the traverser during DFS, passed to recorders as read-only data. Enables recorders to build trees, group by subflow, and correlate events without maintaining their own stacks or post-processing.
Like OpenTelemetry's span context: stageId + parentStageId form a tree.