# OpenEnv Environment Manifest
# This file is read by `openenv push` — schema must match OpenEnv CLI exactly.
# HF Spaces fields (build/resources/sdk) go in README.md YAML front-matter, NOT here.

name: fairrecovery
version: "1.0.0"
description: >
  Post-disaster city recovery RL environment. An LLM agent allocates limited 
  resources (power, water, medical) across disaster zones, optimising both 
  efficiency and fairness for vulnerable populations over a 5-day episode. 
  Features a fairness trap: naive utility-maximising agents ignore the highest-need 
  zones. Trained agents learn to balance recovery equity vs speed.
entry_point: server.app:app

themes:
  primary: "3.1 - Real-World Professional Tasks"
  secondary: "2 - Long-Horizon Planning"

tags:
  - fairness
  - disaster-recovery
  - humanitarian-ai
  - rlvr
  - multi-objective
  - long-horizon

server:
  host: "0.0.0.0"
  port: 7860            # HF Spaces uses 7860

action_space:
  type: structured
  description: "Multi-step protocol: analyze → allocate → execute → submit"

observation_space:
  type: structured
  description: "Zone state (damage, service, vulnerability) + budget + day"

reward:
  type: dense
  components:
    - name: R_exec
      weight: 1.0
      description: "Average service improvement from allocations"
    - name: R_fair
      weight: 0.7
      description: "Negative disparity between vulnerable vs non-vulnerable zones"
    - name: R_safe
      weight: 0.3
      description: "Constraint satisfaction (no invalid actions or budget overflows)"