Upload folder using huggingface_hub

Dockerfile

@@ -0,0 +1,81 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+
+# Multi-stage build using openenv-base
+# This Dockerfile is flexible and works for both:
+# - In-repo environments (with local src/core)
+# - Standalone environments (with openenv-core from pip)
+# The build script (openenv build) handles context detection and sets appropriate build args.
+
+ARG BASE_IMAGE=ghcr.io/meta-pytorch/openenv-base:latest
+FROM ${BASE_IMAGE} AS builder
+
+WORKDIR /app
+
+# Ensure git is available (required for installing dependencies from VCS)
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends git && \
+    rm -rf /var/lib/apt/lists/*
+
+# Build argument to control whether we're building standalone or in-repo
+ARG BUILD_MODE=in-repo
+ARG ENV_NAME=my_game
+
+# Copy environment code (always at root of build context)
+COPY . /app/env
+
+# For in-repo builds, openenv-core is already in the pyproject.toml dependencies
+# For standalone builds, openenv-core will be installed from pip via pyproject.toml
+WORKDIR /app/env
+
+# Ensure uv is available (for local builds where base image lacks it)
+RUN if ! command -v uv >/dev/null 2>&1; then \
+        curl -LsSf https://astral.sh/uv/install.sh | sh && \
+        mv /root/.local/bin/uv /usr/local/bin/uv && \
+        mv /root/.local/bin/uvx /usr/local/bin/uvx; \
+    fi
+    
+# Install dependencies using uv sync
+# If uv.lock exists, use it; otherwise resolve on the fly
+RUN --mount=type=cache,target=/root/.cache/uv \
+    if [ -f uv.lock ]; then \
+        uv sync --frozen --no-install-project --no-editable; \
+    else \
+        uv sync --no-install-project --no-editable; \
+    fi
+
+RUN --mount=type=cache,target=/root/.cache/uv \
+    if [ -f uv.lock ]; then \
+        uv sync --frozen --no-editable; \
+    else \
+        uv sync --no-editable; \
+    fi
+
+# Final runtime stage
+FROM ${BASE_IMAGE}
+
+WORKDIR /app
+
+# Copy the virtual environment from builder
+COPY --from=builder /app/env/.venv /app/.venv
+
+# Copy the environment code
+COPY --from=builder /app/env /app/env
+
+# Set PATH to use the virtual environment
+ENV PATH="/app/.venv/bin:$PATH"
+
+# Set PYTHONPATH so imports work correctly
+ENV PYTHONPATH="/app/env:$PYTHONPATH"
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:8000/health || exit 1
+
+# Run the FastAPI server
+# The module path is constructed to work with the /app/env structure
+ENV ENABLE_WEB_INTERFACE=true
+CMD ["sh", "-c", "cd /app/env && uvicorn server.app:app --host 0.0.0.0 --port 8000"]

README.md

@@ -1,10 +1,199 @@
 ---
-title: Chess
-emoji: 👁
-colorFrom: yellow
-colorTo: pink
+title: My Game Environment Server
+emoji: 🥉
+colorFrom: indigo
+colorTo: indigo
 sdk: docker
 pinned: false
+app_port: 8000
+base_path: /web
+tags:
+  - openenv
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# My Game Environment
+
+A simple test environment that echoes back messages. Perfect for testing the env APIs as well as demonstrating environment usage patterns.
+
+## Quick Start
+
+The simplest way to use the My Game environment is through the `MyGameEnv` class:
+
+```python
+from my_game import MyGameAction, MyGameEnv
+
+try:
+    # Create environment from Docker image
+    my_gameenv = MyGameEnv.from_docker_image("my_game-env:latest")
+
+    # Reset
+    result = my_gameenv.reset()
+    print(f"Reset: {result.observation.echoed_message}")
+
+    # Send multiple messages
+    messages = ["Hello, World!", "Testing echo", "Final message"]
+
+    for msg in messages:
+        result = my_gameenv.step(MyGameAction(message=msg))
+        print(f"Sent: '{msg}'")
+        print(f"  → Echoed: '{result.observation.echoed_message}'")
+        print(f"  → Length: {result.observation.message_length}")
+        print(f"  → Reward: {result.reward}")
+
+finally:
+    # Always clean up
+    my_gameenv.close()
+```
+
+That's it! The `MyGameEnv.from_docker_image()` method handles:
+- Starting the Docker container
+- Waiting for the server to be ready
+- Connecting to the environment
+- Container cleanup when you call `close()`
+
+## Building the Docker Image
+
+Before using the environment, you need to build the Docker image:
+
+```bash
+# From project root
+docker build -t my_game-env:latest -f server/Dockerfile .
+```
+
+## Deploying to Hugging Face Spaces
+
+You can easily deploy your OpenEnv environment to Hugging Face Spaces using the `openenv push` command:
+
+```bash
+# From the environment directory (where openenv.yaml is located)
+openenv push
+
+# Or specify options
+openenv push --namespace my-org --private
+```
+
+The `openenv push` command will:
+1. Validate that the directory is an OpenEnv environment (checks for `openenv.yaml`)
+2. Prepare a custom build for Hugging Face Docker space (enables web interface)
+3. Upload to Hugging Face (ensuring you're logged in)
+
+### Prerequisites
+
+- Authenticate with Hugging Face: The command will prompt for login if not already authenticated
+
+### Options
+
+- `--directory`, `-d`: Directory containing the OpenEnv environment (defaults to current directory)
+- `--repo-id`, `-r`: Repository ID in format 'username/repo-name' (defaults to 'username/env-name' from openenv.yaml)
+- `--base-image`, `-b`: Base Docker image to use (overrides Dockerfile FROM)
+- `--private`: Deploy the space as private (default: public)
+
+### Examples
+
+```bash
+# Push to your personal namespace (defaults to username/env-name from openenv.yaml)
+openenv push
+
+# Push to a specific repository
+openenv push --repo-id my-org/my-env
+
+# Push with a custom base image
+openenv push --base-image ghcr.io/meta-pytorch/openenv-base:latest
+
+# Push as a private space
+openenv push --private
+
+# Combine options
+openenv push --repo-id my-org/my-env --base-image custom-base:latest --private
+```
+
+After deployment, your space will be available at:
+`https://huggingface.co/spaces/<repo-id>`
+
+The deployed space includes:
+- **Web Interface** at `/web` - Interactive UI for exploring the environment
+- **API Documentation** at `/docs` - Full OpenAPI/Swagger interface
+- **Health Check** at `/health` - Container health monitoring
+
+## Environment Details
+
+### Action
+**MyGameAction**: Contains a single field
+- `message` (str) - The message to echo back
+
+### Observation
+**MyGameObservation**: Contains the echo response and metadata
+- `echoed_message` (str) - The message echoed back
+- `message_length` (int) - Length of the message
+- `reward` (float) - Reward based on message length (length × 0.1)
+- `done` (bool) - Always False for echo environment
+- `metadata` (dict) - Additional info like step count
+
+### Reward
+The reward is calculated as: `message_length × 0.1`
+- "Hi" → reward: 0.2
+- "Hello, World!" → reward: 1.3
+- Empty message → reward: 0.0
+
+## Advanced Usage
+
+### Connecting to an Existing Server
+
+If you already have a My Game environment server running, you can connect directly:
+
+```python
+from my_game import MyGameEnv
+
+# Connect to existing server
+my_gameenv = MyGameEnv(base_url="<ENV_HTTP_URL_HERE>")
+
+# Use as normal
+result = my_gameenv.reset()
+result = my_gameenv.step(MyGameAction(message="Hello!"))
+```
+
+Note: When connecting to an existing server, `my_gameenv.close()` will NOT stop the server.
+
+## Development & Testing
+
+### Direct Environment Testing
+
+Test the environment logic directly without starting the HTTP server:
+
+```bash
+# From the server directory
+python3 server/my_game_environment.py
+```
+
+This verifies that:
+- Environment resets correctly
+- Step executes actions properly
+- State tracking works
+- Rewards are calculated correctly
+
+### Running Locally
+
+Run the server locally for development:
+
+```bash
+uvicorn server.app:app --reload
+```
+
+## Project Structure
+
+```
+my_game/
+├── .dockerignore         # Docker build exclusions
+├── __init__.py            # Module exports
+├── README.md              # This file
+├── openenv.yaml           # OpenEnv manifest
+├── pyproject.toml         # Project metadata and dependencies
+├── uv.lock                # Locked dependencies (generated)
+├── client.py              # MyGameEnv client implementation
+├── models.py              # Action and Observation models
+└── server/
+    ├── __init__.py        # Server module exports
+    ├── my_game_environment.py  # Core environment logic
+    ├── app.py             # FastAPI application
+    └── Dockerfile         # Container image definition
+```

__init__.py

@@ -0,0 +1,12 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+
+"""Chess Environment - RL agent (White) vs random bot (Black)."""
+
+from .client import ChessEnv
+from .models import ChessAction, ChessObservation
+
+__all__ = ["ChessAction", "ChessObservation", "ChessEnv"]

client.py

@@ -0,0 +1,70 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+
+"""
+Chess Environment HTTP Client.
+
+This module provides the client for connecting to a Chess Environment server
+over HTTP.
+"""
+
+from typing import Any, Dict, Optional
+
+from openenv_core.client_types import StepResult
+from openenv_core.env_server.types import State
+from openenv_core.http_env_client import HTTPEnvClient
+
+from .models import ChessAction, ChessObservation
+
+
+class ChessEnv(HTTPEnvClient[ChessAction, ChessObservation]):
+    """
+    HTTP client for the Chess Environment.
+
+    This client connects to a ChessEnvironment HTTP server and provides
+    methods to interact with it: reset(), step(), and state access.
+
+    Example:
+        >>> client = ChessEnv(base_url="http://localhost:8000")
+        >>> result = client.reset()
+        >>> print(result.observation.board_fen)
+        >>>
+        >>> result = client.step(ChessAction(move="e2e4"))
+        >>> print(result.observation.game_status)
+        >>> print(result.reward)
+    """
+
+    def _step_payload(self, action: ChessAction) -> Dict:
+        return {
+            "move": action.move,
+        }
+
+    def _parse_result(self, payload: Dict) -> StepResult[ChessObservation]:
+        obs_data = payload.get("observation", {})
+        observation = ChessObservation(
+            board_fen=obs_data.get("board_fen", ""),
+            legal_moves=obs_data.get("legal_moves", []),
+            white_move=obs_data.get("white_move", ""),
+            black_move=obs_data.get("black_move"),
+            material_balance=obs_data.get("material_balance", 0.0),
+            game_status=obs_data.get("game_status", "ongoing"),
+            captured_pieces=obs_data.get("captured_pieces", []),
+            done=payload.get("done", False),
+            reward=payload.get("reward"),
+            metadata=obs_data.get("metadata", {}),
+        )
+
+        return StepResult(
+            observation=observation,
+            reward=payload.get("reward"),
+            done=payload.get("done", False),
+        )
+
+    def _parse_state(self, payload: Dict) -> State:
+        return State(
+            episode_id=payload.get("episode_id"),
+            step_count=payload.get("step_count", 0),
+        )

models.py

@@ -0,0 +1,36 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+
+"""
+Data models for the Chess Environment.
+
+The chess environment lets an RL agent play White against a random bot (Black).
+"""
+
+from dataclasses import dataclass, field
+from typing import List, Optional
+
+from openenv_core.env_server.types import Action, Observation
+
+
+@dataclass(kw_only=True)
+class ChessAction(Action):
+    """Action for the Chess environment — a UCI move string (e.g. 'e2e4')."""
+
+    move: str
+
+
+@dataclass(kw_only=True)
+class ChessObservation(Observation):
+    """Observation from the Chess environment."""
+
+    board_fen: str
+    legal_moves: List[str] = field(default_factory=list)
+    white_move: str = ""
+    black_move: Optional[str] = None
+    material_balance: float = 0.0
+    game_status: str = "ongoing"
+    captured_pieces: List[str] = field(default_factory=list)

openenv.yaml

@@ -0,0 +1,6 @@
+spec_version: 1
+name: chess
+type: space
+runtime: fastapi
+app: server.app:app
+port: 8000

openenv_my_game.egg-info/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: openenv-my_game
+Version: 0.1.0
+Summary: My Game environment for OpenEnv
+Requires-Python: >=3.10
+Requires-Dist: openenv-core>=0.1.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: uvicorn>=0.24.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: chess>=1.10.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"

openenv_my_game.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+README.md
+pyproject.toml
+./__init__.py
+./client.py
+./models.py
+openenv_my_game.egg-info/PKG-INFO
+openenv_my_game.egg-info/SOURCES.txt
+openenv_my_game.egg-info/dependency_links.txt
+openenv_my_game.egg-info/entry_points.txt
+openenv_my_game.egg-info/requires.txt
+openenv_my_game.egg-info/top_level.txt
+server/__init__.py
+server/app.py
+server/my_game_environment.py

openenv_my_game.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

openenv_my_game.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+server = my_game.server.app:main

openenv_my_game.egg-info/requires.txt

@@ -0,0 +1,10 @@
+openenv-core>=0.1.0
+fastapi>=0.115.0
+pydantic>=2.0.0
+uvicorn>=0.24.0
+requests>=2.31.0
+chess>=1.10.0
+
+[dev]
+pytest>=8.0.0
+pytest-cov>=4.0.0

openenv_my_game.egg-info/top_level.txt

@@ -0,0 +1 @@
+my_game

pyproject.toml

@@ -0,0 +1,42 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "openenv-my_game"
+version = "0.1.0"
+description = "My Game environment for OpenEnv"
+requires-python = ">=3.10"
+dependencies = [
+    # Core OpenEnv dependencies (required for server functionality)
+    # "openenv-core @ git+https://github.com/meta-pytorch/OpenEnv.git@main#subdirectory=src/core",
+    "openenv-core>=0.1.0",
+    "fastapi>=0.115.0",
+    "pydantic>=2.0.0",
+    "uvicorn>=0.24.0",
+    "requests>=2.31.0",
+    # Environment-specific dependencies
+    "chess>=1.10.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-cov>=4.0.0",
+]
+
+[project.scripts]
+# Server entry point - enables running via: uv run --project . server
+# or: python -m my_game.server.app
+server = "my_game.server.app:main"
+
+[tool.setuptools]
+include-package-data = true
+packages = ["my_game", "my_game.server"]
+package-dir = { "my_game" = ".", "my_game.server" = "server" }

server/__init__.py

@@ -0,0 +1,11 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+
+"""Chess environment server components."""
+
+from .my_game_environment import ChessEnvironment
+
+__all__ = ["ChessEnvironment"]

server/app.py

@@ -0,0 +1,72 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+
+"""
+FastAPI application for the Chess Environment.
+
+This module creates an HTTP server that exposes the ChessEnvironment
+over HTTP endpoints, making it compatible with HTTPEnvClient.
+
+Usage:
+    # Development (with auto-reload):
+    uvicorn server.app:app --reload --host 0.0.0.0 --port 8000
+
+    # Production:
+    uvicorn server.app:app --host 0.0.0.0 --port 8000 --workers 4
+
+    # Or run directly:
+    python -m server.app
+"""
+
+try:
+    from openenv_core.env_server.http_server import create_app
+except Exception as e:  # pragma: no cover
+    raise ImportError("openenv_core is required for the web interface. Install dependencies with '\n    uv sync\n'") from e
+
+from .my_game_environment import ChessEnvironment
+from models import ChessAction, ChessObservation
+
+# Create the environment instance
+env = ChessEnvironment()
+
+# Create the app with web interface and README integration
+app = create_app(
+    env,
+    ChessAction,
+    ChessObservation,
+    env_name="chess",
+)
+
+
+def main(host: str = "0.0.0.0", port: int = 8000):
+    """
+    Entry point for direct execution via uv run or python -m.
+
+    This function enables running the server without Docker:
+        uv run --project . server
+        uv run --project . server --port 8001
+        python -m my_game.server.app
+
+    Args:
+        host: Host address to bind to (default: "0.0.0.0")
+        port: Port number to listen on (default: 8000)
+
+    For production deployments, consider using uvicorn directly with
+    multiple workers:
+        uvicorn my_game.server.app:app --workers 4
+    """
+    import uvicorn
+
+    uvicorn.run(app, host=host, port=port)
+
+
+if __name__ == "__main__":
+    import argparse
+
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--port", type=int, default=8000)
+    args = parser.parse_args()
+    main(port=args.port)

server/my_game_environment.py

@@ -0,0 +1,191 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+
+"""
+Chess Environment Implementation.
+
+An RL agent plays White against a random bot (Black).
+Reward is shaped: per-move material delta + terminal win/loss/draw bonus.
+"""
+
+import random
+from typing import List
+from uuid import uuid4
+
+import chess
+
+from openenv_core.env_server.interfaces import Environment
+from openenv_core.env_server.types import State
+
+from models import ChessAction, ChessObservation
+
+# Piece values: P=1, N=3, B=3, R=5, Q=9
+PIECE_VALUES = {
+    chess.PAWN: 1,
+    chess.KNIGHT: 3,
+    chess.BISHOP: 3,
+    chess.ROOK: 5,
+    chess.QUEEN: 9,
+}
+
+
+class ChessEnvironment(Environment):
+    """
+    Chess environment where an RL agent (White) plays against a random bot (Black).
+
+    Reward shaping:
+      - material_delta: change in (White material - Black material) each step
+      - terminal bonus: +1 for win, -1 for loss, 0 for draw
+    """
+
+    def __init__(self):
+        self._board = chess.Board()
+        self._state = State(episode_id=str(uuid4()), step_count=0)
+        self._captured_pieces: List[str] = []
+
+    def reset(self) -> ChessObservation:
+        self._board = chess.Board()
+        self._state = State(episode_id=str(uuid4()), step_count=0)
+        self._captured_pieces = []
+
+        return ChessObservation(
+            board_fen=self._board.fen(),
+            legal_moves=[m.uci() for m in self._board.legal_moves],
+            white_move="",
+            black_move=None,
+            material_balance=0.0,
+            game_status="ongoing",
+            captured_pieces=[],
+            done=False,
+            reward=0.0,
+        )
+
+    def step(self, action: ChessAction) -> ChessObservation:  # type: ignore[override]
+        # --- validate ---
+        try:
+            move = chess.Move.from_uci(action.move)
+        except (chess.InvalidMoveError, ValueError) as exc:
+            raise ValueError(f"Invalid UCI string: {action.move!r}") from exc
+
+        if move not in self._board.legal_moves:
+            raise ValueError(
+                f"Illegal move: {action.move!r}. "
+                f"Legal moves: {[m.uci() for m in self._board.legal_moves]}"
+            )
+
+        self._state.step_count += 1
+        balance_before = self._material_balance()
+
+        # --- White's move ---
+        self._track_capture(move)
+        self._board.push(move)
+        white_uci = action.move
+
+        # check if game ended after White's move
+        status = self._get_game_status()
+        if self._is_terminal_status(status):
+            balance_after = self._material_balance()
+            material_delta = balance_after - balance_before
+            reward = material_delta + self._terminal_reward(status)
+            return ChessObservation(
+                board_fen=self._board.fen(),
+                legal_moves=[],
+                white_move=white_uci,
+                black_move=None,
+                material_balance=balance_after,
+                game_status=status,
+                captured_pieces=list(self._captured_pieces),
+                done=True,
+                reward=reward,
+            )
+
+        # --- Black's move (random) ---
+        black_moves = list(self._board.legal_moves)
+        black_move = random.choice(black_moves)
+        self._track_capture(black_move)
+        self._board.push(black_move)
+        black_uci = black_move.uci()
+
+        # --- post-move evaluation ---
+        status = self._get_game_status()
+        balance_after = self._material_balance()
+        material_delta = balance_after - balance_before
+        terminal = self._is_terminal_status(status)
+        reward = material_delta + (self._terminal_reward(status) if terminal else 0.0)
+
+        return ChessObservation(
+            board_fen=self._board.fen(),
+            legal_moves=[m.uci() for m in self._board.legal_moves] if not terminal else [],
+            white_move=white_uci,
+            black_move=black_uci,
+            material_balance=balance_after,
+            game_status=status,
+            captured_pieces=list(self._captured_pieces),
+            done=terminal,
+            reward=reward,
+        )
+
+    # ------------------------------------------------------------------
+    # Helpers
+    # ------------------------------------------------------------------
+
+    def _track_capture(self, move: chess.Move) -> None:
+        """Record a captured piece symbol (handles en passant)."""
+        board = self._board
+        if board.is_en_passant(move):
+            self._captured_pieces.append(chess.piece_symbol(chess.PAWN))
+        elif board.piece_at(move.to_square) is not None:
+            self._captured_pieces.append(board.piece_at(move.to_square).symbol())
+
+    def _material_balance(self) -> float:
+        """Return White material minus Black material."""
+        white = 0.0
+        black = 0.0
+        for sq in chess.SQUARES:
+            piece = self._board.piece_at(sq)
+            if piece is None:
+                continue
+            val = PIECE_VALUES.get(piece.piece_type, 0)
+            if piece.color == chess.WHITE:
+                white += val
+            else:
+                black += val
+        return white - black
+
+    def _get_game_status(self) -> str:
+        b = self._board
+        if b.is_checkmate():
+            return "checkmate"
+        if b.is_stalemate():
+            return "stalemate"
+        if b.is_insufficient_material():
+            return "draw_insufficient"
+        if b.is_fifty_moves():
+            return "draw_fifty"
+        if b.is_repetition():
+            return "draw_repetition"
+        if b.is_check():
+            return "check"
+        return "ongoing"
+
+    @staticmethod
+    def _is_terminal_status(status: str) -> bool:
+        return status in ("checkmate", "stalemate", "draw_insufficient",
+                          "draw_fifty", "draw_repetition")
+
+    def _terminal_reward(self, status: str) -> float:
+        if status == "checkmate":
+            # whoever is to move is in checkmate → they lost
+            if self._board.turn == chess.BLACK:
+                return 1.0   # White delivered checkmate
+            else:
+                return -1.0  # Black delivered checkmate
+        # all other terminal states are draws
+        return 0.0
+
+    @property
+    def state(self) -> State:
+        return self._state