ActionEvent: Construct an ActionEvent

View source: R/decision_points.R

ActionEventR Documentation

Construct an ActionEvent

Description

Timeline-native action proposed by a policy at a decision point. ActionEvents enter the same arbitration and refresh lifecycle as all other events — no side-channel state mutation.

Usage

ActionEvent(
  action_type,
  time_next,
  decision_point_id = NULL,
  params = NULL,
  metadata = NULL
)

Arguments

action_type

Character scalar; must match an allowed_actions entry if the decision point declared any.

time_next

Numeric scalar; realization time on the canonical timeline.

decision_point_id

Character scalar; which decision point produced this action. If NULL (the default), the engine fills this in automatically from the firing decision point's id. During a policy call, an explicitly supplied value must exactly match the firing decision point. Outside policy dispatch, the field may be used to construct a self-described action.

params

Optional named list of action-specific parameters.

metadata

Optional named list for policy provenance or audit fields.

Value

A list of class "ActionEvent".


fluxCore documentation built on Sept. 22, 2026, 5:07 p.m.