client.py

"""Origami environment client — connects to a running origami_env server."""

from typing import Any, Dict

from openenv.core.client_types import StepResult
from openenv.core.env_client import EnvClient

from origami_server.models import OrigamiAction, OrigamiObservation, OrigamiState


class OrigamiEnv(EnvClient[OrigamiAction, OrigamiObservation, OrigamiState]):
    """
    Client for the origami RL environment.

    Example:
        >>> with OrigamiEnv(base_url="http://localhost:8000") as env:
        ...     result = env.reset(task_name="triangle")
        ...     result = env.step(OrigamiAction(fold_data={...}))
        ...     print(result.observation.shape_similarity)

        >>> # From HuggingFace Spaces
        >>> env = OrigamiEnv.from_env("username/origami_env")
    """

    def _step_payload(self, action: OrigamiAction) -> Dict[str, Any]:
        return action.model_dump()

    def _parse_result(self, payload: Dict[str, Any]) -> StepResult[OrigamiObservation]:
        obs_data = payload.get("observation", payload)
        return StepResult(
            observation=OrigamiObservation(**obs_data),
            reward=payload.get("reward"),
            done=payload.get("done", False),
        )

    def _parse_state(self, payload: Dict[str, Any]) -> OrigamiState:
        return OrigamiState(**payload)