"""Admin-configurable system-wide runtime settings.""" from __future__ import annotations import logging from fastapi import APIRouter, HTTPException, Request from pydantic import BaseModel, Field from app.gateway.deps import get_optional_user_from_request from deerflow.config.system_settings import ( PromptPrefixSettings, SystemSettings, load_system_settings, save_system_settings, ) logger = logging.getLogger(__name__) router = APIRouter(prefix="/api/system-settings", tags=["system-settings"]) class PromptPrefixResponse(BaseModel): enabled: bool = Field(..., description="Whether the toggle is exposed to users") switch_label: str = Field(..., description="Toggle label shown in the chat input") prompt_prefix: str = Field(..., description="Prefix text prepended to the first user message") class PromptPrefixUpdateRequest(BaseModel): enabled: bool | None = None switch_label: str | None = None prompt_prefix: str | None = None def _to_response(settings: PromptPrefixSettings) -> PromptPrefixResponse: return PromptPrefixResponse( enabled=settings.enabled, switch_label=settings.switch_label, prompt_prefix=settings.prompt_prefix, ) async def _require_admin(request: Request) -> None: user = await get_optional_user_from_request(request) if user is None: return if getattr(user, "system_role", None) != "admin": raise HTTPException(status_code=403, detail="System settings can only be modified by an admin") @router.get("/prompt-prefix", response_model=PromptPrefixResponse) async def get_prompt_prefix() -> PromptPrefixResponse: """Return the current prompt-prefix configuration (readable by any user).""" return _to_response(load_system_settings().prompt_prefix) @router.put("/prompt-prefix", response_model=PromptPrefixResponse) async def update_prompt_prefix(body: PromptPrefixUpdateRequest, request: Request) -> PromptPrefixResponse: """Update the prompt-prefix configuration. Admin only.""" await _require_admin(request) current = load_system_settings() fields = body.model_dump(exclude_unset=True) updated_prefix = current.prompt_prefix.model_copy(update=fields) saved = save_system_settings(SystemSettings(prompt_prefix=updated_prefix)) return _to_response(saved.prompt_prefix)