feat: add API and deployment entrypoints

Dockerfile

@@ -0,0 +1,15 @@
+FROM python:3.12-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV PYTHONUNBUFFERED=1
+
+WORKDIR /app
+
+COPY . /app
+
+RUN pip install --no-cache-dir --upgrade pip && \
+    pip install --no-cache-dir .
+
+EXPOSE 8000
+
+CMD ["uvicorn", "server.app:app", "--host", "0.0.0.0", "--port", "8000"]

server/Dockerfile

@@ -0,0 +1,80 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+
+# Multi-stage build using openenv-base
+# This Dockerfile is flexible and works for both:
+# - In-repo environments (with local OpenEnv sources)
+# - Standalone environments (with openenv from PyPI/Git)
+# The build script (openenv build) handles context detection and sets appropriate build args.
+
+ARG BASE_IMAGE=ghcr.io/meta-pytorch/openenv-base:latest
+FROM ${BASE_IMAGE} AS builder
+
+WORKDIR /app
+
+# Ensure git is available (required for installing dependencies from VCS)
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends git && \
+    rm -rf /var/lib/apt/lists/*
+
+# Build argument to control whether we're building standalone or in-repo
+ARG BUILD_MODE=in-repo
+ARG ENV_NAME=chargeback_ops
+
+# Copy environment code (always at root of build context)
+COPY . /app/env
+
+# For in-repo builds, openenv is already vendored in the build context
+# For standalone builds, openenv will be installed via pyproject.toml
+WORKDIR /app/env
+
+# Ensure uv is available (for local builds where base image lacks it)
+RUN if ! command -v uv >/dev/null 2>&1; then \
+        curl -LsSf https://astral.sh/uv/install.sh | sh && \
+        mv /root/.local/bin/uv /usr/local/bin/uv && \
+        mv /root/.local/bin/uvx /usr/local/bin/uvx; \
+    fi
+    
+# Install dependencies using uv sync
+# If uv.lock exists, use it; otherwise resolve on the fly
+RUN --mount=type=cache,target=/root/.cache/uv \
+    if [ -f uv.lock ]; then \
+        uv sync --frozen --no-install-project --no-editable; \
+    else \
+        uv sync --no-install-project --no-editable; \
+    fi
+
+RUN --mount=type=cache,target=/root/.cache/uv \
+    if [ -f uv.lock ]; then \
+        uv sync --frozen --no-editable; \
+    else \
+        uv sync --no-editable; \
+    fi
+
+# Final runtime stage
+FROM ${BASE_IMAGE}
+
+WORKDIR /app
+
+# Copy the virtual environment from builder
+COPY --from=builder /app/env/.venv /app/.venv
+
+# Copy the environment code
+COPY --from=builder /app/env /app/env
+
+# Set PATH to use the virtual environment
+ENV PATH="/app/.venv/bin:$PATH"
+
+# Set PYTHONPATH so imports work correctly
+ENV PYTHONPATH="/app/env:$PYTHONPATH"
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:8000/health || exit 1
+
+# Run the FastAPI server
+# The module path is constructed to work with the /app/env structure
+CMD ["sh", "-c", "cd /app/env && uvicorn server.app:app --host 0.0.0.0 --port 8000"]

server/app.py

@@ -0,0 +1,124 @@
+"""FastAPI application for ChargebackOps."""
+
+from __future__ import annotations
+
+from fastapi import HTTPException
+from fastapi.responses import JSONResponse
+
+try:
+    from openenv.core.env_server.http_server import create_app
+except Exception as exc:  # pragma: no cover
+    raise ImportError(
+        "openenv-core is required to run ChargebackOps. Install project dependencies first."
+    ) from exc
+
+try:
+    from ..baseline_runner import run_baseline
+    from ..episode_store import get_report
+    from ..inference import run_inference
+    from ..models import (
+        BaselineRunResult,
+        ChargebackOpsAction,
+        ChargebackOpsObservation,
+        TasksResponse,
+        TaskSummary,
+    )
+    from ..simulation import list_tasks
+    from .chargeback_ops_environment import ChargebackOpsEnvironment
+except ImportError:  # pragma: no cover
+    from baseline_runner import run_baseline
+    from episode_store import get_report
+    from inference import run_inference
+    from models import (
+        BaselineRunResult,
+        ChargebackOpsAction,
+        ChargebackOpsObservation,
+        TasksResponse,
+        TaskSummary,
+    )
+    from simulation import list_tasks
+    from server.chargeback_ops_environment import ChargebackOpsEnvironment
+
+
+app = create_app(
+    ChargebackOpsEnvironment,
+    ChargebackOpsAction,
+    ChargebackOpsObservation,
+    env_name="chargeback_ops",
+    max_concurrent_envs=8,
+)
+
+
+@app.get("/")
+def root() -> JSONResponse:
+    """Return a lightweight root response for HF Space and validator pings."""
+
+    return JSONResponse(
+        {
+            "name": "ChargebackOps",
+            "status": "ok",
+            "docs_url": "/docs",
+            "health_url": "/health",
+            "tasks_url": "/tasks",
+        }
+    )
+
+
+@app.get("/tasks", response_model=TasksResponse)
+def tasks() -> TasksResponse:
+    """List built-in tasks and the action schema."""
+
+    return TasksResponse(
+        tasks=[
+            TaskSummary(
+                task_id=task.task_id,
+                title=task.title,
+                difficulty=task.difficulty,
+                objective=task.objective,
+                description=task.description,
+                max_steps=task.max_steps,
+                case_count=len(task.cases),
+            )
+            for task in list_tasks()
+        ],
+        action_schema=ChargebackOpsAction.model_json_schema(),
+    )
+
+
+@app.get("/grader")
+@app.post("/grader")
+def grader(episode_id: str | None = None):
+    """Return a stored grade for a completed episode."""
+
+    report = get_report(episode_id)
+    if report is None:
+        raise HTTPException(
+            status_code=404,
+            detail="No completed episode report found. Finish an episode first or provide a valid episode_id.",
+        )
+    return report.model_dump()
+
+
+@app.get("/baseline", response_model=BaselineRunResult)
+@app.post("/baseline", response_model=BaselineRunResult)
+def baseline(
+    provider: str | None = None,
+    model_name: str | None = None,
+) -> BaselineRunResult:
+    """Run the baseline inference policy across all tasks."""
+
+    if provider is None and model_name is None:
+        return run_inference()
+    return run_baseline(provider=provider, model_name=model_name)
+
+
+def main(host: str = "0.0.0.0", port: int = 8000) -> None:
+    """Local entry point for uvicorn."""
+
+    import uvicorn
+
+    uvicorn.run(app, host=host, port=port)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    main()