README.md

# OpenEnv: Email Triage & Scheduling Assistant (EmailEnv-v1) 📧🚀

**EmailTriage-v1** is a high-utility, real-world task simulation designed for evaluating the decision-making and logical reasoning of agentic workflows. This environment bridges the gap between toy grid-worlds and actual professional productivity tasks.

## 🌟 Motivation & Real-World Utility (30% Weight)
Manual email management is a labor-intensive professional task. This environment models the **Email Triage Assistant** role, a critical function in modern digital workflows. Agents are evaluated on their ability to:
- **Prioritize**: Distinguish between high-stakes meeting requests and low-value noise.
- **Categorize**: Maintain a structured workspace by sorting multi-topic communications.
- **Coordinate**: Resolve scheduling conflicts using real-time calendar cross-referencing—a task that requires logical deduction and conflict resolution.

## 🏗️ Environment Design (20% Weight)

### Observation Space (Pydantic Typed)
The agent receives a rich state snapshot including:
- **`inbox_count`**: Real-time counter of unprocessed items.
- **`current_email`**: A structured object containing the sender, subject, body, and priority.
- **`calendar`**: A list of events representing the agent's current "busy" times.

### Action Space (Pydantic Typed)
The agent can interact with the environment via four high-level professional actions:
- **`MOVE`**: Relocate emails to folders (Archive, Work, Social, Spam).
- **`DELETE`**: Permanent removal of high-risk items (Spam).
- **`REPLY/SCHEDULE`**: Contextual interactions that require generating appropriate reply text (e.g., confirming a 2 PM slot).

## 📊 Task Difficulty Progression (25% Weight)

| Task ID | Level | Objective | Grader / Success Criteria |
|---------|-------|-----------|---------------------------|
| **1: Spam Guard** | Easy | Identify and archive a clear spam email ($1M claims). | Successfully move the spam ID to the "Spam" folder. |
| **2: Inbox Zero** | Medium | Categorize a mixture of work and social updates. | Correctly sort all items without misplacing a priority email. |
| **3: Coordinator**| Hard | Schedule a new 2 PM meeting while avoiding a 10 AM conflict. | Generate a reply correctly confirming the non-conflicting time. |

## 🚀 Setup & Usage
1. **API Key**: Set your `OPENAI_API_KEY` in your environment.
2. **Launch Server**: `python main.py`
3. **Run Baseline**: `python inference.py`

**License**: MIT