feat: переработка NetwrokMessage и EventMapper

src/mind_reader/domain/__init__.py

@@ -0,0 +1,36 @@
+from .common import Player, PlayerRole
+from .context import SessionContext
+from .session import (
+    ArrowDirection,
+    CardData,
+    CardState,
+    GuesserMoveEvent,
+    NextStepRequestedEvent,
+    PlayerHelloEvent,
+    RevealSecretEvent,
+    SessionEvent,
+    SessionPhase,
+    SessionStats,
+    SetterMoveEvent,
+    StepData,
+    StepState,
+)
+
+__all__ = [
+    "Player",
+    "PlayerRole",
+    "SessionContext",
+    "ArrowDirection",
+    "CardData",
+    "CardState",
+    "GuesserMoveEvent",
+    "NextStepRequestedEvent",
+    "PlayerHelloEvent",
+    "RevealSecretEvent",
+    "SessionEvent",
+    "SessionPhase",
+    "SessionStats",
+    "SetterMoveEvent",
+    "StepData",
+    "StepState",
+]

src/mind_reader/domain/common.py

@@ -0,0 +1,13 @@
+from dataclasses import dataclass
+from enum import Enum, StrEnum, auto
+
+
+class PlayerRole(StrEnum):
+    SETTER = auto()
+    GUESSER = auto()
+
+
+@dataclass(frozen=True)
+class Player:
+    name: str
+    role: PlayerRole

src/mind_reader/domain/context.py

@@ -0,0 +1,16 @@
+from dataclasses import dataclass
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..input import SessionInput
+    from ..network import NetworkController
+    from ..state import SessionState
+    from ..ui.views import SessionPanel
+
+
+@dataclass(frozen=True)
+class SessionContext:
+    input: "SessionInput"
+    network: "NetworkController"
+    state: "SessionState"
+    view: "SessionPanel"

src/mind_reader/domain/session.py

@@ -1,10 +1,35 @@
 from dataclasses import dataclass
-from enum import Enum, auto
+from enum import Enum, StrEnum, auto
 from typing import Optional
 
+from .common import Player
+
+
+class ArrowDirection(StrEnum):
+    LEFT = auto()
+    RIGHT = auto()
+    HIDDEN = auto()
+
+
+class StepState(Enum):
+    WAITING_FOR_SETTER = auto()
+    WAITING_FOR_GUESSER = auto()
+    WAITING_FOR_CLOSURE = auto()
+    SESSION_FINISHED = auto()
+
+
+class SessionPhase(Enum):
+    INITIALIZING = auto()
+    WAITING_FOR_SETTER = auto()
+    WAITING_FOR_GUESSER = auto()
+    WAITING_FOR_REVEAL = auto()
+    CHECKOUT = auto()
+    FINISHED = auto()
+
 
 class CardState(Enum):
     SETTER_NOT_SET = auto()
+    SETTER_WAITING = auto()
     SETTER_HIDDEN = auto()
     SETTER_REVEALED = auto()
     GUESSER_DISABLED = auto()
@@ -13,9 +38,17 @@ class CardState(Enum):
     GUESSER_WRONG = auto()
 
 
-class ArrowDirection(Enum):
+@dataclass(frozen=True)
-    LEFT = auto()
+class CardData:
-    RIGHT = auto()
+    direction: Optional[ArrowDirection]
+    state: CardState
+
+
+@dataclass(frozen=True)
+class StepData:
+    index: int
+    setter: CardData
+    guesser: CardData
 
 
 @dataclass
@@ -35,31 +68,38 @@ class SessionStats:
         return round(accuracy, 1)
 
 
-class StepState(Enum):
+@dataclass(frozen=True)
-    WAITING_FOR_SETTER = auto()
+class PlayerHelloEvent:
-    WAITING_FOR_GUESSER = auto()
+    player: Player
-    SESSION_FINISHED = auto()
-
-
-class PlayerRole(Enum):
-    SETTER = auto()
-    GUESSER = auto()
 
 
 @dataclass(frozen=True)
-class CardData:
+class SetterMoveEvent:
-    direction: Optional[ArrowDirection]
+    player: Player
-    state: CardState
+    direction: ArrowDirection
 
 
 @dataclass(frozen=True)
