app.py

"""Bot Manager entry point.

The real engine lives in `manager_core.py`; the FastAPI adapter lives in
`web/server.py`. This module just starts the ASGI server.

Environment variables:
  BOTMGR_HOST         bind address (default 0.0.0.0)
  BOTMGR_PORT         bind port    (default 28473)
  BOTMGR_TOKEN        optional shared-secret for the dashboard + API
  BOTMGR_ACCESS_LOG   set to 1/true to re-enable uvicorn per-request logging
                      (off by default so the dashboard's 5s poll doesn't
                      constantly scroll the terminal)
"""

from __future__ import annotations

import os

import uvicorn


def _env_flag(name: str, default: bool = False) -> bool:
    val = os.environ.get(name)
    if val is None:
        return default
    return val.strip().lower() in {"1", "true", "yes", "on"}


def main() -> None:
    host = os.environ.get("BOTMGR_HOST", "0.0.0.0")
    # 28473 is IANA-unassigned and outside Linux's default ephemeral range
    # (net.ipv4.ip_local_port_range 32768-60999), so the kernel won't ever
    # auto-grab it for an outbound socket. Override with BOTMGR_PORT.
    port = int(os.environ.get("BOTMGR_PORT", "28473"))
    uvicorn.run(
        "web.server:app",
        host=host,
        port=port,
        log_level="info",
        access_log=_env_flag("BOTMGR_ACCESS_LOG", default=False),
    )


if __name__ == "__main__":
    main()