action_path, also included in transitioninput_paths.- Observed transitions containing the actual action and measured result.
- Planning
actions, or a supported dynamicactions_path. state_bindingsmapping predicted targets into the next projected state.- At least an appropriate goal/objective for the task.
futures.enabled: trueand planningenabled: true, probabilistic: true.
values.next_x to values.x means the predicted
next value becomes the current value at the next search step. Without the correct
bindings, increasing horizon does not create a meaningful multi-step problem.
Query with the current state and request transition_plan. For a planner-led
decision, leave the action unset; the planner assigns each candidate action
during evaluation. An explicitly action-conditioned forecast can take precedence
for the stored forecast receipt, so do not forecast one action and report a
different action as its execution.
Execute and replan
Readtransition_plan.status. When it is planned:
- Take
transition_plan.selected_action. - Execute only that first action.
- Report the real result and that decision’s ID.
- Query again using the new observed state.
action_sequence is the candidate sequence explored by the model, not permission
to execute all its actions without observing the environment again.
This is bounded action-sequence planning with replanning, not a full contingent
policy tree for every possible future observation.
selection.selected_policy is a separate output from the contextual policy
selector. Probabilistic planning does not silently replace it. An application
using this planner must deliberately consume transition_plan.selected_action.
Inspect the plan
Inspectselected_action, action_sequence, expected_utility,
lower_tail_utility, goal_probability, failure_probability,
failure_probability_upper, unresolved_probability, probability_mass,
trajectories, candidate_sequences and rejected_sequences.
The selected action’s first-step distribution is available as
transition_plan.futures. This is especially useful when the ordinary forecast
abstains because no action was supplied in the query.
Constraint-failing branches and unsupported probability mass remain visible.
They are not silently dropped to make the remaining plan look safer. Probability
estimates describe the learned model; they are not certified safety bounds.