-class StepData:
+class GuesserMoveEvent:
-    index: int
+    player: Player
-    setter: CardData
+    direction: ArrowDirection
-    guesser: CardData
 
 
-@dataclass
+@dataclass(frozen=True)
-class Player:
+class RevealSecretEvent:
-    name: str
+    player: Player
-    role: PlayerRole
+    direction: ArrowDirection
+
+
+@dataclass(frozen=True)
+class NextStepRequestedEvent:
+    player: Player
+
+
+SessionEvent = (
+    PlayerHelloEvent
+    | SetterMoveEvent
+    | GuesserMoveEvent
+    | RevealSecretEvent
+    | NextStepRequestedEvent
+)

src/mind_reader/input/__init__.py

@@ -0,0 +1,3 @@
+from .session_input import SessionInput
+
+__all__ = ["SessionInput"]

src/mind_reader/input/session_input.py

@@ -0,0 +1,70 @@
+from ..domain import ArrowDirection, Player, PlayerRole
+from ..network import NetworkController, NetworkMessage, NetworkMessageKind
+
+
+class SessionInput:
+    def __init__(self, local_player: Player, network: NetworkController):
+        self._local_player = local_player
+        self._network = network
+
+    def start_session(self) -> None:
+        self._network.send(
+            NetworkMessage(NetworkMessageKind.SESSION_SESSION_STARTED, {})
+        )
+
+    def player_move(self, direction: ArrowDirection) -> None:
+        match self._local_player.role:
+            case PlayerRole.SETTER:
+                local_message = NetworkMessage(
+                    NetworkMessageKind.SESSION_PLAYER_MOVED,
+                    {
+                        "player": {
+                            "name": self._local_player.name,
+                            "role": self._local_player.role,
+                        },
+                        "arrow_direction": direction,
+                    },
+                )
+
+                network_message = NetworkMessage(
+                    NetworkMessageKind.SESSION_PLAYER_MOVED,
+                    {
+                        "player": {
+                            "name": self._local_player.name,
+                            "role": self._local_player.role,
+                        },
+                        "arrow_direction": ArrowDirection.HIDDEN,
+                    },
+                    local_message.id,
+                )
+
+                self._network.send_with_looback(local_message, network_message)
+
+            case PlayerRole.GUESSER:
+                self._network.send(
+                    NetworkMessage(
+                        NetworkMessageKind.SESSION_PLAYER_MOVED,
+                        {
+                            "player": {
+                                "name": self._local_player.name,
+                                "role": self._local_player.role,
+                            },
+                            "arrow_direction": direction,
+                        },
+                    )
+                )
+
+                self._network.send(
+                    NetworkMessage(
+                        NetworkMessageKind.SESSION_SECRET_REVEAL_REQUESTED,
+                        {
+                            "player": {
+                                "name": self._local_player.name,
+                                "role": self._local_player.role,
+                            },
+                        },
+                    )
+                )
+
+    def finish_session(self) -> None:
+        pass

src/mind_reader/network/__init__.py

@@ -1,7 +1,11 @@
-from .controller import NetworkController
+# from .controller import NetworkController
-from .protocol import NetworkMesssage
+# from .enums import NetworkMessageKind
+# from .handlers import SessionNetworkMessageHandler
+# from .message import NetworkMessage
 
-__all__ = [
+# __all__ = [
-    "NetworkController",
+#     "NetworkController",
-    "NetworkMesssage",
+#     "NetworkMessageKind",
-]
+#     "SessionNetworkMessageHandler",
+#     "NetworkMessage",
+# ]

src/mind_reader/network/controller.py

@@ -1,150 +1,110 @@
-import socket
+import logging
-import struct
+from typing import Optional
-import threading
-from typing import Callable, Optional
 
-import wx
+import paho.mqtt.client as mqtt
+from paho.mqtt.enums import CallbackAPIVersion
 
-from .protocol import NetworkMesssage
+from ..state_machines.session.events import SessionEvent
+from ..state_machines.session.machine import SessionStateMachine
+from .message import EventMapper, NetworkMessage, SessionMessageKind
 
-OnMessageCallback = Callable[[NetworkMesssage], None]
+logger = logging.getLogger(__name__)
-OnNoticeCallback = Callable[[str], None]
 
 
-def receive_exact(sock: socket.socket, n: int) -> Optional[bytes]:
+class NetworkController:
-    data = bytearray()
-
-    while len(data) < n:
-        packet = sock.recv(n - len(data))
-        if not packet:
-            return None
-        data.extend(packet)
-
-    return bytes(data)
-
-
-class NetworkController(threading.Thread):
     def __init__(
         self,
-        on_message_callback: OnMessageCallback,
+        host: str,
-        on_notice_callback: Optional[OnNoticeCallback] = None,
+        port: int,
+        username: str,
+        password: str,
+        lobby,
+        session: SessionStateMachine,
     ):
