Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

8.0 KB
Raw Blame
# Copyright (c) 2026 Beijing Volcano Engine Technology Co., Ltd.
# SPDX-License-Identifier: AGPL-3.0

from __future__ import annotations

import httpx
import pytest
from fastapi import FastAPI
from fastapi.responses import JSONResponse

from openviking.server.auth import get_request_context
from openviking.server.identity import RequestContext, Role
from openviking.server.models import ERROR_CODE_TO_HTTP_STATUS, ErrorInfo, Response
from openviking.server.routers.console import router as console_router
from openviking_cli.exceptions import InvalidArgumentError, OpenVikingError
from openviking_cli.session.user_id import UserIdentifier


def _ctx(role: Role = Role.ADMIN) -> RequestContext:
    return RequestContext(
        user=UserIdentifier(account_id="acct-1", user_id="user-1"),
        role=role,
    )


def _admin_ctx() -> RequestContext:
    return _ctx(Role.ADMIN)


def _user_ctx() -> RequestContext:
    return _ctx(Role.USER)


def _app_with_runtime(runtime=None, *, request_context=_admin_ctx) -> FastAPI:
    app = FastAPI()
    app.include_router(console_router)
    app.state.usage_audit_runtime = runtime
    app.dependency_overrides[get_request_context] = request_context

    @app.exception_handler(OpenVikingError)
    async def openviking_error_handler(_, exc: OpenVikingError):
        return JSONResponse(
            status_code=ERROR_CODE_TO_HTTP_STATUS.get(exc.code, 500),
            content=Response(
                status="error",
                error=ErrorInfo(code=exc.code, message=exc.message, details=exc.details),
            ).model_dump(),
        )

    return app


class FakeConsoleService:
    def __init__(self) -> None:
        self.audit_call = None
        self.token_series_call = None
        self.dashboard_call = None
        self.context_commits_call = None

    async def token_series(self, **kwargs):
        self.token_series_call = kwargs
        if kwargs.get("end_date", "") < kwargs.get("start_date", ""):
            raise InvalidArgumentError("bad date range")
        return {
            "start_date": kwargs["start_date"],
            "end_date": kwargs["end_date"],
            "bucket": kwargs["bucket"],
            "items": [],
        }

    async def context_commits(self, **kwargs):
        self.context_commits_call = kwargs
        return {
            "start_date": kwargs["start_date"],
            "end_date": kwargs["end_date"],
            "bucket": kwargs["bucket"],
            "items": [],
        }

    async def dashboard_summary(self, ctx, **kwargs):
        self.dashboard_call = {"ctx": ctx, **kwargs}
        return {
            "context_counts": {},
            "today_tokens": {},
            "today_retrievals": {},
        }

    async def audit_logs(self, **kwargs):
        self.audit_call = kwargs
        return {"total": 0, "success_rate": 0.0, "page": 2, "page_size": 20, "items": []}


class FakeRuntime:
    def __init__(self, api_service) -> None:
        self.api_service = api_service


@pytest.mark.asyncio
async def test_console_router_returns_disabled_when_usage_audit_not_initialized():
    transport = httpx.ASGITransport(app=_app_with_runtime(None))
    async with httpx.AsyncClient(transport=transport, base_url="http://testserver") as client:
        response = await client.get("/api/v1/console/dashboard/summary")

    assert response.status_code == 200
    assert response.json()["result"]["enabled"] is False


@pytest.mark.asyncio
async def test_console_router_splits_audit_filters():
    service = FakeConsoleService()
    transport = httpx.ASGITransport(app=_app_with_runtime(FakeRuntime(service)))
    async with httpx.AsyncClient(transport=transport, base_url="http://testserver") as client:
        response = await client.get(
            "/api/v1/console/audit",
            params={
                "page": "2",
                "page_size": "20",
                "status": ["success,error", "5xx"],
                "api_type": "search.find,sessions",
            },
        )

    assert response.status_code == 200
    assert response.json()["status"] == "ok"
    assert service.audit_call["ctx"].account_id == "acct-1"
    assert service.audit_call["statuses"] == ["success", "error", "5xx"]
    assert service.audit_call["api_types"] == ["search.find", "sessions"]
    assert service.audit_call["page"] == 2
    assert service.audit_call["page_size"] == 20


