BitQuirky.Behavior.Execution
Public behavior trees and state machines: runtime symbols in BitQuirky.Behavior.Execution.
Source snapshot 29003d8b1658.
On this page
Assembly: BitQuirky.Behavior.Runtime
BehaviorActionLifecycleRuntimeState
Section titled “BehaviorActionLifecycleRuntimeState”Category: Low-level runtime
struct BitQuirky.Behavior.Execution.BehaviorActionLifecycleRuntimeStateSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:254-326
Bounded lifecycle progress for one action state’s Entry, Active Update, and Exit groups.
Responsibilities:
- Carry the selected lifecycle phase, the three structured group results, the Active Update pass identity, the latched destination, its transition update, and the single remaining Exit evaluation.
- Stay plain data so GameObject and pure-entity hosts carry identical handoff evidence.
Does NOT:
- Own per-action progress, baked policy, or native memory.
Members
Section titled “Members”Inactive
Section titled “Inactive”public static BitQuirky.Behavior.Execution.BehaviorActionLifecycleRuntimeState Inactive { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:309-325
Gets a cleared lifecycle value using the documented inactive sentinels.
EntryStatus
Section titled “EntryStatus”public BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus EntryStatusSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:261
Structured Entry group result.
ExitBudgetRemaining
Section titled “ExitBudgetRemaining”public byte ExitBudgetRemainingSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:294
One while a nonempty Exit still owes its sole evaluation.
ExitStatus
Section titled “ExitStatus”public BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus ExitStatusSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:267
Structured Exit group result.
FinishArmed
Section titled “FinishArmed”public byte FinishArmedSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:276
One while an On Finish transition may observe a held Once result.
HasLatchedDestination
Section titled “HasLatchedDestination”public byte HasLatchedDestinationSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:300
One while a destination is latched. Zero-initialized memory therefore reads as no handoff without depending on the -1 sentinels written by explicit clears.
IterationBoundaryPending
Section titled “IterationBoundaryPending”public byte IterationBoundaryPendingSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:279
One only until the current pass boundary has had its On Iteration evaluation.
LatchedDestinationStateIndex
Section titled “LatchedDestinationStateIndex”public int LatchedDestinationStateIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:288
Chosen destination state, or -1 outside a handoff.
PendingMachineFaultCode
Section titled “PendingMachineFaultCode”public BitQuirky.Behavior.Execution.BehaviorResultCode PendingMachineFaultCodeSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:285
Exact fault code retained when PendingMachineResult is Faulted.
PendingMachineResult
Section titled “PendingMachineResult”public BitQuirky.Behavior.Execution.BehaviorMachineResult PendingMachineResultSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:282
Final result waiting for the state’s bounded Exit update.
public BitQuirky.Behavior.Baked.BakedActionPhase PhaseSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:258
Lifecycle group the shared scheduler selected for the active state.
Reserved0
Section titled “Reserved0”public byte Reserved0Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:303
Reserved byte kept zero for additive binary evolution.
Reserved1
Section titled “Reserved1”public byte Reserved1Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:306
Reserved byte kept zero for additive binary evolution.
TransitionFrame
Section titled “TransitionFrame”public int TransitionFrameSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:291
Update that latched the destination, or -1 before handoff.
UpdatePass
Section titled “UpdatePass”public uint UpdatePassSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:270
One-based Active Update pass identity; zero before the first pass.
UpdateResult
Section titled “UpdateResult”public BitQuirky.Behavior.Execution.BehaviorResultCode UpdateResultSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:273
Exact result produced by the most recently completed Active Update pass.
UpdateStatus
Section titled “UpdateStatus”public BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus UpdateStatusSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:264
Structured Active Update group result.
BehaviorActionRuntimeState
Section titled “BehaviorActionRuntimeState”Category: Low-level runtime
struct BitQuirky.Behavior.Execution.BehaviorActionRuntimeStateSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:146-169
Persistent progress for one direct action in a baked state action list.
Responsibilities:
- Retain one action’s result, pending command identity, and activation generation.
- Allow any number of deferred Parallel actions without consuming fixed legacy slots.
Does NOT:
- Own the baked action, interpret completion payloads, or allocate memory.
Members
Section titled “Members”ActivationGeneration
Section titled “ActivationGeneration”public uint ActivationGenerationSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:168
State activation that issued the request, so a completion belonging to an earlier activation of the same action is discarded.
CancellationIssued
Section titled “CancellationIssued”public byte CancellationIssuedSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:154
One once an interrupt command has been posted for the outstanding request, so no second cancellation is emitted.
CommandId
Section titled “CommandId”public int CommandIdSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:158
Runtime-issued command id the outstanding request and its completion record are matched on.
CompletedFrame
Section titled “CompletedFrame”public int CompletedFrameSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:164
Host frame stamped by the completion, cancellation, or immediate result; zero while a freshly issued request is still outstanding.
CompletedStep
Section titled “CompletedStep”public int CompletedStepSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:166
HostStep that recorded CompletedFrame. A Repeat list restarts only after a later host step, so several FixedUpdate steps in one render frame each restart it.
FrameIssued
Section titled “FrameIssued”public int FrameIssuedSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:162
Host frame on which the request was posted.
IsPending
Section titled “IsPending”public byte IsPendingSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:152
One while the action awaits an external service completion identified by CommandId.
Reserved0
Section titled “Reserved0”public byte Reserved0Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:156
Reserved byte kept zero for additive binary evolution.
Result
Section titled “Result”public BitQuirky.Behavior.Execution.BehaviorResultCode ResultSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:150
Result this action last produced; None before its first evaluation and Running while a request is outstanding.
ServiceId
Section titled “ServiceId”public int ServiceIdSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:160
Stable service-id hash of the service the outstanding request was posted to.
BehaviorInterruptionRecord
Section titled “BehaviorInterruptionRecord”Category: Low-level runtime
struct BitQuirky.Behavior.Execution.BehaviorInterruptionRecordSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:508-559
Latest structured reactive interruption recorded by one runtime instance.
Responsibilities:
- Preserve interrupted and cause node identity, result, frame, and monotonic sequence.
Does NOT:
- Invoke a callback, emit a cue, or replace the selected branch result.
Members
Section titled “Members”CauseNodeIndex
Section titled “CauseNodeIndex”public int CauseNodeIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:515
Baked condition node that caused the interruption.
FrameNumber
Section titled “FrameNumber”public int FrameNumberSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:521
Selected frame in which the interruption occurred.
InterruptedNodeIndex
Section titled “InterruptedNodeIndex”public int InterruptedNodeIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:512
Baked node whose Running work was interrupted.
IsValid
Section titled “IsValid”public byte IsValidSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:527
One when this record contains an observed interruption.
Reserved0
Section titled “Reserved0”public byte Reserved0Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:530
Reserved byte kept zero for additive binary evolution.
Reserved1
Section titled “Reserved1”public byte Reserved1Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:533
Reserved byte kept zero for additive binary evolution.
Reserved2
Section titled “Reserved2”public byte Reserved2Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:536
Reserved byte kept zero for additive binary evolution.
ResponseNodeIndex
Section titled “ResponseNodeIndex”public int ResponseNodeIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:543
Baked node index of the nearest response-bearing ancestor task resolved for this interruption (, BT-016), or -1 when none exists. A genuinely new field appended to this pure runtime struct, which is never serialized to disk.
ResponseNodeIndexReasserted
Section titled “ResponseNodeIndexReasserted”public byte ResponseNodeIndexReassertedSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:558
One whenResponseNodeIndexwas carried forward, unchanged, from the
immediately prior interruption because the same guarded branch’s own reactive
conditions re-asserted themselves this tick (, findings C1/D1, P2), rather
than being freshly resolved for a genuinely new interruption. Zero for every other
interruption, including a second freshly resolved interruption of the same
response-bearing task after it was re-entered. Consumed only by
BehaviorAgent’s InterruptionResponseTriggered
dispatch gating; never read byLastInterruptionHasConfiguredResponse, which
must keep reporting the preserved response across a reassertion . A
genuinely new field appended to this pure runtime struct, which is never serialized
to disk.
Result
Section titled “Result”public BitQuirky.Behavior.Execution.BehaviorResultCode ResultSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:518
Observable result recorded for the interrupted node.
Sequence
Section titled “Sequence”public uint SequenceSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:524
Per-agent monotonic interruption sequence.
BehaviorLiveValueOverlayLayout
Section titled “BehaviorLiveValueOverlayLayout”Category: Low-level runtime
class BitQuirky.Behavior.Execution.BehaviorLiveValueOverlayLayoutSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorLiveValueOverlayRuntimeState.cs:53-101
The one addressing rule of a running instance’s live-value overlay : one slot per baked node, which a Member condition’s comparison constant and a State’s minimum duration use; then one slot per baked node parameter, which an edit of that single parameter uses; then one slot per baked transition condition, which an edit of its constant uses. A parameter or condition slot holds the edited value’s raw bits: the low word inValueand, for a condition, the high word inValueHigh.
Members
Section titled “Members”Override(long bits, int sourceInstanceId)
Section titled “Override(long bits, int sourceInstanceId)”public static BitQuirky.Behavior.Execution.BehaviorLiveValueOverlayRuntimeState Override(long bits, int sourceInstanceId)Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorLiveValueOverlayRuntimeState.cs:93-100
Builds the overriding row of a parameter or condition slot for these raw bits.
ParameterIndexOf(int nodeCount, int parameterCount, int slot)
Section titled “ParameterIndexOf(int nodeCount, int parameterCount, int slot)”public static int ParameterIndexOf(int nodeCount, int parameterCount, int slot)Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorLiveValueOverlayRuntimeState.cs:70-71
Gets the baked parameter index an overlay slot edits, or -1 for a node slot or a slot past the parameters.
ParameterSlot(int nodeCount, int parameterIndex)
Section titled “ParameterSlot(int nodeCount, int parameterIndex)”public static int ParameterSlot(int nodeCount, int parameterIndex)Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorLiveValueOverlayRuntimeState.cs:63-64
Gets the overlay slot that carries a live edit of one baked node parameter.
ReadBits(in BehaviorLiveValueOverlayRuntimeState row)
Section titled “ReadBits(in BehaviorLiveValueOverlayRuntimeState row)”public static long ReadBits(in BitQuirky.Behavior.Execution.BehaviorLiveValueOverlayRuntimeState row)Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorLiveValueOverlayRuntimeState.cs:88-90
Reads the edited raw bits an overriding parameter or condition slot holds.
SlotCount(int nodeCount, int parameterCount, int conditionCount)
Section titled “SlotCount(int nodeCount, int parameterCount, int conditionCount)”public static int SlotCount(int nodeCount, int parameterCount, int conditionCount)Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorLiveValueOverlayRuntimeState.cs:59-60
Gets the overlay slot count of an artifact with these node, parameter, and transition condition counts.
TransitionConditionIndexOf(int nodeCount, int parameterCount, int conditionCount, int slot)
Section titled “TransitionConditionIndexOf(int nodeCount, int parameterCount, int conditionCount, int slot)”public static int TransitionConditionIndexOf(int nodeCount, int parameterCount, int conditionCount, int slot)Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorLiveValueOverlayRuntimeState.cs:80-85
Gets the baked transition condition an overlay slot edits, or -1 for any other slot.
TransitionConditionSlot(int nodeCount, int parameterCount, int conditionIndex)
Section titled “TransitionConditionSlot(int nodeCount, int parameterCount, int conditionIndex)”public static int TransitionConditionSlot(int nodeCount, int parameterCount, int conditionIndex)Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorLiveValueOverlayRuntimeState.cs:74-75
Gets the overlay slot that carries a live edit of one transition condition’s constant.
BehaviorLiveValueOverlayRuntimeState
Section titled “BehaviorLiveValueOverlayRuntimeState”Category: Low-level runtime
struct BitQuirky.Behavior.Execution.BehaviorLiveValueOverlayRuntimeStateSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorLiveValueOverlayRuntimeState.cs:21-42
Per-instance overlay for one live-edited task authored constant or state duration parameter (, through ), owned on both object models and mirroring the existing artifact-indexed, per-instanceBehaviorActionRuntimeState precedent. One entry per baked node the graph declares as overlay-eligible; never written to the baked artifact or the saved source.
Responsibilities:
- Record whether this baked node’s own slot carries an accepted live edit and, when it does, the edited Float32 payload and the instance that accepted it.
Does NOT:
- Decide eligibility, apply, or refuse an edit; a governed request/apply/refuse vocabulary writes here only after it accepts one.
Members
Section titled “Members”HasOverride
Section titled “HasOverride”public byte HasOverrideSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorLiveValueOverlayRuntimeState.cs:24
Non-zero while this slot carries an accepted live edit.
SourceInstanceId
Section titled “SourceInstanceId”public int SourceInstanceIdSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorLiveValueOverlayRuntimeState.cs:36
Defensive: the owning instance’s identity, matching the accepting
BehaviorRuntimeInstance.
public float ValueSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorLiveValueOverlayRuntimeState.cs:30
The edited Float32 payload whileHasOverrideis non-zero; for a parameter or transition-condition slot, the low 32 bits of the edited value.
ValueHigh
Section titled “ValueHigh”public int ValueHighSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorLiveValueOverlayRuntimeState.cs:41
The high 32 bits of an edited 64-bit transition-condition constant; zero for every other slot.
BehaviorMachineResult
Section titled “BehaviorMachineResult”Category: Low-level runtime
enum BitQuirky.Behavior.Execution.BehaviorMachineResultSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:92-105
Underlying type: byte
Final result of a state machine. A running or deliberately staying machine reports None; faults are never collapsed into an authored Failure result.
Members
Section titled “Members”Failure
Section titled “Failure”Failure = 2Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:101
The machine reached an authored failure terminal.
Faulted
Section titled “Faulted”Faulted = 3Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:104
The machine stopped on a runtime fault, never on an authored Failure outcome.
None = 0Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:95
The machine is still running or deliberately staying; it has no final result yet.
Success
Section titled “Success”Success = 1Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:98
The machine reached an authored success terminal.
BehaviorMemberRequestSlot
Section titled “BehaviorMemberRequestSlot”Category: Low-level runtime
struct BitQuirky.Behavior.Execution.BehaviorMemberRequestSlotSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:443-469
The single per-agent request/response channel for one in-flight immediate member operation. Immediate member operations (methods, messages, property and field node reads and writes, and member conditions) resolve within one selected host tick through a bounded microstep rather than the command/completion path used for deferred coroutine and event operations. Behavior Tree leaves retain those commands in pending-external slots; direct lifecycle work retains them in its per-nodeBehaviorActionRuntimeState.
Responsibilities:
- Carry which member operation and owning node the core requested, and the exact behavior result code the host wrote back after invoking the generated accessor.
Does NOT:
- Track deferred coroutine or event operations, which use their owning host execution state rather than this immediate channel.
Members
Section titled “Members”CompletionCode
Section titled “CompletionCode”public BitQuirky.Behavior.Execution.BehaviorResultCode CompletionCodeSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:462
Exact behavior result the host wrote after servicing an immediate request.
NodeIndex
Section titled “NodeIndex”public int NodeIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:450
Owning baked node index of the requested operation; -1 when none.
OperationIndex
Section titled “OperationIndex”public int OperationIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:447
Baked member operation row the core requested; -1 when none.
Reserved0
Section titled “Reserved0”public byte Reserved0Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:456
Reserved byte kept zero for additive binary evolution.
Reserved1
Section titled “Reserved1”public ushort Reserved1Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:459
Reserved word kept zero for additive binary evolution.
Reserved2
Section titled “Reserved2”public byte Reserved2Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:465
Reserved byte kept zero for additive binary evolution.
Reserved3
Section titled “Reserved3”public ushort Reserved3Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:468
Reserved word kept zero for additive binary evolution.
public BitQuirky.Behavior.Execution.BehaviorMemberRequestState StateSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:453
Channel lifecycle state.
BehaviorMemberRequestState
Section titled “BehaviorMemberRequestState”Category: Low-level runtime
enum BitQuirky.Behavior.Execution.BehaviorMemberRequestStateSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:415-425
Underlying type: byte
Lifecycle state of the single per-agent immediate member request channel.
Members
Section titled “Members”Completed
Section titled “Completed”Completed = 2Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:424
The host serviced the request; the core consumes the exact completion code.
None = 0Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:418
No immediate member operation is outstanding.
Requested
Section titled “Requested”Requested = 1Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:421
The shared core requested an immediate member operation the host must service.
BehaviorNestedMachinePhase
Section titled “BehaviorNestedMachinePhase”Category: Low-level runtime
enum BitQuirky.Behavior.Execution.BehaviorNestedMachinePhaseSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:562-581
Underlying type: byte
Stable lifecycle phase of a referenced machine activation.
Members
Section titled “Members”Faulted
Section titled “Faulted”Faulted = 5Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:580
The nested machine stopped on a runtime fault.
Finished
Section titled “Finished”Finished = 4Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:577
The nested machine reached its terminal; the reference reports Running until the host leaves it.
None = 0Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:565
No referenced machine is active on this instance.
Parked
Section titled “Parked”Parked = 1Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:568
The reference is entered but no candidate was selectable, so nothing nested runs this tick.
Running
Section titled “Running”Running = 3Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:574
The selected candidate machine is executing.
Selecting
Section titled “Selecting”Selecting = 2Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:571
The reference is choosing which saved candidate to activate; no nested machine runs yet.
BehaviorProbabilityRuntimeState
Section titled “BehaviorProbabilityRuntimeState”Category: Low-level runtime
struct BitQuirky.Behavior.Execution.BehaviorProbabilityRuntimeStateSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:382-392
Responsibilities:
- Retain one Probability Selector activation independently of its nested selectors. Does NOT:
- Own memory, choose weights, or persist after the selector exits.
Members
Section titled “Members”ActivationGeneration
Section titled “ActivationGeneration”public uint ActivationGenerationSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:389
State activation owning this pass; suspended Resume restores the same generation.
CandidateMask
Section titled “CandidateMask”public ulong CandidateMaskSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:385
Eligible weighted children, addressed by source order.
IsActive
Section titled “IsActive”public byte IsActiveSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:391
One while this selector owns an unfinished pass.
SelectedChildIndex
Section titled “SelectedChildIndex”public int SelectedChildIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:387
Retained selected child; meaningful while active.
BehaviorReferencePhase
Section titled “BehaviorReferencePhase”Category: Low-level runtime
enum BitQuirky.Behavior.Execution.BehaviorReferencePhaseSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:172-191
Underlying type: byte
Persistent lifecycle phase of one baked state-machine reference.
Members
Section titled “Members”Faulted
Section titled “Faulted”Faulted = 5Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:190
The nested machine stopped on a runtime fault; its fault result is retained for inspection.
Finished
Section titled “Finished”Finished = 4Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:187
The nested machine completed and its result is retained for inspection.
Outside
Section titled “Outside”Outside = 0Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:175
Execution has left the reference entirely and returned to the containing machine.
Parked
Section titled “Parked”Parked = 1Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:178
The reference is entered but no candidate could be selected, so nothing nested is running.
Running
Section titled “Running”Running = 2Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:181
A selected candidate machine is currently executing inside the reference.
Suspended
Section titled “Suspended”Suspended = 3Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:184
A Push transition suspended the reference; its cursor is retained for the eventual return.
BehaviorReferenceRuntimeState
Section titled “BehaviorReferenceRuntimeState”Category: Low-level runtime
struct BitQuirky.Behavior.Execution.BehaviorReferenceRuntimeStateSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:204-240
Retained runtime reading for one baked state-machine reference.
Responsibilities:
- Preserve the selected candidate, nested cursor, terminal result, and host transition boundary after execution leaves the reference.
- Stay blittable and reference-indexed for allocation-free runtime and Live inspection.
Does NOT:
- Own baked data, choose candidates, or change state-machine execution.
Members
Section titled “Members”Outside
Section titled “Outside”public static BitQuirky.Behavior.Execution.BehaviorReferenceRuntimeState Outside { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:228-239
Gets the cleared value for a reference execution has not entered, using the -1 and None sentinels the runtime tests against.
ActiveMachineIndex
Section titled “ActiveMachineIndex”public int ActiveMachineIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:210
Composed state-machine table row the selected candidate resolves to, or -1.
ActiveStateIndex
Section titled “ActiveStateIndex”public int ActiveStateIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:212
Baked node index of the state the reference was last observed in, or -1.
CandidateNodeIndex
Section titled “CandidateNodeIndex”public int CandidateNodeIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:208
Baked node index of the selected candidate, or -1 while the reference is parked or not entered.
HostActionLifecycle
Section titled “HostActionLifecycle”public BitQuirky.Behavior.Execution.BehaviorActionLifecycleRuntimeState HostActionLifecycleSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:225
Owning reference-state lifecycle retained while its child machine runs.
HostTransitionIndex
Section titled “HostTransitionIndex”public int HostTransitionIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:220
Interned string index of the host transition that entered or left this reference, reset to -1 once the machine reaches a terminal result.
HostTransitionTick
Section titled “HostTransitionTick”public int HostTransitionTickSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:222
Host frame paired with HostTransitionIndex, or -1.
public BitQuirky.Behavior.Execution.BehaviorReferencePhase PhaseSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:214
Lifecycle phase this reference was left in.
Result
Section titled “Result”public BitQuirky.Behavior.Execution.BehaviorMachineResult ResultSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:216
Terminal result of the referenced machine, or None while it is still running.
ResultTick
Section titled “ResultTick”public int ResultTickSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:218
Host frame that recorded Result, or -1 before the machine completes.
BehaviorRepeatRuntimeState
Section titled “BehaviorRepeatRuntimeState”Category: Low-level runtime
struct BitQuirky.Behavior.Execution.BehaviorRepeatRuntimeStateSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:368-374
Persistent progress for one baked Repeat decorator, indexed by its baked node.
Responsibilities:
- Retain the completed-attempt count independently for each Repeat decorator.
- Allow nested Repeat decorators to remain active without sharing progress.
Does NOT:
- Choose a repeat policy, evaluate a child, or retain active progress after the decorator exits.
Members
Section titled “Members”IterationsCompleted
Section titled “IterationsCompleted”public int IterationsCompletedSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:371
Completed child attempts in the current structural activation.
LastCompletedIterations
Section titled “LastCompletedIterations”public int LastCompletedIterationsSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:373
Actual completed attempts at the last terminal exit, retained for Live until reentry or reset.
BehaviorResultCode
Section titled “BehaviorResultCode”Category: Low-level runtime
enum BitQuirky.Behavior.Execution.BehaviorResultCodeSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:47-86
Underlying type: byte
Per-leaf result code propagated through composites and surfaced via
follower.behavior-report. Mirror of
BehaviorNodeStatuskept on the runtime instance so the
trace can replay the most recent terminal status without re-walking
the tree.
Members
Section titled “Members”AuthorityHandoff
Section titled “AuthorityHandoff”AuthorityHandoff = 8Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:74
The node’s outstanding external request was cancelled by an authority handoff.
AuthorityMismatch
Section titled “AuthorityMismatch”AuthorityMismatch = 7Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:71
The node was refused because the executing role does not satisfy the node’s authority.
Blocked
Section titled “Blocked”Blocked = 5Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:65
The node’s predicate did not hold, so execution does not pass it this tick.
ExecutionLimitExceeded
Section titled “ExecutionLimitExceeded”ExecutionLimitExceeded = 11Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:83
The tick exceeded its maximum evaluation-step budget. Counts as a runtime fault, not an authored Failure.
ExternalServiceRefused
Section titled “ExternalServiceRefused”ExternalServiceRefused = 9Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:77
The external service refused the command, or no completion slot could be reserved for it.
Failure
Section titled “Failure”Failure = 3Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:59
The node completed unsuccessfully as authored.
Faulted
Section titled “Faulted”Faulted = 12Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:85
A configuration or runtime fault, never an authored Failure outcome.
Interrupted
Section titled “Interrupted”Interrupted = 4Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:62
The node was cancelled before it settled, most often by a latched transition.
None = 0Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:50
No result has been recorded for this activation yet.
Running
Section titled “Running”Running = 1Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:53
The node is still working and is resumed on the next tick.
SubgraphError
Section titled “SubgraphError”SubgraphError = 10Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:80
A referenced subgraph could not run. Counts as a runtime fault, not an authored Failure.
Success
Section titled “Success”Success = 2Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:56
The node completed successfully.
Timeout
Section titled “Timeout”Timeout = 6Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:68
A deferred invocation gave up after its time budget elapsed.
BehaviorStateSuspensionFrame
Section titled “BehaviorStateSuspensionFrame”Category: Low-level runtime
struct BitQuirky.Behavior.Execution.BehaviorStateSuspensionFrameSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:587-675
One native suspension frame created by Push. The frame preserves the complete scheduler cursor for one activation; action rows are stored in the companion depth-indexed table.
Members
Section titled “Members”ActionActivationGeneration
Section titled “ActionActivationGeneration”public uint ActionActivationGenerationSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:624
Saved action activation generation, so completions issued before the Push still match on return.
ActionLifecycle
Section titled “ActionLifecycle”public BitQuirky.Behavior.Execution.BehaviorActionLifecycleRuntimeState ActionLifecycleSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:626
Saved Entry, Active Update, and Exit lifecycle progress of the suspended state.
ActiveDecoratorNodeIndex
Section titled “ActiveDecoratorNodeIndex”public int ActiveDecoratorNodeIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:603
Active decorator ancestry owned by this suspended activation. The shared tick core uses this exact prior cursor to retain Resume lifetimes and clear discarded or re-entered activations without scanning the graph.
ActiveMachineIndex
Section titled “ActiveMachineIndex”public int ActiveMachineIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:660
Saved composed-machine row; zero is the host machine.
ActiveNestedReferenceNodeIndex
Section titled “ActiveNestedReferenceNodeIndex”public int ActiveNestedReferenceNodeIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:654
Saved composed reference node, including hidden nested references, or -1.
ActiveProbabilitySelectorIndex
Section titled “ActiveProbabilitySelectorIndex”public int ActiveProbabilitySelectorIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:608
Saved active weighted selector node index, or -1.
ActiveStateMachineCandidateIndex
Section titled “ActiveStateMachineCandidateIndex”public int ActiveStateMachineCandidateIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:658
Saved selected referenced-machine candidate node index, or -1.
ActiveStateMachineReferenceIndex
Section titled “ActiveStateMachineReferenceIndex”public int ActiveStateMachineReferenceIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:656
Saved referenced-machine table row, or -1.
ActiveUtilitySelectorIndex
Section titled “ActiveUtilitySelectorIndex”public int ActiveUtilitySelectorIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:616
Saved active Utility Selector node index, or -1.
CompositeChildCursor
Section titled “CompositeChildCursor”public int CompositeChildCursorSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:595
Saved composite child cursor of the suspended activation.
CurrentNodeElapsedSeconds
Section titled “CurrentNodeElapsedSeconds”public float CurrentNodeElapsedSecondsSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:606
Saved seconds the suspended cursor had been ticking.
CurrentNodeIndex
Section titled “CurrentNodeIndex”public int CurrentNodeIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:593
Saved active node index, restored verbatim when execution returns to this frame.
DecoratorIterationsCompleted
Section titled “DecoratorIterationsCompleted”public int DecoratorIterationsCompletedSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:597
Saved Repeat decorator iteration count of the suspended activation.
HostedCompletedCycleCount
Section titled “HostedCompletedCycleCount”public int HostedCompletedCycleCountSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:630
Saved count of terminal hosted cycles completed in the suspended state.
HostedEventPending
Section titled “HostedEventPending”public byte HostedEventPendingSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:644
Saved flag for a hosted result event that still owes its single transition evaluation.
HostedLastCycleFrame
Section titled “HostedLastCycleFrame”public int HostedLastCycleFrameSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:632
Saved frame of the latest terminal hosted cycle, or -1.
HostedLastCycleStep
Section titled “HostedLastCycleStep”public int HostedLastCycleStepSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:634
Saved host step of the latest terminal hosted cycle, or -1.
HostedLifetime
Section titled “HostedLifetime”public BitQuirky.Behavior.Baked.BakedHostedBehaviorLifetime HostedLifetimeSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:640
Saved baked lifetime of the suspended hosted tree.
HostedResultCode
Section titled “HostedResultCode”public BitQuirky.Behavior.Execution.BehaviorResultCode HostedResultCodeSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:642
Saved terminal result of the latest hosted cycle, or None.
HostedResultEventId
Section titled “HostedResultEventId”public int HostedResultEventIdSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:638
Saved interned result-event id of the latest hosted cycle, or 0 when that outcome has no configured event.
HostedResultTick
Section titled “HostedResultTick”public int HostedResultTickSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:636
Saved input tick that produced the held hosted result, or -1.
HostedStateIndex
Section titled “HostedStateIndex”public int HostedStateIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:628
Saved owner of the suspended activation’s hosted behavior tree, or -1.
LastProbabilitySelectorIndex
Section titled “LastProbabilitySelectorIndex”public int LastProbabilitySelectorIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:610
Saved last weighted selector node index, or -1.
LastUtilitySelectorIndex
Section titled “LastUtilitySelectorIndex”public int LastUtilitySelectorIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:618
Saved last active Utility Selector node index, or -1.
NestedMachinePhase
Section titled “NestedMachinePhase”public BitQuirky.Behavior.Execution.BehaviorNestedMachinePhase NestedMachinePhaseSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:664
Saved lifecycle phase of the active or last referenced machine.
NestedMachineResult
Section titled “NestedMachineResult”public BitQuirky.Behavior.Execution.BehaviorMachineResult NestedMachineResultSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:662
Saved final result of the most recently completed nested machine.
OnReturn
Section titled “OnReturn”public BitQuirky.Behavior.Nodes.State.StateTransitionOnReturn OnReturnSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:668
Authored on-return policy of the Push transition that created this frame, applied when execution returns here.
Pending0
Section titled “Pending0”public BitQuirky.Behavior.Execution.PendingExternalSlot Pending0Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:646
Saved pending-external slot 0; the Push clears the live instance’s slots so only this frame owns them.
Pending1
Section titled “Pending1”public BitQuirky.Behavior.Execution.PendingExternalSlot Pending1Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:648
Saved pending-external slot 1.
Pending2
Section titled “Pending2”public BitQuirky.Behavior.Execution.PendingExternalSlot Pending2Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:650
Saved pending-external slot 2.
Pending3
Section titled “Pending3”public BitQuirky.Behavior.Execution.PendingExternalSlot Pending3Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:652
Saved pending-external slot 3.
ProbabilityCandidateMask
Section titled “ProbabilityCandidateMask”public ulong ProbabilityCandidateMaskSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:614
Saved eligible weighted children, addressed by authored child order.
ReferenceParked
Section titled “ReferenceParked”public byte ReferenceParkedSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:666
Saved parked flag for a reference whose candidates were all ineligible.
Reserved
Section titled “Reserved”public ushort ReservedSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:670
Alignment padding kept zero for additive binary evolution.
SelectedProbabilityChildIndex
Section titled “SelectedProbabilityChildIndex”public int SelectedProbabilityChildIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:612
Saved weighted child selection, carrying the same -1 and -2 sentinels as the live cursor.
SelectedUtilityBranchIndex
Section titled “SelectedUtilityBranchIndex”public int SelectedUtilityBranchIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:620
Saved running Utility Selector branch row, or -1.
StateIndex
Section titled “StateIndex”public int StateIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:591
Baked node index of the state this Push suspended.
SuspendedActionCount
Section titled “SuspendedActionCount”public int SuspendedActionCountSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:674
Rows this frame owns in the suspended-action pool, one per direct action of the suspended state.
SuspendedActionStart
Section titled “SuspendedActionStart”public int SuspendedActionStartSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:672
First row this frame owns in the shared suspended-action pool, forming a (start, count) range with SuspendedActionCount over the BehaviorActionRuntimeState table.
UtilityCandidateMask
Section titled “UtilityCandidateMask”public ulong UtilityCandidateMaskSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:622
Saved eligible Utility Selector branches, addressed by authored source order.
BehaviorTickInvocationKind
Section titled “BehaviorTickInvocationKind”Category: Low-level runtime
enum BitQuirky.Behavior.Execution.BehaviorTickInvocationKindSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:12-22
Underlying type: byte
Identifies a new host observation or a continuation of the current observation.
Members
Section titled “Members”Automatic
Section titled “Automatic”Automatic = 0Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:15
Preserves frame/delta inference: a changed frame or positive delta begins a host step.
HostStep
Section titled “HostStep”HostStep = 1Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:18
Begins a new host step, including zero-delta calls in the same frame.
Microstep
Section titled “Microstep”Microstep = 2Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:21
Continues the current host step without advancing its observation or elapsed time.
BehaviorTickStepResult
Section titled “BehaviorTickStepResult”Category: Low-level runtime
struct BitQuirky.Behavior.Execution.BehaviorTickStepResultSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorTickStepResult.cs:22-32
Result of one tick step over a single agent’s runtime instance. The step emits commands into the External Service Command Queue and updates the runtime instance in place; this struct is returned to the caller for diagnostic / test inspection.
Responsibilities:
- Carry the terminalBehaviorResultCodeand the post-step cursor (CurrentNodeIndex / CurrentStateIndex) so the sample driver and EditMode suites can assert the walk without re-reading the instance.
Does NOT:
- Own any native memory or need disposal: it is a POD snapshot.
Members
Section titled “Members”public BitQuirky.Behavior.Execution.BehaviorResultCode CodeSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorTickStepResult.cs:25
Result the step ended on: Running while the graph still has work, a terminal code when the walk finished, and None when nothing was eligible to run.
CurrentNodeIndex
Section titled “CurrentNodeIndex”public int CurrentNodeIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorTickStepResult.cs:27
Active baked-node index after the step, mirroring the instance cursor; -1 when the step left no node scheduled.
CurrentStateIndex
Section titled “CurrentStateIndex”public int CurrentStateIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorTickStepResult.cs:29
Baked-node index of the active top-level statechart state after the step, or -1 when no state is active.
MachineResult
Section titled “MachineResult”public BitQuirky.Behavior.Execution.BehaviorMachineResult MachineResultSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorTickStepResult.cs:31
Explicit final machine result, or None while the machine remains active.
BehaviorTimeLimitRuntimeState
Section titled “BehaviorTimeLimitRuntimeState”Category: Low-level runtime
struct BitQuirky.Behavior.Execution.BehaviorTimeLimitRuntimeStateSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:343-356
Persistent elapsed state for one baked Time Limit decorator, indexed by its baked node.
Responsibilities:
- Retain the decorator’s own elapsed seconds while its subtree remains active, including across completed sibling children and beneath another Time Limit.
- Distinguish a newly entered decorator from one whose active subtree is continuing.
- Remember the last host step that advanced the clock so immediate zero-delta microsteps cannot consume the selected tick twice, while every timed FixedUpdate step in one render frame still adds its delta.
Does NOT:
- Decide timeout outcomes, sample a clock, or retain elapsed time after the decorator’s subtree is no longer active.
Members
Section titled “Members”ElapsedSeconds
Section titled “ElapsedSeconds”public float ElapsedSecondsSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:346
Elapsed selected-tick seconds since this decorator became active.
HasAdvancedStep
Section titled “HasAdvancedStep”public byte HasAdvancedStepSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:355
Whether LastAdvancedStep contains a valid step.
IsActive
Section titled “IsActive”public byte IsActiveSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:352
Whether the decorator was on the active subtree path on the prior tick.
LastAdvancedStep
Section titled “LastAdvancedStep”public int LastAdvancedStepSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:349
The HostStep that most recently advanced this decorator’s clock.
BehaviorTraceTier
Section titled “BehaviorTraceTier”Category: Low-level runtime
enum BitQuirky.Behavior.Execution.BehaviorTraceTierSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:31-38
Underlying type: byte
Trace verbosity tier for a single follower’s runtime instance. Maps
to the always-on / high-detail tier split described in
data-model.md §Behavior Trace. Defaults to
AlwaysOn; the high-detail tier is opt-in by id and
stripped from shipping builds.
Members
Section titled “Members”AlwaysOn
Section titled “AlwaysOn”AlwaysOn = 0Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:34
The default tier, recorded in every build.
HighDetail
Section titled “HighDetail”HighDetail = 1Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:37
The opt-in per-instance tier, stripped from shipping builds.
BehaviorTransitionConditionRuntimeState
Section titled “BehaviorTransitionConditionRuntimeState”Category: Low-level runtime
struct BitQuirky.Behavior.Execution.BehaviorTransitionConditionRuntimeStateSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:400-410
Responsibilities:
- Retain a member predicate’s exact result across same-tick invocation microsteps. Does NOT:
- Invoke gameplay code or reuse a result in a later host step or state activation.
Members
Section titled “Members”ActivationGeneration
Section titled “ActivationGeneration”public uint ActivationGenerationSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:405
State activation that owns the observation.
HasResult
Section titled “HasResult”public byte HasResultSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:409
One after the operation completed in this observation.
HostStep
Section titled “HostStep”public int HostStepSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:403
Host step that observed the result.
Result
Section titled “Result”public BitQuirky.Behavior.Execution.BehaviorResultCode ResultSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:407
The operation’s exact result.
PendingExternalSlot
Section titled “PendingExternalSlot”Category: Low-level runtime
struct BitQuirky.Behavior.Execution.PendingExternalSlotSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:113-134
One outstanding pending-external slot on a runtime instance. The
runtime instance owns up toMaxPendingExternals
of these so the tick job can resume on completion ring records
without managed allocation.
Members
Section titled “Members”CommandId
Section titled “CommandId”public int CommandIdSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:119
Runtime-issued command id this slot resumes on; FindPendingByCommand matches completion records against it.
FrameIssued
Section titled “FrameIssued”public int FrameIssuedSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:123
Host frame on which the request was posted.
public byte InUseSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:127
One while this slot holds an outstanding request; zero marks it free for TryReservePendingSlot.
OwningNodeIndex
Section titled “OwningNodeIndex”public int OwningNodeIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:125
Baked node index that owns the request, or -1 when the issuing caller named no node.
PendingId
Section titled “PendingId”public int PendingIdSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:121
Service-side request id reported by the wrapped service, which need not equal CommandId.
Reserved0
Section titled “Reserved0”public byte Reserved0Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:129
Reserved byte kept zero for additive binary evolution.
Reserved1
Section titled “Reserved1”public byte Reserved1Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:131
Reserved byte kept zero for additive binary evolution.
Reserved2
Section titled “Reserved2”public byte Reserved2Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:133
Reserved byte kept zero for additive binary evolution.
ServiceId
Section titled “ServiceId”public int ServiceIdSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:117
Stable service-id hash of the external service the outstanding request was posted to.
ReactiveConditionRuntimeState
Section titled “ReactiveConditionRuntimeState”Category: Low-level runtime
struct BitQuirky.Behavior.Execution.ReactiveConditionRuntimeStateSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:480-497
Per-agent state for one artifact-indexed reactive condition.
Responsibilities:
- Retain the last observed status and whether an observation has occurred.
Does NOT:
- Own native memory or identify a baked condition independently of its array index.
Members
Section titled “Members”HasObservation
Section titled “HasObservation”public byte HasObservationSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:487
One after the observer has produced its first status.
LastStatus
Section titled “LastStatus”public BitQuirky.Behavior.Nodes.BehaviorNodeStatus LastStatusSource declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:484
Most recent status returned by this condition observer.
Reserved0
Section titled “Reserved0”public byte Reserved0Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:490
Reserved byte kept zero for additive binary evolution.
Reserved1
Section titled “Reserved1”public byte Reserved1Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:493
Reserved byte kept zero for additive binary evolution.
Reserved2
Section titled “Reserved2”public byte Reserved2Source declaration: Packages/io.bitquirky.behavior/Runtime/Execution/BehaviorExecutionState.cs:496
Reserved byte kept zero for additive binary evolution.
Source fingerprint: sha256:29003d8b1658b98a79bebcd93e3b4030caf8511268b96817ab764d63df8d6c3b