# hiteshfirke/workscheduler-openenv architecture

> Architecture diagram of the GitHub repository hiteshfirke/workscheduler-openenv, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hiteshfirke/workscheduler-openenv
- Repository: https://github.com/hiteshfirke/workscheduler-openenv

## Overview

WorkScheduler-OpenEnv is a task-scheduling environment for agents: an agent starts an episode, receives task and worker observations, submits assignments, and gets updated observations and rewards. The scheduler models skill, capacity, dependency, deadline, budget, and disruption rules across difficulty modes; graders score completed episodes. The HTTP API also exposes state, metadata, grading, and a live demo. Source excerpts show the API-to-environment and grader-to-environment relationships; the scheduler’s internal event handling is only partially excerpted.

Main entry points: [`server/app.py`](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/server/app.py) (HTTP API), [`env/scheduler.py`](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/env/scheduler.py) (Episode environment), [`inference.py`](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/inference.py) (Inference runner), [`tasks/easy.py`](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/tasks/easy.py) (Easy grader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Agent interfaces"]
  node_http_api["HTTP API<br/>[app.py]"]
  node_sessions["Episode sessions<br/>[app.py]"]
  node_demo_page["Demo page<br/>[demo.html]"]
end

subgraph group_runtime["Scheduling runtime"]
  node_environment["Episode environment<br/>[scheduler.py]"]
  node_scenario_data["Difficulty scenarios<br/>[scheduler.py]"]
  node_domain_models["Scheduling models<br/>[models.py]"]
end

subgraph group_grading["Difficulty graders"]
  node_easy_grader["Easy grader<br/>[easy.py]"]
  node_medium_grader["Medium grader<br/>[medium.py]"]
  node_hard_grader["Hard grader<br/>[hard.py]"]
  node_expert_grader["Expert grader<br/>[expert.py]"]
  node_multi_grader["Multi grader<br/>[multi.py]"]
end

subgraph group_agent["Inference agent"]
  node_inference_runner["Inference runner<br/>[inference.py]"]
end

node_agent_client(("Scheduling agent"))
node_llm_service(("LLM service"))

node_agent_client -->|"sends episode requests"| node_http_api
node_http_api -->|"stores and retrieves"| node_sessions
node_http_api -->|"creates and steps"| node_environment
node_http_api -->|"dispatches grading"| node_easy_grader
node_http_api -->|"dispatches grading"| node_medium_grader
node_http_api -->|"dispatches grading"| node_hard_grader
node_http_api -->|"dispatches grading"| node_expert_grader
node_http_api -->|"dispatches grading"| node_multi_grader
node_http_api -->|"serves page"| node_demo_page
node_environment -->|"selects difficulty data"| node_scenario_data
node_environment -->|"builds observations and rewards"| node_domain_models
node_easy_grader -->|"runs and scores"| node_environment
node_medium_grader -->|"runs and scores"| node_environment
node_hard_grader -->|"runs and scores"| node_environment
node_expert_grader -->|"runs and scores"| node_environment
node_multi_grader -->|"runs and scores"| node_environment
node_inference_runner -->|"runs episodes"| node_environment
node_inference_runner -->|"grades easy runs"| node_easy_grader
node_inference_runner -->|"grades medium runs"| node_medium_grader
node_inference_runner -->|"grades hard runs"| node_hard_grader
node_inference_runner -.->|"requests actions"| node_llm_service

click node_http_api "https://github.com/hiteshfirke/workscheduler-openenv/blob/main/server/app.py"
click node_sessions "https://github.com/hiteshfirke/workscheduler-openenv/blob/main/server/app.py"
click node_demo_page "https://github.com/hiteshfirke/workscheduler-openenv/blob/main/server/demo.html"
click node_environment "https://github.com/hiteshfirke/workscheduler-openenv/blob/main/env/scheduler.py"
click node_scenario_data "https://github.com/hiteshfirke/workscheduler-openenv/blob/main/env/scheduler.py"
click node_domain_models "https://github.com/hiteshfirke/workscheduler-openenv/blob/main/env/models.py"
click node_easy_grader "https://github.com/hiteshfirke/workscheduler-openenv/blob/main/tasks/easy.py"
click node_medium_grader "https://github.com/hiteshfirke/workscheduler-openenv/blob/main/tasks/medium.py"
click node_hard_grader "https://github.com/hiteshfirke/workscheduler-openenv/blob/main/tasks/hard.py"
click node_expert_grader "https://github.com/hiteshfirke/workscheduler-openenv/blob/main/tasks/expert.py"
click node_multi_grader "https://github.com/hiteshfirke/workscheduler-openenv/blob/main/tasks/multi.py"
click node_inference_runner "https://github.com/hiteshfirke/workscheduler-openenv/blob/main/inference.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_http_api,node_sessions,node_demo_page toneBlue
class node_environment,node_scenario_data,node_domain_models toneAmber
class node_easy_grader,node_medium_grader,node_hard_grader,node_expert_grader,node_multi_grader toneMint
class node_inference_runner toneRose
class node_agent_client,node_llm_service toneIndigo
```

## Components

### Agent interfaces

- [HTTP API](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/server/app.py): `server/app.py`
- [Episode sessions](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/server/app.py): `server/app.py`
- [Demo page](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/server/demo.html): `server/demo.html`

### Scheduling runtime

- [Episode environment](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/env/scheduler.py): `env/scheduler.py`
- [Difficulty scenarios](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/env/scheduler.py): `env/scheduler.py`
- [Scheduling models](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/env/models.py): `env/models.py`

### Difficulty graders

- [Easy grader](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/tasks/easy.py): `tasks/easy.py`
- [Medium grader](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/tasks/medium.py): `tasks/medium.py`
- [Hard grader](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/tasks/hard.py): `tasks/hard.py`
- [Expert grader](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/tasks/expert.py): `tasks/expert.py`
- [Multi grader](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/tasks/multi.py): `tasks/multi.py`

### Inference agent

- [Inference runner](https://github.com/hiteshfirke/workscheduler-openenv/blob/main/inference.py): `inference.py`

### Other components

- **Scheduling agent**
- **LLM service**

## Connections

- Scheduling agent → HTTP API: sends episode requests (evidence: `README.md`)
- HTTP API → Episode sessions: stores and retrieves (evidence: `server/app.py`)
- HTTP API → Episode environment: creates and steps (evidence: `server/app.py`)
- HTTP API → Easy grader: dispatches grading (evidence: `server/app.py`)
- HTTP API → Medium grader: dispatches grading (evidence: `server/app.py`)
- HTTP API → Hard grader: dispatches grading (evidence: `server/app.py`)
- HTTP API → Expert grader: dispatches grading (evidence: `server/app.py`)
- HTTP API → Multi grader: dispatches grading (evidence: `server/app.py`)
- HTTP API → Demo page: serves page (evidence: `server/app.py`)
- Episode environment → Difficulty scenarios: selects difficulty data (evidence: `env/scheduler.py`)
- Episode environment → Scheduling models: builds observations and rewards (evidence: `env/scheduler.py`)
- Easy grader → Episode environment: runs and scores (evidence: `tasks/easy.py`)
- Medium grader → Episode environment: runs and scores (evidence: `tasks/medium.py`)
- Hard grader → Episode environment: runs and scores (evidence: `tasks/hard.py`)
- Expert grader → Episode environment: runs and scores (evidence: `tasks/expert.py`)
- Multi grader → Episode environment: runs and scores (evidence: `tasks/multi.py`)
- Inference runner → Episode environment: runs episodes (evidence: `inference.py`)
- Inference runner → Easy grader: grades easy runs (evidence: `inference.py`)
- Inference runner → Medium grader: grades medium runs (evidence: `inference.py`)
- Inference runner → Hard grader: grades hard runs (evidence: `inference.py`)
- Inference runner → LLM service: requests actions (evidence: `inference.py`)