@pytest.mark.asyncio
async def test_console_router_allows_regular_user_dashboard_metrics():
    service = FakeConsoleService()
    transport = httpx.ASGITransport(
        app=_app_with_runtime(FakeRuntime(service), request_context=_user_ctx)
    )
    async with httpx.AsyncClient(transport=transport, base_url="http://testserver") as client:
        summary = await client.get("/api/v1/console/dashboard/summary")
        tokens = await client.get(
            "/api/v1/console/tokens",
            params={"start_date": "2026-05-01", "end_date": "2026-05-12"},
        )
        commits = await client.get(
            "/api/v1/console/context-commits",
            params={"start_date": "2026-05-01", "end_date": "2026-05-12"},
        )

    assert summary.status_code == 200
    assert tokens.status_code == 200
    assert commits.status_code == 200
    assert service.dashboard_call["ctx"].role == Role.USER
    assert service.token_series_call["ctx"].role == Role.USER
    assert service.context_commits_call["ctx"].role == Role.USER


@pytest.mark.asyncio
async def test_console_router_allows_regular_user_scoped_audit_logs():
    service = FakeConsoleService()
    transport = httpx.ASGITransport(
        app=_app_with_runtime(FakeRuntime(service), request_context=_user_ctx)
    )
    async with httpx.AsyncClient(transport=transport, base_url="http://testserver") as client:
        response = await client.get("/api/v1/console/audit")

    assert response.status_code == 200
    assert response.json()["status"] == "ok"
    assert service.audit_call["ctx"].role == Role.USER


@pytest.mark.asyncio
async def test_console_router_invalid_arguments_return_http_400():
    service = FakeConsoleService()
    transport = httpx.ASGITransport(app=_app_with_runtime(FakeRuntime(service)))
    async with httpx.AsyncClient(transport=transport, base_url="http://testserver") as client:
        response = await client.get(
            "/api/v1/console/tokens",
            params={"start_date": "2026-05-12", "end_date": "2026-05-01"},
        )

    assert response.status_code == 400
    assert response.json()["error"]["code"] == "INVALID_ARGUMENT"


@pytest.mark.asyncio
async def test_console_router_passes_timezone_to_dashboard_and_series():
    service = FakeConsoleService()
    transport = httpx.ASGITransport(app=_app_with_runtime(FakeRuntime(service)))
    async with httpx.AsyncClient(transport=transport, base_url="http://testserver") as client:
        await client.get(
            "/api/v1/console/dashboard/summary",
            params={"timezone": "Asia/Shanghai"},
        )
        await client.get(
            "/api/v1/console/tokens",
            params={
                "start_date": "2026-05-01",
                "end_date": "2026-05-12",
                "timezone": "America/New_York",
            },
        )
        await client.get(
            "/api/v1/console/context-commits",
            params={
                "start_date": "2026-05-01",
                "end_date": "2026-05-12",
                "bucket": "4h",
                "timezone": "Europe/Berlin",
            },
        )

    assert service.dashboard_call["timezone_name"] == "Asia/Shanghai"
    assert service.token_series_call["timezone_name"] == "America/New_York"
    assert service.context_commits_call["timezone_name"] == "Europe/Berlin"


@pytest.mark.asyncio
async def test_console_router_defaults_timezone_to_none_when_missing():
    service = FakeConsoleService()
    transport = httpx.ASGITransport(app=_app_with_runtime(FakeRuntime(service)))
    async with httpx.AsyncClient(transport=transport, base_url="http://testserver") as client:
        await client.get("/api/v1/console/dashboard/summary")

    assert service.dashboard_call["timezone_name"] is None