-        super().__init__(daemon=True)
+        self._lobby_topic = "mind_reader/lobby"
-        self.on_message_callback = on_message_callback
+        self._session_topic = "mind_reader/session"
-        self.on_notice_callback = on_notice_callback
 
-        self.sock: Optional[socket.socket] = None
+        self._lobby = lobby
-        self.conn: Optional[socket.socket] = None
+        self._session = session
 
-        self.is_running: bool = False
+        self._pending_loopbacks: dict[str, NetworkMessage] = {}
-        self.is_server: bool = False
 
-    def serve(self, host: str = "0.0.0.0", port: int = 8994) -> None:
+        self._client = mqtt.Client(CallbackAPIVersion.VERSION2)
-        self.is_server = True
+        self._client.username_pw_set(username, password)
 
-        self.sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        self._client.message_callback_add(
-        self.sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+            self._lobby_topic, self._on_lobby_message
-        self.sock.bind((host, port))
+        )
-        self.sock.listen(1)
+        self._client.message_callback_add(
+            self._session_topic, self._on_session_message
+        )
 
-        self.is_running = True
+        self._client.connect(host, port)
-        self.start()
 
-    def connect(self, host: str, port: int = 8994) -> bool:
+        self._client.subscribe(self._lobby_topic)
-        self.is_server = False
+        self._client.subscribe(self._session_topic)
 
-        try:
+    def start(self) -> None:
-            self.conn = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        self._client.loop_start()
-            self.conn.connect((host, port))
-
-            self.is_running = True
-            self._notify("Connected to host")
-            self.start()
-            return True
-        except Exception as e:
-            self._notify(f"Connection failed: {e}")
-            return False
-
-    def send(self, event: str, payload: dict = {}) -> None:
-        if not self.conn or not self.is_running:
-            return
-
-        m = NetworkMesssage(event, payload)
-
-        try:
-            self.conn.sendall(m.encode())
-        except Exception as e:
-            self._notify(f"Send error: {e}")
-            self._close_active_connection()
-
-    def run(self) -> None:
-        HEADER_SIZE = 4
-
-        while self.is_running:
-            if self.is_server and self.sock and not self.conn:
-                self._notify("Waiting for peer to connect...")
-
-                try:
-                    self.conn, addr = self.sock.accept()
-                    self._notify(f"Peer connected from {addr[0]}:{addr[1]}")
-                except Exception:
-                    break
-
-            while self.is_running and self.conn:
-                try:
-                    header_bytes = receive_exact(self.conn, HEADER_SIZE)
-                    if not header_bytes:
-                        self._notify("Peer disconnected")
-                        break
-
-                    body_size = struct.unpack(">I", header_bytes)[0]
-
-                    body_bytes = receive_exact(self.conn, body_size)
-                    if not body_bytes:
-                        self._notify("Peer disconnected unexpectedly")
-                        break
-
-                    json_str = body_bytes.decode("utf-8")
-                    m = NetworkMesssage.from_json(json_str)
-
-                    wx.CallAfter(self.on_message_callback, m)
-
-                except Exception as e:
-                    self._notify(f"Read error: {e}")
-                    break
-
-            self._close_active_connection()
-
-            if not self.is_server:
-                break
-
-        self.stop()
-
-    def _close_active_connection(self) -> None:
-        if self.conn:
-            try:
-                self.conn.shutdown(socket.SHUT_RDWR)
-                self.conn.close()
-            except Exception:
-                pass
-            finally:
-                self.conn = None
-
-    def _notify(self, notice: str) -> None:
-        if self.on_notice_callback:
-            wx.CallAfter(self.on_notice_callback, notice)
 
     def stop(self) -> None:
-        self.is_running = False
+        self._client.loop_stop()
+        self._client.disconnect()
 
-        self._close_active_connection()
+    def send(self, network_message: NetworkMessage) -> None:
+        match network_message.kind:
+            case SessionMessageKind():
+                self._client.publish(
+                    self._session_topic, network_message.to_json()
+                )
 
-        if self.sock:
+    def send_with_loopback(
-            try:
+        self,
-                self.sock.close()
+        local_message: NetworkMessage,
-            except Exception:
+        network_message: NetworkMessage,
-                pass
+    ) -> None:
-            finally:
+        if local_message.id != network_message.id:
-                self.sock = None
+            raise ValueError(
+                f"Mismatched message IDs in send_with_loopback: "
+                f"local_message.id='{local_message.id}'"
+                f"vs network_message.id='{network_message.id}'"
+            )
 
