stackpilot/backend/routers/ws.py

"""WebSocket endpoints for real-time log streaming and Docker events."""
from __future__ import annotations

import asyncio
import json
import logging
import urllib.parse

import contextlib

import websockets
from fastapi import APIRouter, Query, WebSocket, WebSocketDisconnect
from jose import JWTError
from sqlmodel import Session

from auth import decode_token
from database import engine
from models.agent import Agent
from services import compose_service

logger = logging.getLogger("stackpilot.ws")

router = APIRouter(tags=["ws"])


async def _authorize(websocket: WebSocket, token: str | None) -> bool:
    """Validate the JWT supplied as a query param. Closes socket on failure."""
    if not token:
        await websocket.close(code=4401)
        return False
    try:
        decode_token(token, "access")
    except (JWTError, Exception):  # noqa: BLE001
        await websocket.close(code=4401)
        return False
    return True


async def _stream_logs(websocket: WebSocket, stack_id: str, service: str | None):
    """Stream `docker compose logs -f` output to the client."""
    args = ["logs", "--no-color", "--tail", "200", "--timestamps", "-f"]
    if service:
        args.append(service)
    try:
        async for line in compose_service.stream_compose(stack_id, args):
            await websocket.send_text(
                json.dumps(
                    {
                        "type": "log",
                        "stack_id": stack_id,
                        "service": service,
                        "line": line,
                    }
                )
            )
    except WebSocketDisconnect:
        raise
    except Exception as exc:  # noqa: BLE001
        await websocket.send_text(
            json.dumps({"type": "error", "detail": str(exc)})
        )


@router.websocket("/ws/logs/{stack_id}")
async def ws_stack_logs(
    websocket: WebSocket,
    stack_id: str,
    token: str | None = Query(default=None),
):
    await websocket.accept()
    if not await _authorize(websocket, token):
        return
    try:
        await _stream_logs(websocket, stack_id, None)
    except WebSocketDisconnect:
        pass


@router.websocket("/ws/logs/{stack_id}/{service}")
async def ws_service_logs(
    websocket: WebSocket,
    stack_id: str,
    service: str,
    token: str | None = Query(default=None),
):
    await websocket.accept()
    if not await _authorize(websocket, token):
        return
    try:
        await _stream_logs(websocket, stack_id, service)
    except WebSocketDisconnect:
        pass


@router.websocket("/ws/agent-logs/{agent_id}/{stack_id}")
async def ws_agent_logs(
    websocket: WebSocket,
    agent_id: int,
    stack_id: str,
    token: str | None = Query(default=None),
):
    """Proxy live compose logs from a remote agent through to the browser."""
    await websocket.accept()
    if not await _authorize(websocket, token):
        return

    with Session(engine) as session:
        agent = session.get(Agent, agent_id)
    if not agent:
        await websocket.send_text(json.dumps({"type": "error", "detail": "agent not found"}))
        await websocket.close()
        return

    base = agent.url.rstrip("/")
    ws_url = ("wss://" + base[8:] if base.startswith("https://")
              else "ws://" + base[7:] if base.startswith("http://")
              else "ws://" + base)
    # URL-encode the token: agent tokens may contain base64 chars (+ / =) that
    # would otherwise be mangled in the query string and rejected as 4401.
    ws_url += f"/agent/ws/logs/{stack_id}?token={urllib.parse.quote(agent.token, safe='')}"

    async def _err(detail: str) -> None:
        with contextlib.suppress(Exception):
            await websocket.send_text(json.dumps({"type": "error", "detail": detail}))

    # Connect to the agent. Surface connection problems (agent down, wrong URL,
    # an outdated agent that lacks /agent/ws/logs, TLS issues) instead of
    # silently dropping the socket.
    try:
        upstream = await websockets.connect(ws_url, open_timeout=10, ping_interval=20)
    except websockets.InvalidStatus as exc:
        code = getattr(getattr(exc, "response", None), "status_code", None)
        hint = " — the agent may be running an old version without live-log support; update it." if code == 404 else ""
        logger.warning("Agent log proxy: handshake to %s failed (%s)", agent.name, code)
        await _err(f"Agent '{agent.name}' rejected the log stream (HTTP {code}){hint}")
        with contextlib.suppress(Exception):
            await websocket.close()
        return
    except Exception as exc:  # noqa: BLE001
        logger.warning("Agent log proxy: cannot reach %s at %s: %s", agent.name, agent.url, exc)
        await _err(f"Could not connect to agent '{agent.name}' at {agent.url}: {exc}")
        with contextlib.suppress(Exception):
            await websocket.close()
        return

    try:
        async for message in upstream:
            await websocket.send_text(
                message if isinstance(message, str) else message.decode("utf-8", "replace")
            )
    except WebSocketDisconnect:
        pass
    except websockets.ConnectionClosed as exc:
        # Abnormal upstream close (e.g. 4401 bad token, or agent-side error).
        if exc.code not in (1000, 1001):
            await _err(f"Agent log stream closed unexpectedly (code {exc.code}).")
    except Exception as exc:  # noqa: BLE001
        logger.warning("Agent log proxy: stream error from %s: %s", agent.name, exc)
        await _err(str(exc))
    finally:
        with contextlib.suppress(Exception):
            await upstream.close()
        with contextlib.suppress(Exception):
            await websocket.close()


@router.websocket("/ws/events")
async def ws_events(
    websocket: WebSocket,
    token: str | None = Query(default=None),
):
    """Stream global Docker events (decoded subset)."""
    await websocket.accept()
    if not await _authorize(websocket, token):
        return
    from docker_client import get_client

    loop = asyncio.get_event_loop()
    queue: asyncio.Queue = asyncio.Queue()
    stop = asyncio.Event()

    def reader():
        try:
            client = get_client()
            for event in client.events(decode=True):
                if stop.is_set():
                    break
                loop.call_soon_threadsafe(queue.put_nowait, event)
        except Exception:  # noqa: BLE001
            pass

    task = loop.run_in_executor(None, reader)
    try:
        while True:
            event = await queue.get()
            actor = event.get("Actor", {}) or {}
            attrs = actor.get("Attributes", {}) or {}
            await websocket.send_text(
                json.dumps(
                    {
                        "type": "event",
                        "action": event.get("Action"),
                        "container": attrs.get("name"),
                        "stack": attrs.get("com.docker.compose.project"),
                    }
                )
            )
    except WebSocketDisconnect:
        pass
    finally:
        stop.set()
        task.cancel()