app/env/client.py

"""Simple HTTP client for the local env service."""

from __future__ import annotations

from typing import Any

import requests


class PolyGuardEnvClient:
    def __init__(self, base_url: str = "http://127.0.0.1:8100") -> None:
        self.base_url = base_url.rstrip("/")

    def reset(self, **kwargs: Any) -> dict[str, Any]:
        response = requests.post(f"{self.base_url}/env/reset", json=kwargs, timeout=30)
        response.raise_for_status()
        return response.json()

    def step(self, action: dict[str, Any]) -> dict[str, Any]:
        response = requests.post(f"{self.base_url}/env/step", json=action, timeout=30)
        response.raise_for_status()
        return response.json()

    def state(self) -> dict[str, Any]:
        response = requests.get(f"{self.base_url}/env/state", timeout=30)
        response.raise_for_status()
        return response.json()

    def trace(self) -> list[dict[str, Any]]:
        response = requests.get(f"{self.base_url}/env/trace", timeout=30)
        response.raise_for_status()
        return response.json()

    def legal_actions(self) -> list[dict[str, Any]]:
        response = requests.get(f"{self.base_url}/env/legal_actions", timeout=30)
        response.raise_for_status()
        return response.json()

    def reward_breakdown(self) -> dict[str, Any]:
        response = requests.get(f"{self.base_url}/env/reward_breakdown", timeout=30)
        response.raise_for_status()
        return response.json()

    def uncertainty(self) -> dict[str, Any]:
        response = requests.get(f"{self.base_url}/env/uncertainty", timeout=30)
        response.raise_for_status()
        return response.json()

    def metadata(self) -> dict[str, Any]:
        response = requests.get(f"{self.base_url}/metadata", timeout=30)
        response.raise_for_status()
        return response.json()

    def schema(self) -> dict[str, Any]:
        response = requests.get(f"{self.base_url}/schema", timeout=30)
        response.raise_for_status()
        return response.json()

    def mcp(self, payload: dict[str, Any] | None = None) -> dict[str, Any]:
        response = requests.post(f"{self.base_url}/mcp", json=payload or {}, timeout=30)
        response.raise_for_status()
        return response.json()