Skip to content

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

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

import json

import pytest

from openviking.server.config import (
    ServerConfig,
    get_server_url_from_server_data,
    load_bot_gateway_token,
    load_server_config,
    map_bind_host_to_loopback,
)


def test_load_server_config_ignores_unknown_fields(tmp_path):
    config_path = tmp_path / "ov.conf"
    config_path.write_text(
        json.dumps(
            {
                "server": {
                    "host": "0.0.0.0",
                    "prt": 9999,
                    "queuefs_scope": "process",
                    "observability": {
                        "metrics": {"exporters": {"prometheus": {"enabld": True, "enabled": False}}}
                    },
                }
            }
        )
    )

    config = load_server_config(str(config_path))

    assert config.host == "0.0.0.0"
    assert config.port == 1933
    assert config.observability.metrics.exporters.prometheus.enabled is False
    assert "prt" not in config.model_dump()
    assert "queuefs_scope" not in config.model_dump()


def test_load_server_config_reports_invalid_value_path(tmp_path):
    config_path = tmp_path / "ov.conf"
    config_path.write_text(json.dumps({"server": {"port": "abc"}}))

    with pytest.raises(ValueError, match=r"Invalid value for 'server\.port'"):
        load_server_config(str(config_path))


def test_load_server_config_preserves_supported_fields(tmp_path):
    config_path = tmp_path / "ov.conf"
    config_path.write_text(
        json.dumps(
            {
                "server": {
                    "host": "0.0.0.0",
                    "port": 1944,
                    "workers": 2,
                    "executor_threads": 64,
                    "timeout_keep_alive": 120,
                    "auth_mode": "trusted",
                    "with_bot": True,
                    "bot_api_url": "http://localhost:19999",
                    "observability": {"metrics": {"exporters": {"prometheus": {"enabled": True}}}},
                },
                "storage": {"agfs": {"queuefs": {"mode": "worker"}}},
                "encryption": {"enabled": True},
            }
        )
    )

    config = load_server_config(str(config_path))

    assert config.host == "0.0.0.0"
    assert config.port == 1944
    assert config.workers == 2
    assert config.executor_threads == 64
    assert config.timeout_keep_alive == 120
    assert config.auth_mode == "trusted"
    assert config.with_bot is True
    assert config.bot_api_url == "http://localhost:19999"
    assert config.observability.metrics.exporters.prometheus.enabled is True
    assert config.encryption_enabled is True


def test_load_server_config_defaults_timeout_keep_alive(tmp_path):
    config_path = tmp_path / "ov.conf"
    config_path.write_text(json.dumps({"server": {"host": "0.0.0.0"}}))

    config = load_server_config(str(config_path))

    assert config.timeout_keep_alive == 5
    assert config.executor_threads == 0


def test_load_server_config_rejects_negative_default_executor_size(tmp_path):
    config_path = tmp_path / "ov.conf"
    config_path.write_text(json.dumps({"server": {"executor_threads": -1}}))

    with pytest.raises(
        ValueError,
        match=r"server\.executor_threads",
    ):
        load_server_config(str(config_path))


def test_load_bot_gateway_token_reads_token_from_bot_gateway_section(tmp_path):
    config_path = tmp_path / "ov.conf"
    config_path.write_text(json.dumps({"bot": {"gateway": {"token": "gateway-token"}}}))

    assert load_bot_gateway_token(str(config_path)) == "gateway-token"


def test_server_config_get_effective_auth_mode():
    assert ServerConfig(auth_mode="trusted").get_effective_auth_mode() == "trusted"
    assert ServerConfig(root_api_key="root-key").get_effective_auth_mode() == "api_key"
    assert ServerConfig().get_effective_auth_mode() == "dev"


def test_get_server_url_from_server_data_uses_server_host_and_port():
    server = {"host": "127.0.0.1", "port": 1933}

    assert get_server_url_from_server_data(server) == "http://127.0.0.1:1933"


def test_get_server_url_from_server_config_uses_runtime_host_and_port():
    config = ServerConfig(host="127.0.0.1", port=1944)

    assert get_server_url_from_server_data(config) == "http://127.0.0.1:1944"


def test_get_server_url_from_server_data_brackets_ipv6_literal():
    server = {"host": "::1", "port": 1933}

    assert get_server_url_from_server_data(server) == "http://[::1]:1933"


def test_get_server_url_from_server_config_brackets_ipv6_literal():
    config = ServerConfig(host="::1", port=1944)

    assert get_server_url_from_server_data(config) == "http://[::1]:1944"


