ref #8: [feat] add http endpoint

adapter/http/fastapi/dependencies.py

@@ -1,8 +1,7 @@
-from typing import cast
-
 from fastapi import Depends, Request
 
 from adapter.di.container import AppContainer
+from usecase.sandbox import CreateSandbox
 from usecase.user import GetUser
 
 APP_CONTAINER_STATE = 'container'
@@ -11,10 +10,16 @@ APP_CONFIG_STATE = 'config'
 
 def get_container(request: Request) -> AppContainer:
     container = getattr(request.app.state, APP_CONTAINER_STATE, None)
-    if container is None:
+    if not isinstance(container, AppContainer):
         raise RuntimeError('container unavailable')
-    return cast(AppContainer, container)
+    return container
 
 
 def get_get_user(container: AppContainer = Depends(get_container)) -> GetUser:
     return container.usecases.get_user
+
+
+def get_create_sandbox(
+    container: AppContainer = Depends(get_container),
+) -> CreateSandbox:
+    return container.usecases.create_sandbox

adapter/http/fastapi/routers/v1/router.py

@@ -1,9 +1,21 @@
 from fastapi import APIRouter, Depends, HTTPException, status
 
 from adapter.di.container import AppContainer
-from adapter.http.fastapi.dependencies import get_container, get_get_user
-from adapter.http.fastapi.schemas import ErrorResponse, HealthResponse, UserResponse
-from domain.error import UserNotFoundError
+from adapter.http.fastapi.dependencies import (
+    get_container,
+    get_create_sandbox,
+    get_get_user,
+)
+from adapter.http.fastapi.schemas import (
+    CreateSandboxRequest,
+    ErrorResponse,
+    HealthResponse,
+    SandboxSessionResponse,
+    UserResponse,
+)
+from domain.error import SandboxError, SandboxStartError, UserNotFoundError
+from domain.sandbox import SandboxSession
+from usecase.sandbox import CreateSandbox, CreateSandboxCommand
 from usecase.user import GetUser, GetUserQuery
 
 router = APIRouter()
@@ -38,3 +50,42 @@ def get_user(user_id: str, usecase: GetUser = Depends(get_get_user)) -> UserResp
         ) from exc
 
     return UserResponse(id=user.id, email=user.email, name=user.name)
+
+
+@router.post(
+    '/create',
+    response_model=SandboxSessionResponse,
+    responses={
+        status.HTTP_503_SERVICE_UNAVAILABLE: {'model': ErrorResponse},
+        status.HTTP_500_INTERNAL_SERVER_ERROR: {'model': ErrorResponse},
+    },
+    status_code=status.HTTP_200_OK,
+)
+def create_sandbox(
+    request: CreateSandboxRequest,
+    usecase: CreateSandbox = Depends(get_create_sandbox),
+) -> SandboxSessionResponse:
+    try:
+        session = usecase.execute(CreateSandboxCommand(chat_id=request.chat_id))
+    except SandboxStartError as exc:
+        raise HTTPException(
+            status_code=status.HTTP_503_SERVICE_UNAVAILABLE,
+            detail=str(exc),
+        ) from exc
+    except SandboxError as exc:
+        raise HTTPException(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
+            detail=str(exc),
+        ) from exc
+
+    return _to_sandbox_session_response(session)
+
+
+def _to_sandbox_session_response(session: SandboxSession) -> SandboxSessionResponse:
+    return SandboxSessionResponse(
+        session_id=session.session_id,
+        chat_id=session.chat_id,
+        container_id=session.container_id,
+        status=session.status.value,
+        expires_at=session.expires_at,
+    )

adapter/http/fastapi/schemas.py

@@ -1,4 +1,6 @@
-from pydantic import BaseModel
+from datetime import datetime
+
+from pydantic import BaseModel, ConfigDict, Field
 
 
 class HealthResponse(BaseModel):
@@ -7,6 +9,20 @@ class HealthResponse(BaseModel):
     env: str
 
 
+class CreateSandboxRequest(BaseModel):
+    model_config = ConfigDict(extra='forbid', str_strip_whitespace=True)
+
+    chat_id: str = Field(min_length=1)
+
+
+class SandboxSessionResponse(BaseModel):
+    session_id: str
+    chat_id: str
+    container_id: str
+    status: str
+    expires_at: datetime
+
+
 class UserResponse(BaseModel):
     id: str
     email: str