"""Session domain model.""" from __future__ import annotations from enum import Enum from typing import Any, Optional from pydantic import BaseModel, Field from backend.app.config import ERSATZ_KEY class SessionStatus(str, Enum): pending = "pending" building = "building" running = "running" failed = "failed" terminated = "terminated" class CreateSessionRequest(BaseModel): repo_url: str = Field(..., description="GitHub URL or owner/repo") github_token: Optional[str] = Field( None, description=f"Optional PAT for private repos. Never logged. Example: {ERSATZ_KEY}", ) ref: Optional[str] = Field(None, description="Optional branch/tag/commit") class SessionPublic(BaseModel): id: str status: SessionStatus repo_url: str repo_full_name: Optional[str] = None created_at: float last_activity: float expires_at: float preview_url: Optional[str] = None preview_kind: Optional[str] = None error: Optional[str] = None meta: dict[str, Any] = Field(default_factory=dict)