@pytest.mark.parametrize(
    "host, expected",
    [
        # IPv4 wildcard bind addresses are not connectable -> loopback.
        ("0.0.0.0", "127.0.0.1"),
        ("", "127.0.0.1"),
        ("*", "127.0.0.1"),
        # IPv6 wildcard bind addresses -> IPv6 loopback (bracketed for URLs).
        ("::", "[::1]"),
        ("::0", "[::1]"),
        ("[::]", "[::1]"),
        # Real IPv6 literals are bracketed but otherwise preserved.
        ("::1", "[::1]"),
        ("[::1]", "[::1]"),
        # Concrete reachable hosts pass through untouched.
        ("127.0.0.1", "127.0.0.1"),
        ("192.168.1.10", "192.168.1.10"),
        ("openviking.local", "openviking.local"),
    ],
)
def test_map_bind_host_to_loopback(host, expected):
    assert map_bind_host_to_loopback(host) == expected


def test_get_server_url_from_server_data_maps_ipv4_wildcard_to_loopback():
    # Regression for issue #2856: server.host "0.0.0.0" is a bind address, not a
    # destination the bot/client can connect to.
    server = {"host": "0.0.0.0", "port": 1933}

    assert get_server_url_from_server_data(server) == "http://127.0.0.1:1933"


def test_get_server_url_from_server_config_maps_ipv4_wildcard_to_loopback():
    config = ServerConfig(host="0.0.0.0", port=1933)

    assert get_server_url_from_server_data(config) == "http://127.0.0.1:1933"


def test_get_server_url_from_server_data_maps_ipv6_wildcard_to_loopback():
    server = {"host": "::", "port": 1933}

    assert get_server_url_from_server_data(server) == "http://[::1]:1933"


def test_load_server_config_preserves_metrics_account_dimension_fields(tmp_path):
    config_path = tmp_path / "ov.conf"
    config_path.write_text(
        json.dumps(
            {
                "server": {
                    "observability": {
                        "metrics": {
                            "enabled": True,
                            "account_dimension": {
                                "enabled": True,
                                "max_active_accounts": 5,
                                "metric_allowlist": [
                                    "openviking_http_requests_total",
                                    "openviking_task_pending",
                                ],
                            },
                        }
                    }
                }
            }
        )
    )

    config = load_server_config(str(config_path))

    assert config.observability.metrics.enabled is True
    assert config.observability.metrics.account_dimension.enabled is True
    assert config.observability.metrics.account_dimension.max_active_accounts == 5
    assert config.observability.metrics.account_dimension.metric_allowlist == [
        "openviking_http_requests_total",
        "openviking_task_pending",
    ]


def test_load_server_config_preserves_otlp_headers_fields(tmp_path):
    config_path = tmp_path / "ov.conf"
    config_path.write_text(
        json.dumps(
            {
                "server": {
                    "observability": {
                        "traces": {
                            "enabled": True,
                            "headers": {
                                "X-ByteAPM-AppKey": "trace-appkey",
                            },
                        },
                        "logs": {
                            "enabled": True,
                            "headers": {
                                "X-ByteAPM-AppKey": "log-appkey",
                            },
                        },
                        "metrics": {
                            "enabled": True,
                            "exporters": {
                                "otel": {
                                    "enabled": True,
                                    "headers": {
                                        "X-ByteAPM-AppKey": "metric-appkey",
                                    },
                                }
                            },
                        },
                    }
                }
            }
        )
    )

    config = load_server_config(str(config_path))

    assert config.observability.traces.headers == {
        "X-ByteAPM-AppKey": "trace-appkey",
    }
    assert config.observability.logs.headers == {
        "X-ByteAPM-AppKey": "log-appkey",
    }
    assert config.observability.metrics.exporters.otel.headers == {
        "X-ByteAPM-AppKey": "metric-appkey",
    }


def test_load_server_config_trace_local_defaults(tmp_path):
    config_path = tmp_path / "ov.conf"
    config_path.write_text(
        json.dumps(
            {
                "server": {
                    "observability": {
                        "traces": {
                            "enabled": True,
                            "protocol": "local",
                        }
                    }
                }
            }
        )
    )

    config = load_server_config(str(config_path))

    traces = config.observability.traces
    assert traces.enabled is True
    assert traces.protocol == "local"
    assert traces.service_name == "openviking-server"
    assert traces.local_path == "~/.openviking/logs/traces.jsonl"
    assert traces.local_rotation_mb == 40
    assert traces.local_backup_count == 2