Skip to content

simulatecraft.planning.planner

simulatecraft.planning.planner

Hierarchical plan generation & re-planning. Optional: brains without long-horizon needs can ignore this module entirely.

LLM calls are injected as callables, keeping this module dependency-free.

Planner 

Planner(generator: PlanGenerator, *, replan_checker: ReplanChecker | None = None)

Holds the current plan; delegates generation/checking to injected policies.

Source code in src/simulatecraft/planning/planner.py 
53
54
55
56
57
58
59
60
61
def __init__(
    self,
    generator: PlanGenerator,
    *,
    replan_checker: ReplanChecker | None = None,
) -> None:
    self.generator = generator
    self.replan_checker = replan_checker
    self.current_plan: Plan | None = None

maybe_replan async 

maybe_replan(observation_summary: str) -> bool

True when the checker says reality contradicts the plan.

Source code in src/simulatecraft/planning/planner.py 
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
async def maybe_replan(self, observation_summary: str) -> bool:
    """True when the checker says reality contradicts the plan."""
    if self.current_plan is None:
        return False
    if self.replan_checker is None:
        heuristic = self.current_plan.done()
        if heuristic:
            self.current_plan = None
        return heuristic
    contradicted = await _maybe_await(
        self.replan_checker(observation_summary, self.current_plan)
    )
    if contradicted:
        self.current_plan = None
    return contradicted