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
from __future__ import annotations
import json
import httpx
import pytest
from openviking_sdk import AsyncHTTPClient
def test_async_http_client_loads_connection_fields_from_ovcli_config(tmp_path, monkeypatch):
config_path = tmp_path / "ovcli.conf"
config_path.write_text(
json.dumps(
{
"url": "http://config-host:1933",
"api_key": "config-key",
"gateway_token": "gateway-secret",
"account": "config-account",
"user": "config-user",
"timeout": 12.5,
}
)
)
monkeypatch.setenv("OPENVIKING_CLI_CONFIG_FILE", str(config_path))
monkeypatch.delenv("OPENVIKING_URL", raising=False)
monkeypatch.delenv("OPENVIKING_API_KEY", raising=False)
client = AsyncHTTPClient()
assert client._url == "http://config-host:1933"
assert client._api_key == "config-key"
assert client._gateway_token == "gateway-secret"
assert "X-Gateway-Token" not in client._extra_headers
assert client._account == "config-account"
assert client._user_id == "config-user"
assert client._timeout == 12.5
def test_async_http_client_loads_upload_mode_and_extra_headers_from_ovcli_config(
tmp_path, monkeypatch
):
config_path = tmp_path / "ovcli.conf"
config_path.write_text(
json.dumps(
{
"url": "http://config-host:1933",
"upload": {"mode": "shared"},
"extra_headers": {
"X-Custom-Header": "custom-value",
"Authorization": "Bearer token",
},
}
)
)
monkeypatch.setenv("OPENVIKING_CLI_CONFIG_FILE", str(config_path))
monkeypatch.delenv("OPENVIKING_URL", raising=False)
client = AsyncHTTPClient()
assert client._upload_mode == "shared"
assert client._extra_headers == {
"X-Custom-Header": "custom-value",
"Authorization": "Bearer token",
}
def test_async_http_client_explicit_arguments_override_ovcli_config(tmp_path, monkeypatch):
config_path = tmp_path / "ovcli.conf"
config_path.write_text(
json.dumps(
{
"url": "http://config-host:1933",
"api_key": "config-key",
"gateway_token": "gateway-secret",
"account": "config-account",
"user": "config-user",
"timeout": 12.5,
"upload": {"mode": "shared"},
"extra_headers": {"X-Custom-Header": "from-config"},
}
)
)
monkeypatch.setenv("OPENVIKING_CLI_CONFIG_FILE", str(config_path))
client = AsyncHTTPClient(
url="http://explicit-host:1933",
api_key="explicit-key",
account="explicit-account",
user="explicit-user",
timeout=33.0,
extra_headers={"X-Custom-Header": "from-explicit"},
upload_mode="local",
)
assert client._url == "http://explicit-host:1933"
assert client._gateway_token is None
assert client._api_key == "explicit-key"
assert client._account == "explicit-account"
assert client._user_id == "explicit-user"
assert client._timeout == 33.0
assert client._extra_headers == {"X-Custom-Header": "from-explicit"}
assert client._upload_mode == "local"
def test_async_http_client_explicit_default_timeout_overrides_lower_priority_sources(
tmp_path, monkeypatch
):
config_path = tmp_path / "ovcli.conf"
config_path.write_text(json.dumps({"url": "http://config-host:1933", "timeout": 12.5}))
monkeypatch.setenv("OPENVIKING_CLI_CONFIG_FILE", str(config_path))
monkeypatch.setenv("OPENVIKING_TIMEOUT", "20")
client = AsyncHTTPClient(timeout=60.0)
assert client._timeout == 60.0
def test_async_http_client_reports_invalid_ovcli_config(tmp_path, monkeypatch):
config_path = tmp_path / "ovcli.conf"
config_path.write_text(json.dumps({"url": "http://localhost:1933", "timeout": "fast"}))
monkeypatch.setenv("OPENVIKING_CLI_CONFIG_FILE", str(config_path))
monkeypatch.delenv("OPENVIKING_URL", raising=False)
with pytest.raises(ValueError, match="Invalid CLI config"):
AsyncHTTPClient()
def test_async_http_client_does_not_override_explicit_gateway_header(tmp_path, monkeypatch):
config_path = tmp_path / "ovcli.conf"
config_path.write_text(
json.dumps(
{
"url": "http://config-host:1933",
"gateway_token": "gateway-secret",
"extra_headers": {"x-gateway-token": "manual-secret"},
}
)
)
monkeypatch.setenv("OPENVIKING_CLI_CONFIG_FILE", str(config_path))
monkeypatch.delenv("OPENVIKING_URL", raising=False)
client = AsyncHTTPClient()
assert client._extra_headers["x-gateway-token"] == "manual-secret"
assert "X-Gateway-Token" not in client._extra_headers
@pytest.mark.asyncio
async def test_async_http_client_retries_gateway_token_only_after_marked_challenge(
tmp_path, monkeypatch
):
config_path = tmp_path / "ovcli.conf"
config_path.write_text(
json.dumps(
{
"url": "http://gateway.example",
"gateway_token": "gateway-secret",
}
)
)
monkeypatch.setenv("OPENVIKING_CLI_CONFIG_FILE", str(config_path))
requests = []
def handler(request: httpx.Request) -> httpx.Response:
requests.append(request)
if len(requests) == 1:
return httpx.Response(
401,
headers={"X-VikingBot-Gateway": "true"},
json={"detail": "X-Gateway-Token header required"},
)
return httpx.Response(200, json={"status": "ok"})
client = AsyncHTTPClient()
await client.initialize()
await client._http.aclose()
client._http = httpx.AsyncClient(
base_url=client._url,
transport=httpx.MockTransport(handler),
)
try:
assert await client.health() is True
finally:
await client.close()
assert len(requests) == 2
assert "X-Gateway-Token" not in requests[0].headers
assert requests[1].headers["X-Gateway-Token"] == "gateway-secret"
def test_async_http_client_inherits_profile_enabled_from_ovcli_config(tmp_path, monkeypatch):
config_path = tmp_path / "ovcli.conf"
config_path.write_text(
json.dumps(
{
"url": "http://config-host:1933",
"profile": True,
}
)
)
monkeypatch.setenv("OPENVIKING_CLI_CONFIG_FILE", str(config_path))
monkeypatch.delenv("OPENVIKING_URL", raising=False)
client = AsyncHTTPClient()
assert client._profile_enabled is True
def test_async_http_client_rejects_explicit_actor_peer_id_and_agent_id_together():
with pytest.raises(ValueError, match="actor_peer_id cannot be used with agent_id"):
AsyncHTTPClient(
url="http://explicit-host:1933",
actor_peer_id="actor-a",
agent_id="legacy-agent",
)