BitQuirky.Behavior.Nodes
Public behavior trees and state machines: runtime backend symbols in BitQuirky.Behavior.Nodes.
Source snapshot 29003d8b1658.
On this page
Assembly: BitQuirky.Behavior.Runtime.Backend
AuthorityAttribute
Section titled “AuthorityAttribute”Category: Node contracts
class BitQuirky.Behavior.Nodes.AuthorityAttributeSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:188-201
Inherits: Attribute
Declares the authority context the node ticks under.
Members
Section titled “Members”public BitQuirky.Behavior.Authority.AuthorityKind Kind { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:200
Gets the authority context every node of this type ticks under.
AuthorityAttribute(AuthorityKind kind)
Section titled “AuthorityAttribute(AuthorityKind kind)”public AuthorityAttribute(BitQuirky.Behavior.Authority.AuthorityKind kind)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:194-197
Declares the authority context every node of this type ticks under.
AuthorityHandoffResolution
Section titled “AuthorityHandoffResolution”Category: Node contracts
enum BitQuirky.Behavior.Nodes.AuthorityHandoffResolutionSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:18-37
Underlying type: byte
Resolution strategy when host-migration interrupts an active node that has outstanding awaited externals (R-9).
Members
Section titled “Members”Abort = 2Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:36
Drop the node to a typedauthority-handofffailure.
Restart
Section titled “Restart”Restart = 0Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:24
Cancel pending ids and restart the node from scratch on the new authority. Default. Always safe.
Resume
Section titled “Resume”Resume = 1Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:31
Resume the in-flight request on the new authority via adapter-supported replay-by-id. Only legal if the adapter for EVERY awaited external supports replay (validator enforces).
AwaitedExternalDescriptor
Section titled “AwaitedExternalDescriptor”Category: Node contracts
readonly struct BitQuirky.Behavior.Nodes.AwaitedExternalDescriptorSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:365-385
One(serviceId, pendingIdField)pair extracted from an
AwaitsExternalAttribute.
Members
Section titled “Members”PendingIdField
Section titled “PendingIdField”public string PendingIdField { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:384
Gets the stable blackboard field id holding the outstanding request id, or empty when the node does not resume on completion.
ServiceId
Section titled “ServiceId”public string ServiceId { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:378
Gets the stable id of the awaited external service.
AwaitedExternalDescriptor(string serviceId, string pendingIdField)
Section titled “AwaitedExternalDescriptor(string serviceId, string pendingIdField)”public AwaitedExternalDescriptor(string serviceId, string pendingIdField)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:371-375
Captures one awaited-external pair. A null argument is stored as an empty string; an
emptypendingIdFieldmeans the node does not resume on completion.
AwaitsExternalAttribute
Section titled “AwaitsExternalAttribute”Category: Node contracts
class BitQuirky.Behavior.Nodes.AwaitsExternalAttributeSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:255-282
Inherits: Attribute
Declares an external service the node may issue commands to and the
blackboard field id it stores the resultingpendingRequestId
in.PendingIdFieldmay be empty if the node fires a
command and forgets (no resume).
Members
Section titled “Members”PendingIdField
Section titled “PendingIdField”public string PendingIdField { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:281
Gets the stable blackboard field id that stores the outstanding request id, or empty for a fire-and-forget command.
ServiceId
Section titled “ServiceId”public string ServiceId { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:275
Gets the stable id of the external service, cross-checked against the source node’s
%% waits=list.
AwaitsExternalAttribute(string serviceId, string pendingIdField)
Section titled “AwaitsExternalAttribute(string serviceId, string pendingIdField)”public AwaitsExternalAttribute(string serviceId, string pendingIdField = "")Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:265-269
Declares one external service this node issues commands to. Omit
pendingIdFieldfor a fire-and-forget command; supply it to name
the blackboard field holding the outstanding request id the node resumes on.
Parameters
serviceId: Stable external-service id, cross-checked against the source node’s%% waits=list.pendingIdField: Blackboard field id storing the outstanding request id, or empty for no resume.
BehaviorBuiltInAuthoringRegistry
Section titled “BehaviorBuiltInAuthoringRegistry”Category: Node contracts
class BitQuirky.Behavior.Nodes.BehaviorBuiltInAuthoringRegistrySource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:1099-1468
Creates operation-local registries for package-owned node schemas.
Responsibilities:
- Compose Repeat and Move To descriptors plus the generic condition parameter schema without global mutable state.
Does NOT:
- Discover consumer schemas or validation extensions.
Members
Section titled “Members”Create()
Section titled “Create()”public static BitQuirky.Behavior.Nodes.NodeAuthoringRegistry Create()Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:1102-1383
Creates a fresh registry containing all package-owned schemas.
BehaviorNodeAttribute
Section titled “BehaviorNodeAttribute”Category: Node contracts
class BitQuirky.Behavior.Nodes.BehaviorNodeAttributeSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:99-116
Inherits: Attribute
Marks a class as a behavior node and binds it to the Mermaid
:::<token> class suffix (e.g. :::action,
:::condition). The token is the authoritative cross-boundary
id between authoring (.bqbehavior) and runtime registration.
Members
Section titled “Members”NodeKindToken
Section titled “NodeKindToken”public string NodeKindToken { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:115
The Mermaid:::<token>suffix identifying this node
type. Must be a stable id of the form[a-z][a-z0-9_]*.
BehaviorNodeAttribute(string nodeKindToken)
Section titled “BehaviorNodeAttribute(string nodeKindToken)”public BehaviorNodeAttribute(string nodeKindToken)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:106-109
Binds the node class to its Mermaid:::<token>class suffix. A null token
is stored as an empty string, which the registration scan then rejects.
BehaviorNodeParameterAttribute
Section titled “BehaviorNodeParameterAttribute”Category: Node contracts
class BitQuirky.Behavior.Nodes.BehaviorNodeParameterAttributeSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:129-183
Inherits: Attribute
Declares one typed semantic parameter on a behavior node class.
Responsibilities:
- Provide reflection-readable authoring schema metadata.
- Identify inspector order, requirement state, numeric bounds, enum tokens, and an optional external-service payload slot.
Does NOT:
- Store an authored value or perform runtime parsing.
Members
Section titled “Members”AllowedEnumTokens
Section titled “AllowedEnumTokens”public string[] AllowedEnumTokens { get; set; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:172
Gets or sets the allowed values for an enum-token parameter.
DisplayLabel
Section titled “DisplayLabel”public string DisplayLabel { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:151
Gets the lowercase editor label.
InspectorOrder
Section titled “InspectorOrder”public int InspectorOrder { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:157
Gets the deterministic inspector position.
public string Key { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:148
Gets the stable source parameter key.
Maximum
Section titled “Maximum”public double Maximum { get; set; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:169
Gets or sets the inclusive numeric upper bound.
Minimum
Section titled “Minimum”public double Minimum { get; set; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:166
Gets or sets the inclusive numeric lower bound.
PayloadSlot
Section titled “PayloadSlot”public int PayloadSlot { get; set; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:163
Gets or sets the external-command payload slot, or -1 when unused.
Required
Section titled “Required”public bool Required { get; set; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:160
Gets or sets whether a source value is required.
RequiredWhenParameterKey
Section titled “RequiredWhenParameterKey”public string RequiredWhenParameterKey { get; set; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:177
Gets or sets the stable key whose value conditionally requires this parameter.
RequiredWhenParameterValue
Section titled “RequiredWhenParameterValue”public string RequiredWhenParameterValue { get; set; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:182
Gets or sets the exact source value that conditionally requires this parameter.
public BitQuirky.Behavior.Nodes.BehaviorNodeParameterType Type { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:154
Gets the semantic value type.
BehaviorNodeParameterAttribute(string key, string displayLabel, BehaviorNodeParameterType type, int inspectorOrder)
Section titled “BehaviorNodeParameterAttribute(string key, string displayLabel, BehaviorNodeParameterType type, int inspectorOrder)”public BehaviorNodeParameterAttribute(string key, string displayLabel, BitQuirky.Behavior.Nodes.BehaviorNodeParameterType type, int inspectorOrder)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:135-145
Creates a parameter declaration with its stable key and deterministic inspector order.
BehaviorNodeParameterDescriptor
Section titled “BehaviorNodeParameterDescriptor”Category: Node contracts
class BitQuirky.Behavior.Nodes.BehaviorNodeParameterDescriptorSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:421-617
Immutable schema for one typed semantic node parameter.
Responsibilities:
- Define the stable source key, editor label, value type, display order, requirement state, optional payload slot, numeric bounds, and allowed enum tokens.
- Reject malformed schema at composition time.
Does NOT:
- Hold an authored value or mutate source text.
Members
Section titled “Members”AllowedEnumTokens
Section titled “AllowedEnumTokens”public System.Collections.Generic.IReadOnlyList<string> AllowedEnumTokens { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:579
Gets the allowed enum tokens in declaration order.
DisplayLabel
Section titled “DisplayLabel”public string DisplayLabel { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:558
Gets the lowercase editor label.
InspectorOrder
Section titled “InspectorOrder”public int InspectorOrder { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:564
Gets the deterministic inspector position.
public string Key { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:555
Gets the stable source parameter key.
Maximum
Section titled “Maximum”public double Maximum { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:576
Gets the inclusive numeric upper bound.
Minimum
Section titled “Minimum”public double Minimum { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:573
Gets the inclusive numeric lower bound.
PayloadSlot
Section titled “PayloadSlot”public int PayloadSlot { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:570
Gets the payload slot, or NoPayloadSlot when unused.
Required
Section titled “Required”public bool Required { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:567
Gets whether a source value is required.
RequiredWhenParameterKey
Section titled “RequiredWhenParameterKey”public string RequiredWhenParameterKey { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:582
Gets the parameter key that activates the conditional requirement.
RequiredWhenParameterValue
Section titled “RequiredWhenParameterValue”public string RequiredWhenParameterValue { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:585
Gets the parameter value that activates the conditional requirement.
public BitQuirky.Behavior.Nodes.BehaviorNodeParameterType Type { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:561
Gets the semantic value type.
MaximumPayloadSlot
Section titled “MaximumPayloadSlot”public const int MaximumPayloadSlot = 4Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:427
The largest supported zero-based command payload slot.
NoPayloadSlot
Section titled “NoPayloadSlot”public const int NoPayloadSlot = -1Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:424
Indicates that the parameter does not populate a command payload slot.
BehaviorNodeParameterDescriptor(string key, string displayLabel, BehaviorNodeParameterType type, int inspectorOrder, bool required, int payloadSlot, double minimum, double maximum, IReadOnlyList<string> allowedEnumTokens)
Section titled “BehaviorNodeParameterDescriptor(string key, string displayLabel, BehaviorNodeParameterType type, int inspectorOrder, bool required, int payloadSlot, double minimum, double maximum, IReadOnlyList<string> allowedEnumTokens)”public BehaviorNodeParameterDescriptor(string key, string displayLabel, BitQuirky.Behavior.Nodes.BehaviorNodeParameterType type, int inspectorOrder, bool required, int payloadSlot, double minimum, double maximum, System.Collections.Generic.IReadOnlyList<string> allowedEnumTokens)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:432-455
Creates and validates an immutable semantic parameter schema.
BehaviorNodeParameterDescriptor(string key, string displayLabel, BehaviorNodeParameterType type, int inspectorOrder, bool required, int payloadSlot, double minimum, double maximum, IReadOnlyList<string> allowedEnumTokens, string requiredWhenParameterKey, string requiredWhenParameterValue)
Section titled “BehaviorNodeParameterDescriptor(string key, string displayLabel, BehaviorNodeParameterType type, int inspectorOrder, bool required, int payloadSlot, double minimum, double maximum, IReadOnlyList<string> allowedEnumTokens, string requiredWhenParameterKey, string requiredWhenParameterValue)”public BehaviorNodeParameterDescriptor(string key, string displayLabel, BitQuirky.Behavior.Nodes.BehaviorNodeParameterType type, int inspectorOrder, bool required, int payloadSlot, double minimum, double maximum, System.Collections.Generic.IReadOnlyList<string> allowedEnumTokens, string requiredWhenParameterKey, string requiredWhenParameterValue)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:461-552
Creates and validates an immutable semantic parameter schema with an optional conditional requirement.
BehaviorNodeParameterType
Section titled “BehaviorNodeParameterType”Category: Node contracts
enum BitQuirky.Behavior.Nodes.BehaviorNodeParameterTypeSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:68-81
Underlying type: byte
Supported semantic parameter value types.
Responsibilities:
- Give authoring, validation, and baking one stable type vocabulary.
Does NOT:
- Store a parameter value or define its runtime representation.
Members
Section titled “Members”Bool = 3Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:80
A Boolean value.
EnumToken
Section titled “EnumToken”EnumToken = 2Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:77
A stable lowercase token selected from a declared set.
Float32
Section titled “Float32”Float32 = 0Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:71
A 32-bit floating-point value.
Int32 = 1Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:74
A signed 32-bit integer value.
DeterminismClass
Section titled “DeterminismClass”Category: Node contracts
enum BitQuirky.Behavior.Nodes.DeterminismClassSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:43-57
Underlying type: byte
Determinism class declared on a node, per section Required declarations.
Members
Section titled “Members”Deterministic
Section titled “Deterministic”Deterministic = 0Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:48
Same input -> same output across host and client. Default.
HostOnlyNonDeterministic
Section titled “HostOnlyNonDeterministic”HostOnlyNonDeterministic = 1Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:56
Tick reads sources of host-only entropy (RNG, scene-graph queries, wallclock). MUST also be HostAuthoritative; the validator rejects non-host instances.
DeterminismClassAttribute
Section titled “DeterminismClassAttribute”Category: Node contracts
class BitQuirky.Behavior.Nodes.DeterminismClassAttributeSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:339-355
Inherits: Attribute
Declares the node’s determinism class. Defaults to Deterministicif absent.
Members
Section titled “Members”Determinism
Section titled “Determinism”public BitQuirky.Behavior.Nodes.DeterminismClass Determinism { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:354
Gets the determinism class applied to every node of this type. The bake stamps it onto the baked node and the validator enforces the authority pairing it implies.
DeterminismClassAttribute(DeterminismClass determinism)
Section titled “DeterminismClassAttribute(DeterminismClass determinism)”public DeterminismClassAttribute(BitQuirky.Behavior.Nodes.DeterminismClass determinism)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:345-348
Declares the determinism class the bake stamps onto every baked node of this type.
NodeAuthoringDescriptor
Section titled “NodeAuthoringDescriptor”Category: Node contracts
class BitQuirky.Behavior.Nodes.NodeAuthoringDescriptorSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:625-826
Snapshot of the authoring metadata declared on a node type via
attributes. The bake-time validator (BehaviorValidator)
consumes this to cross-check against the per-node%% authority=... read=... write=... waits=...metadata block in the .bqbehavior source.
Members
Section titled “Members”Authority
Section titled “Authority”public BitQuirky.Behavior.Authority.AuthorityKind Authority { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:708
The authority context nodes of this type must declare. The validator reports
node-authority-mismatch when a source node’s %% authority=differs.
AwaitedExternals
Section titled “AwaitedExternals”public System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Nodes.AwaitedExternalDescriptor> AwaitedExternals { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:729
External services the node issues commands to, each paired with the blackboard field
holding the outstanding request id. Their service ids are compared as a set against the
source node’s%% waits= list (node-waits-mismatch). Empty declares that
the node never waits on a completion.
Determinism
Section titled “Determinism”public BitQuirky.Behavior.Nodes.DeterminismClass Determinism { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:749
The node’s determinism class, which the bake stamps onto every baked node of this type. Host-only-non-deterministic additionally forces host authority, and a client-presentation node must be deterministic. Deterministic when the node type declares nothing.
HandoffResolution
Section titled “HandoffResolution”public BitQuirky.Behavior.Nodes.AuthorityHandoffResolution HandoffResolution { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:742
What the runtime does with the node’s in-flight awaited externals when authority migrates. Restart when the node type declares nothing.
NodeKindToken
Section titled “NodeKindToken”public string NodeKindToken { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:702
The stable:::<token>id binding this schema to every source node carrying
the same suffix. Always matches[a-z][a-z0-9_]*.
NodeType
Section titled “NodeType”public System.Type NodeType { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:696
The node class the attributes were read from. Lookup keys on NodeKindToken, not on this type.
Parameters
Section titled “Parameters”public System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Nodes.BehaviorNodeParameterDescriptor> Parameters { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:752
Gets typed parameter schemas in deterministic inspector order.
PayloadFields
Section titled “PayloadFields”public System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Nodes.PayloadFieldDescriptor> PayloadFields { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:736
Blackboard fields the bake copies into external-service command payload slots, as stable field ids resolved per slot. The validator rejects a slot outside 0-3 and any field missing from the node’s read set. Empty means the node sends no payload.
ReadSet
Section titled “ReadSet”public System.Collections.Generic.IReadOnlyList<string> ReadSet { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:714
Stable blackboard field ids the tick reads, compared as a set against the source node’s
%% read= list (node-read-mismatch). Empty declares no reads.
WriteSet
Section titled “WriteSet”public System.Collections.Generic.IReadOnlyList<string> WriteSet { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:721
Stable blackboard field ids and external-service ids the tick writes, compared as a set
against the source node’s%% write= list (node-write-mismatch). Empty
declares no writes.
NodeAuthoringDescriptor(Type nodeType, string nodeKindToken, AuthorityKind authority, IReadOnlyList<string> readSet, IReadOnlyList<string> writeSet, IReadOnlyList<AwaitedExternalDescriptor> awaitedExternals, IReadOnlyList<PayloadFieldDescriptor> payloadFields, AuthorityHandoffResolution handoff, DeterminismClass determinism)
Section titled “NodeAuthoringDescriptor(Type nodeType, string nodeKindToken, AuthorityKind authority, IReadOnlyList<string> readSet, IReadOnlyList<string> writeSet, IReadOnlyList<AwaitedExternalDescriptor> awaitedExternals, IReadOnlyList<PayloadFieldDescriptor> payloadFields, AuthorityHandoffResolution handoff, DeterminismClass determinism)”public NodeAuthoringDescriptor(System.Type nodeType, string nodeKindToken, BitQuirky.Behavior.Authority.AuthorityKind authority, System.Collections.Generic.IReadOnlyList<string> readSet, System.Collections.Generic.IReadOnlyList<string> writeSet, System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Nodes.AwaitedExternalDescriptor> awaitedExternals, System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Nodes.PayloadFieldDescriptor> payloadFields, BitQuirky.Behavior.Nodes.AuthorityHandoffResolution handoff, BitQuirky.Behavior.Nodes.DeterminismClass determinism)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:630-652
Creates an immutable node schema without typed semantic parameters.
NodeAuthoringDescriptor(Type nodeType, string nodeKindToken, AuthorityKind authority, IReadOnlyList<string> readSet, IReadOnlyList<string> writeSet, IReadOnlyList<AwaitedExternalDescriptor> awaitedExternals, IReadOnlyList<PayloadFieldDescriptor> payloadFields, AuthorityHandoffResolution handoff, DeterminismClass determinism, IReadOnlyList<BehaviorNodeParameterDescriptor> parameters)
Section titled “NodeAuthoringDescriptor(Type nodeType, string nodeKindToken, AuthorityKind authority, IReadOnlyList<string> readSet, IReadOnlyList<string> writeSet, IReadOnlyList<AwaitedExternalDescriptor> awaitedExternals, IReadOnlyList<PayloadFieldDescriptor> payloadFields, AuthorityHandoffResolution handoff, DeterminismClass determinism, IReadOnlyList<BehaviorNodeParameterDescriptor> parameters)”public NodeAuthoringDescriptor(System.Type nodeType, string nodeKindToken, BitQuirky.Behavior.Authority.AuthorityKind authority, System.Collections.Generic.IReadOnlyList<string> readSet, System.Collections.Generic.IReadOnlyList<string> writeSet, System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Nodes.AwaitedExternalDescriptor> awaitedExternals, System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Nodes.PayloadFieldDescriptor> payloadFields, BitQuirky.Behavior.Nodes.AuthorityHandoffResolution handoff, BitQuirky.Behavior.Nodes.DeterminismClass determinism, System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Nodes.BehaviorNodeParameterDescriptor> parameters)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:658-690
Creates an immutable node schema from explicitly supplied authoring metadata and typed semantic parameters.
TryGetParameter(string parameterKey, out BehaviorNodeParameterDescriptor descriptor)
Section titled “TryGetParameter(string parameterKey, out BehaviorNodeParameterDescriptor descriptor)”public bool TryGetParameter(string parameterKey, out BitQuirky.Behavior.Nodes.BehaviorNodeParameterDescriptor descriptor)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:755-770
Resolves one parameter schema by its stable source key.
NodeAuthoringDescriptorReader
Section titled “NodeAuthoringDescriptorReader”Category: Node contracts
class BitQuirky.Behavior.Nodes.NodeAuthoringDescriptorReaderSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:834-921
Reflection-driven reader. Pulls a NodeAuthoringDescriptoroff any type carrying the authoring attributes. Designed to run at editor / boot time, NOT on the tick hot path.
Members
Section titled “Members”Read(Type nodeType)
Section titled “Read(Type nodeType)”public static BitQuirky.Behavior.Nodes.NodeAuthoringDescriptor Read(System.Type nodeType)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:843-918
Read a descriptor fromnodeType. Throws
ArgumentNullExceptionif the type is null. Returns
null when the type carries noBehaviorNodeAttribute.
NodeAuthoringRegistry
Section titled “NodeAuthoringRegistry”Category: Node contracts
class BitQuirky.Behavior.Nodes.NodeAuthoringRegistrySource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:939-1087
Registry of node-kind tokens to authoring descriptors. Populated at boot by scanning loaded assemblies (or constructed by hand in tests). The validator consults the registry when declared.
Responsibilities:
- Map a Mermaid
:::<token>suffix to its NodeAuthoringDescriptor. - Refuse duplicate registrations of the same token (a single token cannot resolve to two C# types).
Does NOT:
- Construct or invoke node instances - that’s the runtime tick’s concern.
- Drive Burst dispatch - separate concern (BehaviorTickJob).
Members
Section titled “Members”public int Count { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:948
Gets the number of registered node schemas.
public System.Collections.Generic.IEnumerable<BitQuirky.Behavior.Nodes.NodeAuthoringDescriptor> All()Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:1080-1086
Enumerates all node schemas in ordinal node-kind-token order.
Compose(params IEnumerable<NodeAuthoringDescriptor>[] descriptorSets)
Section titled “Compose(params IEnumerable<NodeAuthoringDescriptor>[] descriptorSets)”public static BitQuirky.Behavior.Nodes.NodeAuthoringRegistry Compose(params System.Collections.Generic.IEnumerable<BitQuirky.Behavior.Nodes.NodeAuthoringDescriptor>[] descriptorSets)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:953-977
Creates a fresh operation-local registry from explicit descriptor sets.
GetParameters(string nodeKindToken)
Section titled “GetParameters(string nodeKindToken)”public System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Nodes.BehaviorNodeParameterDescriptor> GetParameters(string nodeKindToken)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:1066-1077
Gets semantic parameter schemas for one stable node-kind token.
Register(NodeAuthoringDescriptor descriptor)
Section titled “Register(NodeAuthoringDescriptor descriptor)”public void Register(BitQuirky.Behavior.Nodes.NodeAuthoringDescriptor descriptor)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:980-993
Registers one node schema and rejects duplicate node-kind tokens.
RegisterParameterSchema(string nodeKindToken, IReadOnlyList<BehaviorNodeParameterDescriptor> parameters)
Section titled “RegisterParameterSchema(string nodeKindToken, IReadOnlyList<BehaviorNodeParameterDescriptor> parameters)”public void RegisterParameterSchema(string nodeKindToken, System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Nodes.BehaviorNodeParameterDescriptor> parameters)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:999-1029
Registers semantic parameters for a generic node whose read and write metadata remain source-defined.
TryGet(string nodeKindToken, out NodeAuthoringDescriptor descriptor)
Section titled “TryGet(string nodeKindToken, out NodeAuthoringDescriptor descriptor)”public bool TryGet(string nodeKindToken, out BitQuirky.Behavior.Nodes.NodeAuthoringDescriptor descriptor)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:1032-1035
Resolves one node schema by its stable node-kind token.
TryGetParameter(string nodeKindToken, string parameterKey, out BehaviorNodeParameterDescriptor descriptor)
Section titled “TryGetParameter(string nodeKindToken, string parameterKey, out BehaviorNodeParameterDescriptor descriptor)”public bool TryGetParameter(string nodeKindToken, string parameterKey, out BitQuirky.Behavior.Nodes.BehaviorNodeParameterDescriptor descriptor)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:1038-1063
Resolves one parameter schema by stable node and parameter tokens.
OnAuthorityHandoffAttribute
Section titled “OnAuthorityHandoffAttribute”Category: Node contracts
class BitQuirky.Behavior.Nodes.OnAuthorityHandoffAttributeSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:316-333
Inherits: Attribute
Declares the node’s behavior on host migration.
Members
Section titled “Members”Resolution
Section titled “Resolution”public BitQuirky.Behavior.Nodes.AuthorityHandoffResolution Resolution { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:332
Gets the resolution the runtime applies to this node’s in-flight awaited externals when authority migrates.
OnAuthorityHandoffAttribute(AuthorityHandoffResolution resolution)
Section titled “OnAuthorityHandoffAttribute(AuthorityHandoffResolution resolution)”public OnAuthorityHandoffAttribute(BitQuirky.Behavior.Nodes.AuthorityHandoffResolution resolution)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:323-326
Declares what the runtime does to this node’s in-flight awaited externals when authority migrates to another host.
PayloadFieldAttribute
Section titled “PayloadFieldAttribute”Category: Node contracts
class BitQuirky.Behavior.Nodes.PayloadFieldAttributeSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:290-311
Inherits: Attribute
Declares the blackboard field copied into a service command payload
slot. Slots map directly to
Payload0
throughPayload3.
Members
Section titled “Members”FieldId
Section titled “FieldId”public string FieldId { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:310
Gets the stable blackboard field id copied into the slot. It must also appear in the
node’s read set, or the bake reportsnode-payload-read-mismatch.
public int Slot { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:304
Gets the zero-based command payload slot; the validator requires 0 through 3.
PayloadFieldAttribute(int slot, string fieldId)
Section titled “PayloadFieldAttribute(int slot, string fieldId)”public PayloadFieldAttribute(int slot, string fieldId)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:297-301
Declares that one blackboard field supplies a command payload slot. The validator requires a slot of 0 through 3; a null field id is stored as an empty string.
PayloadFieldDescriptor
Section titled “PayloadFieldDescriptor”Category: Node contracts
readonly struct BitQuirky.Behavior.Nodes.PayloadFieldDescriptorSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:391-408
One explicit service-command payload mapping extracted from a PayloadFieldAttribute.
Members
Section titled “Members”FieldId
Section titled “FieldId”public string FieldId { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:407
Gets the stable blackboard field id supplying the slot’s value.
public int Slot { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:404
Gets the zero-based command payload slot the field value is copied into.
PayloadFieldDescriptor(int slot, string fieldId)
Section titled “PayloadFieldDescriptor(int slot, string fieldId)”public PayloadFieldDescriptor(int slot, string fieldId)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:397-401
Captures one payload mapping: the zero-based command payload slot and the blackboard field id supplying it. A null field id is stored as an empty string.
ReadFieldAttribute
Section titled “ReadFieldAttribute”Category: Node contracts
class BitQuirky.Behavior.Nodes.ReadFieldAttributeSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:208-222
Inherits: Attribute
Declares a blackboard field id the tick reads. Repeat for each id;
the bake intersects these with the source-sidereadmetadata
block to reject mismatches.
Members
Section titled “Members”FieldId
Section titled “FieldId”public string FieldId { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:221
Gets the stable blackboard field id the tick reads.
ReadFieldAttribute(string fieldId)
Section titled “ReadFieldAttribute(string fieldId)”public ReadFieldAttribute(string fieldId)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:215-218
Declares one blackboard field id the tick reads. A null id is stored as an empty
string, which the bake rejects against the source-sidereadblock.
WriteFieldAttribute
Section titled “WriteFieldAttribute”Category: Node contracts
class BitQuirky.Behavior.Nodes.WriteFieldAttributeSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:229-247
Inherits: Attribute
Declares a blackboard field id OR an external-service queue id the
tick writes. The bake disambiguates by scanning the source’s
%% fields: and %% services:declaration blocks.
Members
Section titled “Members”FieldOrServiceId
Section titled “FieldOrServiceId”public string FieldOrServiceId { get; }Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:246
Gets the declared write target: either a stable blackboard field id or an external-service id.
WriteFieldAttribute(string fieldOrServiceId)
Section titled “WriteFieldAttribute(string fieldOrServiceId)”public WriteFieldAttribute(string fieldOrServiceId)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:237-240
Declares one write target: a blackboard field id or an external-service queue id. A null id is stored as an empty string. The bake decides which kind it is by scanning the source’s declaration blocks.
Source fingerprint: sha256:29003d8b1658b98a79bebcd93e3b4030caf8511268b96817ab764d63df8d6c3b