feat: env metadata

Author: rycerzes

src/core/env_server/http_server.py

@@ -31,6 +31,7 @@
     State,
     StepRequest,
     StepResponse,
+    EnvironmentMetadata,
 )
 
 
@@ -135,7 +136,11 @@ async def reset(
                 if k in sig.parameters or has_kwargs:
                     valid_kwargs[k] = v
 
-            observation = self.env.reset(**valid_kwargs)
+            # Run synchronous reset in thread pool to avoid blocking event loop
+            loop = asyncio.get_event_loop()
+            observation = await loop.run_in_executor(
+                self._executor, lambda: self.env.reset(**valid_kwargs)
+            )
             return ResetResponse(**self._serialize_observation(observation))
 
         @app.post(
@@ -217,8 +222,11 @@ async def step(request: StepRequest) -> StepResponse:
                 if k in sig.parameters or has_kwargs:
                     valid_kwargs[k] = v
 
-            # Execute step
-            observation = self.env.step(action, **valid_kwargs)
+            # Run synchronous step in thread pool to avoid blocking event loop
+            loop = asyncio.get_event_loop()
+            observation = await loop.run_in_executor(
+                self._executor, lambda: self.env.step(action, **valid_kwargs)
+            )
 
             # Return serialized observation
             return StepResponse(**self._serialize_observation(observation))
@@ -239,6 +247,27 @@ async def get_state() -> State:
             """State endpoint - returns current environment state."""
             return self.env.state
 
+        @app.get(
+            "/metadata",
+            response_model=EnvironmentMetadata,
+            tags=["Environment Info"],
+            summary="Get environment metadata",
+            description="""
+Get metadata about this environment.
+
+Returns information about the environment including name, description,
+version, author, and documentation links.
+            """,
+        )
+        async def get_metadata() -> EnvironmentMetadata:
+            """
+            Get metadata about this environment.
+
+            Returns information about the environment including name, description,
+            version, author, and documentation links.
+            """
+            return self.env.get_metadata()
+
         @app.get(
             "/health",
             tags=["Health"],
@@ -473,6 +502,10 @@ def create_fastapi_app(
                 "name": "State Management",
                 "description": "Operations for inspecting environment state",
             },
+            {
+                "name": "Environment Info",
+                "description": "Information about the environment",
+            },
             {
                 "name": "Schema",
                 "description": "JSON Schema endpoints for actions, observations, and state",

src/core/env_server/interfaces.py

@@ -7,7 +7,7 @@
 from abc import ABC, abstractmethod
 from typing import Any, Optional, Protocol, TypedDict
 
-from .types import Action, Observation, State
+from .types import Action, Observation, State, EnvironmentMetadata
 
 
 class Message(TypedDict):
@@ -121,6 +121,22 @@ def state(self) -> State:
         """Get the current environment state."""
         pass
 
+    def get_metadata(self) -> EnvironmentMetadata:
+        """
+        Get metadata about this environment.
+
+        Override this method to provide custom metadata for the environment.
+        Default implementation returns basic metadata derived from class name.
+
+        Returns:
+            EnvironmentMetadata with environment information
+        """
+        return EnvironmentMetadata(
+            name=self.__class__.__name__,
+            description=f"{self.__class__.__name__} environment",
+            version="1.0.0",
+        )
+
     def _apply_transform(self, observation: Observation) -> Observation:
         """Apply transform if one is provided."""
         if self.transform is not None: