# OpenEnv Environment Manifest
# TradeStorm — Global Supply Chain Simulator

name: tradestorm-supply-chain
version: "1.0.0"
description: >
  A global supply chain simulation environment where agents must optimize
  factory sourcing, port routing, and warehouse inventory management across
  6 regions while navigating geopolitical shocks, demand volatility, and
  dynamic pricing. Agents are evaluated on financial performance, stockout
  avoidance, and inventory efficiency over a 24-month horizon.

authors:
  - name: TradeStorm Team

environment:
  class: server.openenv_wrapper.SupplyChainEnv
  max_turns: 24

observation_space:
  type: json
  schema:
    Month: integer
    Funds: float
    Demands:
      type: object
      properties: { usa: int, eu: int, asia: int, mideast: int, latam: int, oceania: int }
    Inventory:
      type: object
      properties: { usa: int, eu: int, asia: int, mideast: int, latam: int, oceania: int }
    Factory_Costs:
      type: object
      description: "Mapping of factory_id to current unit cost"
    Port_Delays:
      type: object
      description: "Mapping of port_id to delay in months or 'CLOSED'"

action_space:
  type: json
  actions:
    - name: order
      description: "Place a manufacturing order from a factory through a port to a warehouse"
      parameters:
        action: { type: string, const: "order" }
        factory: { type: string, enum: [china, india, mexico, vietnam, brazil, germany] }
        quantity: { type: integer, min: 10, max: 500 }
        port: { type: string, enum: [shanghai, singapore, rotterdam, la, busan, dubai, santos] }
        dest: { type: string, enum: [usa, eu, asia, mideast, latam, oceania] }
    - name: advance
      description: "Advance the simulation by one month (processes shipments, fulfills demand, applies shocks)"
      parameters:
        action: { type: string, const: "advance" }

reward:
  type: composite
  components:
    - name: FinancialRubric
      weight: 1.0
      description: "Rewards balance growth (profit / 1000)"
    - name: StockoutRubric
      weight: 1.0
      description: "Heavy penalty for unmet demand (-10 per missed unit)"
    - name: OverstockRubric
      weight: 1.0
      description: "Penalty for holding >2x demand in inventory (-2 per excess unit)"

termination:
  conditions:
    - "Turn >= 24 (end of simulation horizon)"
    - "Balance <= 0 (bankruptcy)"

metadata:
  hackathon: OpenEnv
  category: logistics-simulation
  difficulty: intermediate
  tags: [supply-chain, logistics, optimization, reinforcement-learning]