mundane.engine.actions

Player actions: the data players submit, plus the rejection exception.

Actions are data, not method calls — a whole game is reduce(apply_action, actions, initial). ACTION_TYPES is the single canonical registry mapping JSON discriminator tags to action classes; both the JSON export (serialize.py) and the HTTP parser (api/schemas.py) derive from it so the wire format can never drift from the engine.

Attributes

Action	The closed set of moves a player may submit.
ACTION_TYPES	Canonical JSON tag -> action-class registry (the type discriminator values).

Exceptions

IllegalAction

Raised when an action is rejected. State is never mutated on rejection.

Classes

PlayCard	Sorcery-speed play of a PERSON / APPLIANCE / HABIT / TASK from hand.
CastInstant	Cast an INSTANT from hand. Legal any time the player holds priority.
PassPriority	Pass priority. The phase advances as a consequence of passing, not via its own action.

Module Contents

class mundane.engine.actions.PlayCard

Sorcery-speed play of a PERSON / APPLIANCE / HABIT / TASK from hand.

player: int

hand_index: int

class mundane.engine.actions.CastInstant

Cast an INSTANT from hand. Legal any time the player holds priority.

player: int

hand_index: int

target_id: int | None = None

class mundane.engine.actions.PassPriority

Pass priority. The phase advances as a consequence of passing, not via its own action.

player: int

type mundane.engine.actions.Action = PlayCard | CastInstant | PassPriority

The closed set of moves a player may submit.

mundane.engine.actions.ACTION_TYPES: dict[str, type[Action]]

Canonical JSON tag -> action-class registry (the type discriminator values).

exception mundane.engine.actions.IllegalAction

Bases: Exception

Raised when an action is rejected. State is never mutated on rejection.