Skip to content

Step info

Structured metadata for entropy-guided search on_step callbacks.

DescendStepInfo dataclass 

DescendStepInfo(
    entropy: int,
    unresolved_count: int,
    candidate_movesets: tuple[
        frozenset[LaneAddress], ...
    ] = (),
    candidate_index: int | None = None,
    moveset: frozenset[LaneAddress] = frozenset(),
    moveset_score: float = 0.0,
    score_breakdown: dict = dict(),
)

Bases: StepInfo

Metadata emitted when the search descends to a new child node.

EntropyBumpStepInfo dataclass 

EntropyBumpStepInfo(
    entropy: int,
    unresolved_count: int,
    candidate_movesets: tuple[
        frozenset[LaneAddress], ...
    ] = (),
    candidate_index: int | None = None,
    new_entropy: int = 0,
    reason: str = "",
    no_valid_moves_qubit: int | None = None,
    state_seen_node_id: int | None = None,
    attempted_moveset: frozenset[LaneAddress] = frozenset(),
)

Bases: StepInfo

Metadata emitted when a node's entropy is incremented.

FallbackStartStepInfo dataclass 

FallbackStartStepInfo(
    entropy: int,
    unresolved_count: int,
    candidate_movesets: tuple[
        frozenset[LaneAddress], ...
    ] = (),
    candidate_index: int | None = None,
    unresolved_qubits: list[int] = list(),
)

Bases: StepInfo

Metadata emitted when the sequential fallback begins.

FallbackStepInfo dataclass 

FallbackStepInfo(
    entropy: int,
    unresolved_count: int,
    candidate_movesets: tuple[
        frozenset[LaneAddress], ...
    ] = (),
    candidate_index: int | None = None,
    qubit_id: int | None = None,
    moveset: frozenset[LaneAddress] = frozenset(),
)

Bases: StepInfo

Metadata emitted for each step of the sequential fallback.

GoalStepInfo dataclass 

GoalStepInfo(
    entropy: int,
    unresolved_count: int,
    candidate_movesets: tuple[
        frozenset[LaneAddress], ...
    ] = (),
    candidate_index: int | None = None,
    total_depth: int = 0,
)

Bases: StepInfo

Metadata emitted when the goal configuration is reached.

RevertStepInfo dataclass 

RevertStepInfo(
    entropy: int,
    unresolved_count: int,
    candidate_movesets: tuple[
        frozenset[LaneAddress], ...
    ] = (),
    candidate_index: int | None = None,
    reversion_steps: int = 0,
    ancestor_depth: int = 0,
    reason: str = "",
    state_seen_node_id: int | None = None,
    no_valid_moves_qubit: int | None = None,
    trigger_node_id: int | None = None,
    trigger_entropy: int | None = None,
)

Bases: StepInfo

Metadata emitted when the search reverts to an ancestor node.

StepInfo dataclass 

StepInfo(
    entropy: int,
    unresolved_count: int,
    candidate_movesets: tuple[
        frozenset[LaneAddress], ...
    ] = (),
    candidate_index: int | None = None,
)

Base metadata passed to on_step callbacks.