langgoap.PlanningTracer

class PlanningTracer(*args, **kwargs)

Sync + async observability hooks for the GOAP planning loop.

Every hook is fire-and-forget. Implementations must never raise — MultiTracer catches and logs exceptions, but user-facing nodes also wrap each call in a try/except as a second line of defence.

__init__(*args, **kwargs)

Methods

__init__(*args, **kwargs)
aon_action_complete(result)
aon_action_retry(action, attempt, exception, ...)
aon_action_start(action, state)
aon_goal_achieved(final_state)
aon_plan_complete(plan, duration_ms)
aon_plan_failed(reason, duration_ms)
aon_plan_start(goal, state, strategy_name)
aon_replan(reason, new_plan)
aon_search_complete(nodes_explored, ...)
aon_search_dead_end(reason, detail)
aon_search_expand(node_id, state, g, h, f, ...)
aon_sensor_complete(sensor_name, updates)
aon_strategy_chosen(strategy_name)
on_action_complete(result)	Called immediately after an action node returns.
on_action_retry(action, attempt, exception, ...)	Called between retry attempts inside the executor.
on_action_start(action, state)
on_goal_achieved(final_state)
on_plan_complete(plan, duration_ms)
on_plan_failed(reason, duration_ms)
on_plan_start(goal, state, strategy_name)
on_replan(reason, new_plan)
on_search_complete(nodes_explored, ...)
on_search_dead_end(reason, detail)
on_search_expand(node_id, state, g, h, f, ...)
on_sensor_complete(sensor_name, updates)
on_strategy_chosen(strategy_name)	Called when StrategyRouter picks a planning strategy.