-        self._notify("Connection closed")
+        self._pending_loopbacks[local_message.id] = local_message
+        self.send(network_message)
+
+    def _pop_loopback(self, message_id: str) -> Optional[NetworkMessage]:
+        return self._pending_loopbacks.pop(message_id, None)
+
+    def _parse_incoming_message(
+        self, message: mqtt.MQTTMessage
+    ) -> Optional[NetworkMessage]:
+        try:
+            json_str = message.payload.decode()
+            network_message = NetworkMessage.from_json(json_str)
+        except Exception as err:
+            logger.error("Failed to parse incoming MQTT message: %s", err)
+            return None
+
+        loopback_message = self._pop_loopback(network_message.id)
+        return loopback_message or network_message
+
+    def _on_lobby_message(
+        self, client: mqtt.Client, userdata: None, message: mqtt.MQTTMessage
+    ) -> None:
+        network_message = self._parse_incoming_message(message)
+        if network_message is None:
+            return
+        event = EventMapper.from_message(network_message)
+        # if isinstance(event, LobbyEvent):
+        #     self._lobby.process(event)
+
+    def _on_session_message(
+        self, client: mqtt.Client, userdata: None, message: mqtt.MQTTMessage
+    ) -> None:
+        network_message = self._parse_incoming_message(message)
+        if network_message is None:
+            return
+        event = EventMapper.from_message(network_message)
+        if isinstance(event, SessionEvent):
+            self._session.process(event)

src/mind_reader/network/message.py

