Events

The task-lifecycle event model consumed by on_event= handlers.

Task lifecycle events (ADR-0018, as amended).

TaskEvent describes what just happened in a task's life. Every solve invocation ends in exactly one terminal event — PRE_FLIGHT_FAILED, SUBMIT_FAILED, RESULT_FAILED, or RESULT_RECEIVED. The terminal failure kinds fire immediately before the terminal raise and carry the matching error_kind; cancellation is eventless.

TaskEventKind

Bases: Enum

What event just happened in the task's life.

TaskEvent dataclass

An observation about a task's lifecycle (ADR-0018).

error_kind is set only on the terminal failure kinds (see the per-kind matrix in ADR-0018); it is None on in-progress and success kinds, and None on PRE_FLIGHT_FAILED caused by a wrong-provider TypeError. cost is set only on RESULT_RECEIVED (the solved task's price in the adapter's currency); it is None elsewhere. detail never carries credentials.