# Copyright (c) 2026 Krzysztof Rudnicki. MIT licence. """The switchboard: what the management page reads and writes per command. Loopback only, like everything on this port; the management app proxies it. The list is the *live* table -- the one the dispatcher is resolving against this instant -- joined with the store's switches, so a command the album added on the last reload shows up, and one it dropped is gone. A PUT writes the store and nothing else: the dispatcher reads it on the next attempt. """ from __future__ import annotations from typing import TYPE_CHECKING, Any from fastapi import APIRouter, HTTPException, Request, status from pydantic import BaseModel from signal_bot.command_settings import CommandSetting from signal_bot.wiring import UNGATED if TYPE_CHECKING: from signal_bot.bot import Bot from signal_bot.registry import Command from signal_bot.startup_retry import Starter router = APIRouter() class SettingRequest(BaseModel): """The three things the page may decide about one command.""" enabled: bool = True disabled_until: float | None = None cooldown_seconds: float | None = None def _bot(request: Request) -> Bot: """The connected bot, or the same 503 every other route gives while connecting.""" starter: Starter = request.app.state.starter runtime = starter.runtime if runtime is None: raise HTTPException( status_code=status.HTTP_503_SERVICE_UNAVAILABLE, detail={"status": "connecting", "reason": starter.reason}, ) return runtime.bot def _row(bot: Bot, command: Command) -> dict[str, Any]: """One command as the page sees it: identity, switches, and the default.""" setting = bot.store.command_settings.get(command.name) return { "name": command.name, "trigger": command.primary, "description": command.description, "enabled": setting.enabled, "disabled_until": setting.disabled_until, "cooldown_seconds": setting.cooldown_seconds, # What the cooldown falls back to when the override is cleared, or # null for the commands wiring registers without one -- a number # there would be an input that does nothing. "default_cooldown_seconds": ( None if command.name in UNGATED else bot.config.cooldown_seconds ), } @router.get("/_commands") async def list_commands(request: Request) -> dict[str, list[dict[str, Any]]]: """Every live command with its switches, by name.""" bot = _bot(request) commands = sorted(bot.dispatcher.registry.commands, key=lambda c: c.name) return {"commands": [_row(bot, command) for command in commands]} @router.put("/_commands/{name}") async def put_command(name: str, body: SettingRequest, request: Request) -> dict[str, Any]: """Store one command's switches and answer with the row as it now stands.""" bot = _bot(request) command = next((c for c in bot.dispatcher.registry.commands if c.name == name), None) if command is None: raise HTTPException(status.HTTP_404_NOT_FOUND, f"no command named {name!r}") bot.store.command_settings.put( CommandSetting( command=name, enabled=body.enabled, disabled_until=body.disabled_until, cooldown_seconds=body.cooldown_seconds, ) ) return _row(bot, command)