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
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