@@ -0,0 +1,108 @@
+import json
+import logging
+from dataclasses import asdict, dataclass, field
+from enum import StrEnum, auto
+from typing import Any, Optional
+
+from uuid_extensions import uuid7str
+
+from ..state_machines.lobby.domain import Player, PlayerRole
+from ..state_machines.session.domain import ArrowDirection
+from ..state_machines.session.events import (
+    GuesserMoveEvent,
+    NextStepRequestedEvent,
+    PlayerHelloEvent,
+    RevealSecretEvent,
+    SessionEvent,
+    SetterMoveEvent,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class SessionMessageKind(StrEnum):
+    PLAYER_HELLO = auto()
+    SETTER_MOVED = auto()
+    GUESSER_MOVED = auto()
+    SECRET_REVEALED = auto()
+    NEXT_STEP_REQUESTED = auto()
+
+
+NetworkMessageKind = SessionMessageKind
+Event = SessionEvent
+
+
+EVENT_TO_KIND_MAP: dict[type[Event], NetworkMessageKind] = {
+    PlayerHelloEvent: SessionMessageKind.PLAYER_HELLO,
+    SetterMoveEvent: SessionMessageKind.SETTER_MOVED,
+    GuesserMoveEvent: SessionMessageKind.GUESSER_MOVED,
+    RevealSecretEvent: SessionMessageKind.SECRET_REVEALED,
+    NextStepRequestedEvent: SessionMessageKind.NEXT_STEP_REQUESTED,
+}
+
+KIND_TO_EVENT_MAP = {
+    kind: event_cls for event_cls, kind in EVENT_TO_KIND_MAP.items()
+}
+
+
+def serializer(obj: Any) -> Any:
+    if isinstance(obj, StrEnum):
+        return obj.value
+    raise TypeError(
+        f"Object of type {type(obj).__name__} is not JSON serializable"
+    )
+
+
+@dataclass(frozen=True)
+class NetworkMessage:
+    kind: NetworkMessageKind
+    payload: dict[str, Any] = field(default_factory=dict)
+    id: str = field(default_factory=uuid7str)
+
+    @classmethod
+    def from_json(cls, json_str: str) -> "NetworkMessage":
+        try:
+            data = json.loads(json_str)
+            return cls(
+                kind=NetworkMessageKind(data["kind"]),
+                payload=data.get("payload", {}),
+                id=data["id"],
+            )
+        except (KeyError, ValueError, json.JSONDecodeError) as err:
+            logger.error(
+                "Failed to deserialize NetworkMessage from JSON: %s", err
+            )
+            raise
+
+    def to_json(self) -> str:
+        data = {"kind": self.kind.value, "payload": self.payload, "id": self.id}
+        return json.dumps(data, ensure_ascii=False, default=serializer)
+
+
+class EventMapper:
+    @staticmethod
+    def to_message(event: Event) -> NetworkMessage:
+        event_type = type(event)
+        kind = EVENT_TO_KIND_MAP.get(event_type)
+
+        if not kind:
+            logger.error(
+                "Attempted to serialize unregistered event: %s", event_type
+            )
+            raise ValueError(
+                f"Event {event_type} is not registered in EVENT_TO_KIND_MAP"
+            )
+
+        return NetworkMessage(kind=kind, payload=event.to_payload())
+
+    @staticmethod
+    def from_message(message: NetworkMessage) -> Event | None:
+        event_cls = KIND_TO_EVENT_MAP.get(message.kind)
+
+        if not event_cls:
+            return None
+
+        try:
+            return event_cls.from_payload(message.payload)
+        except (KeyError, ValueError, TypeError):
+            return None

src/mind_reader/network/protocol.py

@@ -1,46 +0,0 @@
-import itertools
-import json
-import struct
-from dataclasses import dataclass, field
-
-_id_generator = itertools.count(0)
-
-
-@dataclass
-class NetworkMesssage:
-    event: str
-    payload: dict[str, str] = field(default_factory=dict)
-    id: int = field(default_factory=lambda: next(_id_generator))
-    version: str = "1.0"
-
-    def to_json(self) -> str:
-        return json.dumps(
-            {
-                "version": self.version,
-                "id": self.id,
-                "event": self.event,
-                "payload": self.payload,
-            },
-            ensure_ascii=False,
-        )
-
-    @classmethod
-    def from_json(cls, json_str: str) -> "NetworkMesssage":
-        data = json.loads(json_str)
-        return cls(
-            event=data.get("event", "unknown"),
-            payload=data.get("payload", {}),
-            id=data.get("id", -1),
-            version=data.get("version", "unknown"),
-        )
-
-    def encode(self) -> bytes:
-        raw_bytes = self.to_json().encode("utf-8")
-        length_prefix = struct.pack(">I", len(raw_bytes))
-        return length_prefix + raw_bytes
-
-
-if __name__ == "__main__":
-    for i in range(10):
-        message = NetworkMesssage("none")
-        print(message.encode())

src/mind_reader/state/session_state.py

@@ -32,27 +32,26 @@ class SessionState:
         return len(self._guesser_moves)
 
     def _get_setter_card_state(self, index: int) -> CardState:
-        current_index = len(self._setter_moves)
+        completed = self._completed_move_count
 
-        if index > current_index:
+        if index > completed:
             return CardState.SETTER_NOT_SET
 
-        elif index == current_index:
+        elif index == completed:
-            if self._step_state == StepState.WAITING_FOR_GUESSER:
+            if self._local_player.role == PlayerRole.SETTER:
-                if self._local_player.role == PlayerRole.SETTER:
+                return CardState.SETTER_REVEALED
-                    return CardState.SETTER_REVEALED
+            else:
-                else:
+                return CardState.SETTER_HIDDEN
-                    return CardState.SETTER_HIDDEN
 
         return CardState.SETTER_REVEALED
 
     def _get_guesser_card_state(self, index: int) -> CardState:
-        completed_move_count = self._completed_move_count
+        completed = self._completed_move_count
 
-        if index > completed_move_count:
+        if index > completed:
             return CardState.GUESSER_DISABLED
 
-        elif index == completed_move_count:
+        elif index == completed:
             if self._step_state == StepState.WAITING_FOR_GUESSER:
                 return CardState.GUESSER_WAITING
             else:
@@ -113,12 +112,21 @@ class SessionState:
             return False
 
         self._guesser_moves.append(direction)
+        self._step_state = StepState.WAITING_FOR_CLOSURE
+        return True
+
+    def step_close(self, direction: ArrowDirection) -> bool:
+        if self._step_state != StepState.WAITING_FOR_CLOSURE:
+            return False
 
         if self._completed_move_count < self._sequence_length:
             self._step_state = StepState.WAITING_FOR_SETTER
         else:
             self._step_state = StepState.SESSION_FINISHED
 
+        if self._local_player.role == PlayerRole.GUESSER:
+            self._setter_moves[-1] = direction
+
         index = len(self._guesser_moves) - 1
 
         pub.sendMessage(
@@ -158,6 +166,13 @@ class SessionState:
 
         return True
 
+    def reveal_setter_move(self) -> ArrowDirection:
+        if self._local_player.role == PlayerRole.SETTER:
+            if self._step_state == StepState.WAITING_FOR_CLOSURE:
+                return self._setter_moves[-1]
+
+        return ArrowDirection.HIDDEN
+
     def local_move(self, direction: ArrowDirection) -> bool:
         if not self.can_local_move():
             return False
@@ -172,6 +187,8 @@ class SessionState:
                 return self._local_player.role == PlayerRole.SETTER
             case StepState.WAITING_FOR_GUESSER:
                 return self._local_player.role == PlayerRole.GUESSER
+            case StepState.WAITING_FOR_CLOSURE:
+                return False
             case StepState.SESSION_FINISHED:
                 return False
 
@@ -192,3 +209,11 @@ class SessionState:
     @property
     def sequence_length(self) -> int:
         return self._sequence_length
+
+    @property
+    def local_player(self) -> Player:
+        return self._local_player
+
+    @property
+    def remote_player(self) -> Player:
+        return self._remote_player

src/mind_reader/state_machines/base_event.py

@@ -0,0 +1,22 @@
+from dataclasses import asdict, dataclass, is_dataclass
+from enum import StrEnum
+from typing import Any
+
+
+def _factory(d: list[tuple[str, Any]]) -> dict[str, Any]:
+    def _convert(obj: Any) -> Any:
+        if isinstance(obj, StrEnum):
+            return obj.value
+        if isinstance(obj, list | tuple):
+            return [_convert(item) for item in obj]
+        if isinstance(obj, dict):
+            return {k: _convert(v) for k, v in obj.items()}
+        return obj
+
+    return {k: _convert(v) for k, v in d}
+
+
+@dataclass(frozen=True)
+class BaseEvent:
+    def to_payload(self) -> dict[str, Any]:
+        return asdict(self, dict_factory=_factory)

src/mind_reader/state_machines/lobby/domain.py

@@ -0,0 +1,19 @@
+from dataclasses import dataclass
+from enum import StrEnum, auto
+
+
+class PlayerRole(StrEnum):
+    SETTER = auto()
+    GUESSER = auto()
+
+
+@dataclass(frozen=True)
+class Player:
+    name: str
+    role: PlayerRole
+
+    @classmethod
+    def from_dict(cls, d: dict) -> "Player":
+        return cls(
+            name=d["player"]["name"], role=PlayerRole(d["player"]["role"])
+        )

src/mind_reader/state_machines/session/domain.py

@@ -0,0 +1,27 @@
+from enum import Enum, StrEnum, auto
+
+
+class ArrowDirection(StrEnum):
+    LEFT = auto()
+    RIGHT = auto()
+    HIDDEN = auto()
+
+
+class SessionPhase(Enum):
+    INITIALIZING = auto()
+    WAITING_FOR_SETTER = auto()
+    WAITING_FOR_GUESSER = auto()
+    WAITING_FOR_REVEAL = auto()
+    CHECKOUT = auto()
+    FINISHED = auto()
+
+
+class CardState(Enum):
+    SETTER_NOT_SET = auto()
+    SETTER_WAITING = auto()
+    SETTER_HIDDEN = auto()
+    SETTER_REVEALED = auto()
+    GUESSER_DISABLED = auto()
+    GUESSER_WAITING = auto()
+    GUESSER_CORRECT = auto()
+    GUESSER_WRONG = auto()

src/mind_reader/state_machines/session/events.py

@@ -0,0 +1,71 @@
+from dataclasses import dataclass
+
+from ..base_event import BaseEvent
+from ..lobby.domain import Player
+from ..session.domain import ArrowDirection
+
+
+@dataclass(frozen=True)
+class PlayerHelloEvent(BaseEvent):
+    player: Player
+
+    @classmethod
+    def from_payload(cls, p: dict) -> "PlayerHelloEvent":
+        return cls(player=Player.from_dict(p))
+
+
+@dataclass(frozen=True)
+class SetterMoveEvent(BaseEvent):
+    player: Player
+    direction: ArrowDirection
+
+    @classmethod
+    def from_payload(cls, p: dict) -> "SetterMoveEvent":
+        return cls(
+            player=Player.from_dict(p),
+            direction=ArrowDirection(p["arrow_direction"]),
+        )
+
+
+@dataclass(frozen=True)
+class GuesserMoveEvent(BaseEvent):
+    player: Player
+    direction: ArrowDirection
+
+    @classmethod
+    def from_payload(cls, p: dict) -> "GuesserMoveEvent":
+        return cls(
+            player=Player.from_dict(p),
+            direction=ArrowDirection(p["arrow_direction"]),
+        )
+
+
+@dataclass(frozen=True)
+class RevealSecretEvent(BaseEvent):
+    player: Player
+    direction: ArrowDirection
+
+    @classmethod
+    def from_payload(cls, p: dict) -> "RevealSecretEvent":
+        return cls(
+            player=Player.from_dict(p),
+            direction=ArrowDirection(p["arrow_direction"]),
+        )
+
+
+@dataclass(frozen=True)
+class NextStepRequestedEvent(BaseEvent):
+    player: Player
+
+    @classmethod
+    def from_payload(cls, p: dict) -> "NextStepRequestedEvent":
+        return cls(player=Player.from_dict(p))
+
+
+SessionEvent = (
+    PlayerHelloEvent
+    | SetterMoveEvent
+    | GuesserMoveEvent
+    | RevealSecretEvent
+    | NextStepRequestedEvent
+)

src/mind_reader/state_machines/session/machine.py

@@ -0,0 +1,174 @@
+from ..lobby.domain import Player, PlayerRole
+from ..session.domain import ArrowDirection, CardState, SessionPhase
+from ..session.events import (
+    GuesserMoveEvent,
+    NextStepRequestedEvent,
+    PlayerHelloEvent,
+    RevealSecretEvent,
+    SessionEvent,
+    SetterMoveEvent,
+)
+
+
+class SessionStateMachine:
+    def __init__(
+        self, setter: Player, guessers: set[Player], sequence_length: int = 20
+    ):
+        self._setter = setter
+        self._guessers = guessers
+
+        self._pending_players: set[Player] = set(guessers)
+        self._pending_players.add(setter)
+
+        self._sequence_length = sequence_length
+        self._setter_moves: list[ArrowDirection] = []
+        self._guessers_moves: dict[Player, list[ArrowDirection]] = {
+            player: [] for player in guessers
+        }
+
+        self._phase: SessionPhase = SessionPhase.INITIALIZING
+
+    def process(self, event: SessionEvent) -> bool:
+        match (self._phase, event):
+            case (SessionPhase.INITIALIZING, PlayerHelloEvent(player)):
+                self._pending_players.remove(player)
+                if not self._pending_players:
+                    self._phase = SessionPhase.WAITING_FOR_SETTER
+                    self._pending_players = {self._setter}
+                return True
+
+            case (
+                SessionPhase.WAITING_FOR_SETTER,
+                SetterMoveEvent(player, direction),
+            ):
+                self._pending_players.remove(player)
+                if not self._pending_players:
+                    self._setter_moves.append(direction)
+                    self._phase = SessionPhase.WAITING_FOR_GUESSER
+                    self._pending_players = set(self._guessers)
+                return True
+
+            case (
+                SessionPhase.WAITING_FOR_GUESSER,
+                GuesserMoveEvent(player, direction),
+            ):
+                self._guessers_moves[player].append(direction)
+                self._pending_players.remove(player)
+                if not self._pending_players:
+                    self._phase = SessionPhase.WAITING_FOR_REVEAL
+                    self._pending_players = {self._setter}
+                return True
+
+            case (
+                SessionPhase.WAITING_FOR_REVEAL,
+                RevealSecretEvent(player, direction),
+            ):
+                self._pending_players.remove(player)
+                if not self._pending_players:
+                    self._phase = SessionPhase.CHECKOUT
+                    setter_move_index = len(self._setter_moves) - 1
+                    self._setter_moves[setter_move_index] = direction
+                    self._pending_players = set(self._guessers)
+                return True
+
+            case (SessionPhase.CHECKOUT, NextStepRequestedEvent(player)):
+                self._pending_players.remove(player)
+                if not self._pending_players:
+                    if len(self._setter_moves) >= self._sequence_length:
+                        self._phase = SessionPhase.FINISHED
+                        self._pending_players.clear()
+                    else:
+                        self._phase = SessionPhase.WAITING_FOR_SETTER
+                        self._pending_players = {self._setter}
+                return True
+
+            case _:
+                return False
+
+    def get_card_state(self, player: Player, index: int) -> CardState:
+        match player.role:
+            case PlayerRole.SETTER:
+                return self._get_setter_card_state(index)
+            case PlayerRole.GUESSER:
+                return self._get_guesser_card_state(player, index)
+
+    def _get_setter_card_state(self, index: int) -> CardState:
+        current_index = self.current_index
+
+        if index > current_index:
+            return CardState.SETTER_NOT_SET
+
+        elif index == current_index:
+            match self._phase:
+                case SessionPhase.INITIALIZING:
+                    return CardState.SETTER_NOT_SET
+                case SessionPhase.WAITING_FOR_SETTER:
+                    return CardState.SETTER_WAITING
+                case (
+                    SessionPhase.WAITING_FOR_GUESSER
+                    | SessionPhase.WAITING_FOR_REVEAL
+                ):
+                    if self._setter_moves[-1] == ArrowDirection.HIDDEN:
+                        return CardState.SETTER_HIDDEN
+                    else:
+                        return CardState.SETTER_REVEALED
+                case SessionPhase.CHECKOUT | SessionPhase.FINISHED:
+                    return CardState.SETTER_REVEALED
+
+        else:
+            return CardState.SETTER_REVEALED
+
+    def _get_guesser_card_state(self, player: Player, index: int) -> CardState:
+        def _check_direction(
+            self: SessionStateMachine, player: Player, index: int
+        ) -> CardState:
+            if self._setter_moves[index] == self._guessers_moves[player][index]:
+                return CardState.GUESSER_CORRECT
+            else:
+                return CardState.GUESSER_WRONG
+
+        current_index = self.current_index
+
+        if index > current_index:
+            return CardState.GUESSER_DISABLED
+
+        elif index == current_index:
+            match self._phase:
+                case (
+                    SessionPhase.INITIALIZING | SessionPhase.WAITING_FOR_SETTER
+                ):
+                    return CardState.GUESSER_DISABLED
+                case (
+                    SessionPhase.WAITING_FOR_GUESSER
+                    | SessionPhase.WAITING_FOR_REVEAL
+                ):
+                    return CardState.GUESSER_WAITING
+                case SessionPhase.CHECKOUT | SessionPhase.FINISHED:
+                    return _check_direction(self, player, index)
+
+        else:
+            return _check_direction(self, player, index)
+
+    def get_setter_move(self, index: int) -> ArrowDirection | None:
+        try:
+            return self._setter_moves[index]
+        except IndexError:
+            return None
+
+    def get_guesser_move(
+        self, player: Player, index: int
+    ) -> ArrowDirection | None:
+        try:
+            return self._guessers_moves[player][index]
+        except IndexError:
+            return None
+
+    @property
+    def current_index(self) -> int:
+        setter_step_number = len(self._setter_moves)
+        if setter_step_number:
+            if self._phase == SessionPhase.WAITING_FOR_SETTER:
+                return setter_step_number
+            else:
+                return setter_step_number - 1
+        return 0

src/mind_reader/ui/views/__init__.py

@@ -1,4 +1,4 @@
-from .lobby_view import LobbyPanel
+# from .lobby_view import LobbyPanel
 from .session_view import SessionPanel
 
-__all__ = ["LobbyPanel", "SessionPanel"]
+__all__ = ["SessionPanel"]

src/mind_reader/ui/views/session_view.py

@@ -5,8 +5,9 @@ from typing import Callable, Optional
 import wx
 from wx.lib.pubsub import pub
 
-from mind_reader.domain import ArrowDirection, CardState, SessionStats, StepData
+from ...domain import ArrowDirection, CardState, SessionStats, StepData
-from mind_reader.state import SessionState
+from ...input import SessionInput
+from ...state import SessionState
 
 
 @dataclass(frozen=True)
@@ -28,6 +29,7 @@ class GuesserCardColour:
 class ArrowSymbol:
     LEFT: str = "←"
     RIGHT: str = "→"
+    HIDDEN: str = "?"
 
 
 class Card(wx.Panel):
@@ -60,7 +62,7 @@ class Card(wx.Panel):
 
             case CardState.SETTER_HIDDEN:
                 colour = SetterCardColour.HIDDEN
-                show_arrow = False
+                show_arrow = True
 
             case CardState.SETTER_REVEALED:
                 colour = SetterCardColour.REVEALED
@@ -90,6 +92,9 @@ class Card(wx.Panel):
                 case ArrowDirection.RIGHT:
                     symbol = ArrowSymbol.RIGHT
 
+                case ArrowDirection.HIDDEN:
+                    symbol = ArrowSymbol.HIDDEN
+
             self.label.SetLabel(symbol)
 
         else:
@@ -112,10 +117,17 @@ class Card(wx.Panel):
 
 class SessionPanel(wx.Panel):
     def __init__(
-        self, parent, setter_name: str, guesser_name: str, sequence_length: int
+        self,
+        parent,
+        input: SessionInput,
+        setter_name: str,
+        guesser_name: str,
+        sequence_length: int,
     ):
         super().__init__(parent)
 
+        self._input = input
+
         self._setter_name = setter_name
         self._guesser_name = guesser_name
         self._sequence_length = sequence_length
@@ -267,7 +279,7 @@ class SessionPanel(wx.Panel):
         self._handle_arrow_input(ArrowDirection.RIGHT)
 
     def _handle_arrow_input(self, direction: ArrowDirection) -> None:
-        pass
+        self._input.player_move(direction)
 
     def _on_session_started(self, step: StepData) -> None:
         self.update_setter_card(