UtilityAction

Candidate action evaluated and executed by UtilityAI.

Constructor

new UtilityAction(config)

Parameters:
NameTypeDescription
configObject

Action configuration.

Properties
NameTypeAttributesDefaultDescription
idstring

Action identifier.

prioritynumber<optional>
0

Deterministic tie-breaking and interruption priority.

weightnumber<optional>
1.0

Action utility weight multiplier.

thresholdnumber<optional>

Action-specific minimum utility threshold.

considerationsArray<optional>
[]

Considerations list.

compositeModestring<optional>
"multiplicative"

"multiplicative" or "average".

executefunction<optional>

Execution function called when action is chosen.

cleanupfunction<optional>

Cleanup function called when action ends or is interrupted.

onInterruptfunction<optional>

Callback called when action is interrupted.

onExitfunction<optional>

Callback called on exit.

updatefunction<optional>

Per-tick update function while active.

Classes

UtilityAction

Methods

addConsideration(consideration) → {UtilityAction}

Adds a consideration to this action.

Parameters:
NameTypeDescription
considerationUtilityConsideration | Object | function

Consideration instance or config.

Returns:

Self for chaining.

Type: 
UtilityAction

evaluate(context) → {Object}

Evaluates all composite considerations for this action against context.

Parameters:
NameTypeDescription
contextObject

Game context data.

Returns:

Evaluation summary including composite utility score.

Type: 
Object