missionctrl_env / client.py
Jit-fnc's picture
Upload folder using huggingface_hub
9c4d9c0 verified
Raw History Blame Contribute Delete
4.69 kB
"""Client library for MissionCtrl environment.
Provides HTTP client functions for interacting with the MissionCtrl environment API.
Contains environment payload structures and example scenarios.
"""
import os
from typing import Any, Dict, Optional
import httpx
from dotenv import load_dotenv
# ---------------------------------------------------------------------------
# Load .env file automatically
# ---------------------------------------------------------------------------
load_dotenv()
# ---------------------------------------------------------------------------
# Environment configuration
# ---------------------------------------------------------------------------
ENV_BASE_URL: str = os.environ.get("ENV_BASE_URL", "http://localhost:7860")
# Known agent types in the environment
KNOWN_AGENTS = (
"PlannerAgent",
"ResearchAgent",
"CoderAgent",
"TesterAgent",
"CommAgent",
)
# Available task tiers
TASKS = ["easy", "medium", "hard", "special"]
# Default max steps per episode
MAX_STEPS = 5
# ---------------------------------------------------------------------------
# HTTP Client
# ---------------------------------------------------------------------------
http = httpx.Client(timeout=60.0)
# ---------------------------------------------------------------------------
# Environment API Functions
# ---------------------------------------------------------------------------
def reset_env(task_id: str, seed: Optional[int] = None) -> Dict[str, Any]:
"""Reset the environment for a specific task.
Args:
task_id: The task tier to run (easy, medium, hard, special)
seed: Optional random seed for reproducibility
Returns:
Dictionary containing the initial observation
"""
payload = {"task_id": task_id}
if seed is not None:
payload["seed"] = seed
resp = http.post(f"{ENV_BASE_URL}/reset", json=payload)
resp.raise_for_status()
return resp.json()
def step_env(action: str) -> Dict[str, Any]:
"""Execute one action in the environment.
Args:
action: The action string to execute (e.g., "APPROVE(task_1)")
Returns:
Dictionary containing the new observation, reward, done flag, and info
"""
resp = http.post(f"{ENV_BASE_URL}/step", json={"action": action})
resp.raise_for_status()
return resp.json()
def get_state() -> Dict[str, Any]:
"""Get the current environment state (read-only).
Returns:
Dictionary containing the current observation
"""
resp = http.get(f"{ENV_BASE_URL}/state")
resp.raise_for_status()
return resp.json()
def get_history() -> list:
"""Get the action history for the current episode.
Returns:
List of past actions and their results
"""
resp = http.get(f"{ENV_BASE_URL}/history")
resp.raise_for_status()
return resp.json()
def record_result(tier: str, score: float, steps: int, history: list,
score_breakdown: Optional[Dict] = None,
hallucination_stats: Optional[Dict] = None) -> Dict[str, str]:
"""Push a completed episode result to the dashboard.
Args:
tier: Task tier (easy, medium, hard, special)
score: Final score for the episode
steps: Number of steps taken
history: Action history for the episode
score_breakdown: Optional detailed score breakdown
hallucination_stats: Optional hallucination detection statistics
Returns:
Confirmation response
"""
payload = {
"tier": tier,
"score": score,
"steps": steps,
"history": history,
"score_breakdown": score_breakdown or {},
"hallucination_stats": hallucination_stats or {},
}
resp = http.post(f"{ENV_BASE_URL}/record", json=payload)
resp.raise_for_status()
return resp.json()
# ---------------------------------------------------------------------------
# Example Usage
# ---------------------------------------------------------------------------
def example_basic_usage():
"""Example showing basic environment interaction."""
# Reset environment for easy task
result = reset_env("easy")
obs = result["observation"]
print(f"Started task with {len(obs['tasks'])} tasks")
# Take a step
step_result = step_env("NOOP")
print(f"Reward: {step_result['reward']}, Done: {step_result['done']}")
# Get current state
state = get_state()
print(f"Current step: {state['time_step']}")
if __name__ == "__main__":
# For backward compatibility, delegate to inference script
from inference import main
main()