Sync README

README.md

@@ -1,17 +1,17 @@
----
-title: Customer Support OpenEnv
-emoji: "🎫"
-colorFrom: blue
-colorTo: green
-sdk: docker
-app_port: 8000
-short_description: Deterministic B2B SaaS support benchmark.
-pinned: false
----
-
-# AcmeCloud Customer Support Ticket Handler
-
-A deterministic OpenEnv-style environment for training and evaluating agents on realistic B2B SaaS support workflows.
+---
+title: Customer Support OpenEnv
+emoji: "🎫"
+colorFrom: blue
+colorTo: green
+sdk: docker
+app_port: 8000
+short_description: Deterministic B2B SaaS support benchmark.
+pinned: false
+---
+
+# AcmeCloud Customer Support Ticket Handler
+
+A deterministic OpenEnv-style environment for training and evaluating agents on realistic B2B SaaS support workflows.
 
 ## What It Simulates
 
@@ -128,37 +128,56 @@ uvicorn server.app:app --host 0.0.0.0 --port 8000 --reload
 
 Open the docs at [http://localhost:8000/docs](http://localhost:8000/docs) or the simple UI at [http://localhost:8000/web](http://localhost:8000/web).
 
-## Docker
-
-```bash
-docker build -t customer-support-openenv -f server/Dockerfile .
-docker run -p 8000:8000 customer-support-openenv
-```
-
-## Baseline Inference
-
-The baseline script uses the OpenAI client interface and supports any OpenAI-compatible endpoint.
-
-Environment variables:
-
-- `HF_TOKEN` or `OPENAI_API_KEY`
-- `API_BASE_URL`
-- `MODEL_NAME`
-- optional `ENV_BASE_URL` if you want the script to hit a running server instead of the in-process environment
-
-Run:
-
-```bash
-python inference.py
+## Docker
+
+```bash
+docker build -t customer-support-openenv .
+docker run -p 8000:8000 customer-support-openenv
+```
+
+## Baseline Inference
+
+The baseline script uses the OpenAI client interface and supports any OpenAI-compatible endpoint.
+
+Mandatory environment variables for hosted model inference:
+
+- `HF_TOKEN`
+- `API_BASE_URL`
+- `MODEL_NAME`
+
+Optional environment variables:
+
+- `ENV_BASE_URL` to target a running local server or deployed HF Space
+- `LOCAL_IMAGE_NAME` if you want the script to instantiate the environment via `from_docker_image(...)`
+
+Inference environment selection:
+
+1. `LOCAL_IMAGE_NAME` set: use `from_docker_image(...)`
+2. otherwise `ENV_BASE_URL` set: use the running HTTP environment
+3. otherwise: use the in-process local environment for offline reproducibility
+
+Run:
+
+```bash
+python inference.py
 ```
 
 The script emits strict stdout lines in the required format:
 
-- `[START]`
-- `[STEP]`
-- `[END]`
-
-If the model call fails or credentials are missing, the script falls back to a deterministic scripted policy so the benchmark still runs reproducibly.
+- `[START]`
+- `[STEP]`
+- `[END]`
+
+Output contract:
+
+- one `[START]` line per task
+- one `[STEP]` line immediately after each `env.step()`
+- one `[END]` line per task, even on exception
+- `reward`, `rewards`, and `score` formatted to 2 decimal places
+- `done` and `success` emitted as lowercase booleans
+- `error` emitted as the raw `last_action_error` string or `null`
+
+If the model call fails or credentials are missing, the script falls back to a deterministic scripted policy so the benchmark still runs reproducibly.
 
 ## Example Gold Scores
 
@@ -168,20 +187,65 @@ Using the included scripted policy:
 - `duplicate_charge_refund`: `1.0`
 - `enterprise_data_loss_escalation`: `1.0`
 
-## Deployment Notes
-
-- The app exposes `/health`, `/reset`, `/step`, `/state`, `/docs`, `/web`, and `/ws`
-- Sessions are managed in-memory
-- No external services are required to run the environment server itself
-- The benchmark is designed to fit comfortably in the hackathon resource limits
-
-## Validation
-
-If `openenv` is installed locally, run:
-
-```bash
-openenv validate
-```
-
-This repository does not depend on an LLM judge for grading.
-All graders are deterministic and implemented directly in the environment scorer.
+## Deployment Notes
+
+- HF Space page: `https://huggingface.co/spaces/Dar3devil/customer-support-openenv`
+- HF app URL: `https://dar3devil-customer-support-openenv.hf.space`
+- The app exposes `/health`, `/reset`, `/step`, `/state`, `/docs`, `/web`, and `/ws`
+- Sessions are managed in-memory
+- No external services are required to run the environment server itself
+- The benchmark is designed to fit comfortably in the hackathon resource limits
+
+## Validation
+
+If `openenv` is installed locally, run:
+
+```bash
+openenv validate
+```
+
+## Pre-Submission Commands
+
+Local checks:
+
+```powershell
+cd "C:\Users\aarya\.codex\worktrees\e74f\Task Scheduler\customer_support_openenv"
+openenv validate
+pytest -q
+```
+
+Baseline run:
+
+```powershell
+$env:HF_TOKEN="<your-hf-token>"
+$env:API_BASE_URL="https://router.huggingface.co/v1"
+$env:MODEL_NAME="Qwen/Qwen2.5-72B-Instruct"
+python inference.py
+```
+
+Local Docker smoke test:
+
+```powershell
+docker build -t customer-support-openenv .
+docker run --rm -p 8000:8000 customer-support-openenv
+curl.exe -sS http://localhost:8000/health
+curl.exe -sS -X POST http://localhost:8000/reset -H "Content-Type: application/json" -d "{}"
+```
+
+Live Space smoke test:
+
+```powershell
+curl.exe -sS https://dar3devil-customer-support-openenv.hf.space/health
+curl.exe -sS -X POST https://dar3devil-customer-support-openenv.hf.space/reset -H "Content-Type: application/json" -d "{}"
+```
+
+Submission validator:
+
+```powershell
+wsl bash -lc "cd '/mnt/c/Users/aarya/.codex/worktrees/e74f/Task Scheduler/customer_support_openenv' && chmod +x scripts/validate-submission.sh && scripts/validate-submission.sh https://dar3devil-customer-support-openenv.hf.space ."
+```
+
+Windows users should run the validator script through WSL or Git Bash.
+
+This repository does not depend on an LLM judge for grading.
+All graders are deterministic and implemented directly in the environment scorer.