Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
# Copyright (c) 2026 Beijing Volcano Engine Technology Co., Ltd.
# SPDX-License-Identifier: AGPL-3.0
"""Tests for the stats API router."""
from unittest.mock import AsyncMock, MagicMock, patch
import pytest
from fastapi import FastAPI
from fastapi.testclient import TestClient
from openviking.server.auth import get_request_context
from openviking.server.routers.stats import router
@pytest.fixture
def mock_service():
"""Create a mock OpenVikingService."""
service = MagicMock()
service.vikingdb_manager = AsyncMock()
service.vikingdb_manager.query = AsyncMock(return_value=[])
# Mock session access
mock_session = MagicMock()
mock_session.load = AsyncMock()
mock_stats = MagicMock()
mock_stats.total_turns = 5
mock_stats.memories_extracted = 3
mock_session.stats = mock_stats
service.sessions.get = AsyncMock(return_value=mock_session)
return service
@pytest.fixture
def mock_ctx():
"""Create a mock request context."""
return MagicMock()
@pytest.fixture
def client(mock_service, mock_ctx):
"""Create a test client with mocked dependencies."""
app = FastAPI()
app.dependency_overrides[get_request_context] = lambda: mock_ctx
app.include_router(router)
with patch("openviking.server.routers.stats.get_service", return_value=mock_service):
yield TestClient(app)
class TestGetMemoryStats:
def test_empty_store(self, client):
"""Empty store returns zero counts."""
response = client.get("/api/v1/stats/memories")
assert response.status_code == 200
data = response.json()
assert data["status"] == "ok"
assert data["result"]["total_memories"] == 0
def test_invalid_category(self, client):
"""Unknown category returns an error."""
response = client.get("/api/v1/stats/memories?category=bogus")
assert response.status_code == 200
data = response.json()
assert data["status"] == "error"
assert "INVALID_ARGUMENT" in data["error"]["code"]
def test_valid_category_filter(self, client):
"""Valid category returns filtered stats."""
response = client.get("/api/v1/stats/memories?category=cases")
assert response.status_code == 200
data = response.json()
assert data["status"] == "ok"
assert "cases" in data["result"]["by_category"]
def test_response_shape(self, client):
"""Response includes all expected top-level keys."""
response = client.get("/api/v1/stats/memories")
data = response.json()["result"]
assert "total_memories" in data
assert "by_category" in data
assert "hotness_distribution" in data
assert "staleness" in data
assert "total_vectors" not in data
class TestGetSessionStats:
def test_session_stats(self, client):
"""Session stats endpoint returns session data."""
response = client.get("/api/v1/stats/sessions/test-session-123")
assert response.status_code == 200
data = response.json()
assert data["status"] == "ok"
result = data["result"]
assert result["session_id"] == "test-session-123"
assert result["total_turns"] == 5
assert result["memories_extracted"] == 3
def test_session_not_found(self, client, mock_service):
"""Missing session returns NOT_FOUND error."""
mock_service.sessions.get.side_effect = KeyError("nonexistent")
response = client.get("/api/v1/stats/sessions/nonexistent")
assert response.status_code == 200
data = response.json()
assert data["status"] == "error"
assert data["error"]["code"] == "NOT_FOUND"
def test_session_internal_error(self, client, mock_service):
"""Unexpected exception returns INTERNAL_ERROR, not NOT_FOUND."""
mock_service.sessions.get.side_effect = RuntimeError("db timeout")
response = client.get("/api/v1/stats/sessions/some-session")
assert response.status_code == 200
data = response.json()
assert data["status"] == "error"
assert data["error"]["code"] == "INTERNAL_ERROR"