Skip to content
Bit Quirky Behavior Trees and
State Machines

Search documentation

All topics and APIs

Close returns focus to Search.

What are you looking for?

Try a common topic or enter a complete API identifier.

Browse the reference instead

Esc closes · Tab reaches results · Enter opens the focused link

v0.11.0
Menu

Assembly: BitQuirky.Behavior.Runtime.Backend

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.AuthorityAttribute

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:188-201

Inherits: Attribute

Declares the authority context the node ticks under.

C#
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.

C#
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.

Category: Node contracts

C#
enum BitQuirky.Behavior.Nodes.AuthorityHandoffResolution

Source 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).

C#
Abort = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:36

Drop the node to a typedauthority-handofffailure.

C#
Restart = 0

Source 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.

C#
Resume = 1

Source 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).

Category: Node contracts

C#
readonly struct BitQuirky.Behavior.Nodes.AwaitedExternalDescriptor

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:365-385

One(serviceId, pendingIdField)pair extracted from an AwaitsExternalAttribute.

C#
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.

C#
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)”
C#
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.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.AwaitsExternalAttribute

Source 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).

C#
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.

C#
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)”
C#
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.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.BehaviorBuiltInAuthoringRegistry

Source 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.

C#
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.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.BehaviorNodeAttribute

Source 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.

C#
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)”
C#
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.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.BehaviorNodeParameterAttribute

Source 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.

C#
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.

C#
public string DisplayLabel { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:151

Gets the lowercase editor label.

C#
public int InspectorOrder { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:157

Gets the deterministic inspector position.

C#
public string Key { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:148

Gets the stable source parameter key.

C#
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.

C#
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.

C#
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.

C#
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.

C#
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.

C#
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.

C#
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)”
C#
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.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.BehaviorNodeParameterDescriptor

Source 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.

C#
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.

C#
public string DisplayLabel { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:558

Gets the lowercase editor label.

C#
public int InspectorOrder { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:564

Gets the deterministic inspector position.

C#
public string Key { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:555

Gets the stable source parameter key.

C#
public double Maximum { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:576

Gets the inclusive numeric upper bound.

C#
public double Minimum { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:573

Gets the inclusive numeric lower bound.

C#
public int PayloadSlot { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:570

Gets the payload slot, or NoPayloadSlot when unused.

C#
public bool Required { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:567

Gets whether a source value is required.

C#
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.

C#
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.

C#
public BitQuirky.Behavior.Nodes.BehaviorNodeParameterType Type { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:561

Gets the semantic value type.

C#
public const int MaximumPayloadSlot = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:427

The largest supported zero-based command payload slot.

C#
public const int NoPayloadSlot = -1

Source 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)”
C#
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)”
C#
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.

Category: Node contracts

C#
enum BitQuirky.Behavior.Nodes.BehaviorNodeParameterType

Source 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.

C#
Bool = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:80

A Boolean value.

C#
EnumToken = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:77

A stable lowercase token selected from a declared set.

C#
Float32 = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:71

A 32-bit floating-point value.

C#
Int32 = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:74

A signed 32-bit integer value.

Category: Node contracts

C#
enum BitQuirky.Behavior.Nodes.DeterminismClass

Source 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.

C#
Deterministic = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:48

Same input -> same output across host and client. Default.

C#
HostOnlyNonDeterministic = 1

Source 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.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.DeterminismClassAttribute

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:339-355

Inherits: Attribute

Declares the node’s determinism class. Defaults to Deterministicif absent.

C#
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)”
C#
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.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.NodeAuthoringDescriptor

Source 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.

C#
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.

C#
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.

C#
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.

C#
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.

C#
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_]*.

C#
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.

C#
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.

C#
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.

C#
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.

C#
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)”
C#
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)”
C#
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)”
C#
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.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.NodeAuthoringDescriptorReader

Source 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.

C#
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.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.NodeAuthoringRegistry

Source 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).

C#
public int Count { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:948

Gets the number of registered node schemas.

C#
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)”
C#
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.

C#
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)”
C#
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)”
C#
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)”
C#
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)”
C#
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.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.OnAuthorityHandoffAttribute

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:316-333

Inherits: Attribute

Declares the node’s behavior on host migration.

C#
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)”
C#
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.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.PayloadFieldAttribute

Source 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.

C#
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.

C#
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)”
C#
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.

Category: Node contracts

C#
readonly struct BitQuirky.Behavior.Nodes.PayloadFieldDescriptor

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/NodeAuthoringAttributes.cs:391-408

One explicit service-command payload mapping extracted from a PayloadFieldAttribute.

C#
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.

C#
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)”
C#
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.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.ReadFieldAttribute

Source 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.

C#
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.

C#
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.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.WriteFieldAttribute

Source 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.

C#
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)”
C#
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

Full-size image