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
from types import SimpleNamespace
from unittest.mock import AsyncMock, call
import pytest
from openviking.core.directories import PRESET_DIRECTORIES, DirectoryInitializer
from openviking.core.namespace import (
canonical_user_root,
is_session_uri,
may_include_hidden_actor_peers,
)
from openviking.server.identity import RequestContext, Role
from openviking_cli.session.user_id import UserIdentifier
class _FakeVikingDB:
def __init__(self):
self.embedding_messages = []
self.get_calls = []
async def get(self, ids, ctx):
self.get_calls.append((ids, ctx))
return []
async def enqueue_embedding_msg(self, message):
self.embedding_messages.append(message)
class _FakeVikingFS:
def __init__(self):
self.contexts = {}
async def read_file(self, uri, ctx):
directory, filename = uri.rsplit("/", 1)
name = filename.removeprefix(".").removesuffix(".md")
if directory not in self.contexts or name not in self.contexts[directory]:
raise FileNotFoundError(uri)
return self.contexts[directory][name]
async def write_context(self, uri, abstract="", overview="", is_leaf=False, ctx=None):
if ctx.actor_peer_id and may_include_hidden_actor_peers(uri, ctx):
raise PermissionError(f"actor peer cannot mutate {uri}")
context = self.contexts.setdefault(uri, {})
if abstract:
context["abstract"] = abstract
if overview:
context["overview"] = overview
context["is_leaf"] = is_leaf
@pytest.mark.asyncio
async def test_initialize_account_workspace_batches_preset_directories(monkeypatch):
vikingdb = _FakeVikingDB()
viking_fs = _FakeVikingFS()
viking_fs.contexts["viking://agent"] = {}
viking_fs.contexts["viking://agent/tools"] = {"abstract": "Existing tool configuration"}
initializer = DirectoryInitializer(vikingdb, viking_fs=viking_fs)
ctx = RequestContext(user=UserIdentifier("acme", "alice"), role=Role.ADMIN)
account_count, user_count = await initializer.initialize_account_workspace(ctx)
user_root = canonical_user_root(ctx)
expected_user_uris = {
user_root,
*(f"{user_root}/{child.path}" for child in PRESET_DIRECTORIES["user"].children),
}
expected_agent_uris = {
"viking://agent",
"viking://agent/skills",
"viking://agent/endpoints",
"viking://agent/tools",
"viking://agent/payments",
}
expected_uris = {"viking://resources", *expected_agent_uris, *expected_user_uris}
assert account_count == 6
assert user_count == len(expected_user_uris)
assert set(viking_fs.contexts) == expected_uris
assert f"{user_root}/memories/preferences" not in viking_fs.contexts
for uri in expected_agent_uris:
assert viking_fs.contexts[uri]["abstract"]
assert viking_fs.contexts[uri]["overview"]
assert viking_fs.contexts["viking://agent/tools"]["abstract"] == "Existing tool configuration"
assert len(vikingdb.get_calls) == 1
assert await initializer.initialize_account_directories(ctx) == 0
assert set(viking_fs.contexts) == expected_uris
vectorized_uris = {uri for uri in expected_uris if not is_session_uri(uri)}
assert len(vikingdb.get_calls[0][0]) == 2 * len(vectorized_uris)
assert len(vikingdb.embedding_messages) == 2 * len(vectorized_uris)
for message in vikingdb.embedding_messages:
uri = message.context_data["uri"]
if uri in expected_agent_uris:
name = "abstract" if message.context_data["level"] == 0 else "overview"
assert message.message == viking_fs.contexts[uri][name]
assert message.context_data["parent_uri"] == (
None if uri == "viking://agent" else "viking://agent"
)
malformed_abstract = "---\ndirectory: viking://resources/\n"
viking_fs.contexts["viking://resources"]["abstract"] = malformed_abstract
second_account_count, second_user_count = await initializer.initialize_account_workspace(ctx)
assert (second_account_count, second_user_count) == (0, 0)
assert viking_fs.contexts["viking://resources"]["abstract"] == malformed_abstract
assert set(viking_fs.contexts) == expected_uris
assert len(vikingdb.get_calls) == 1
storage_error = PermissionError("storage access denied")
monkeypatch.setattr(viking_fs, "read_file", AsyncMock(side_effect=storage_error))
with pytest.raises(PermissionError) as exc_info:
await initializer.initialize_account_workspace(ctx)
assert exc_info.value is storage_error
@pytest.mark.asyncio
async def test_initialize_user_directories_ignores_actor_peer_view_for_preset_structure():
vikingdb = _FakeVikingDB()
viking_fs = _FakeVikingFS()
initializer = DirectoryInitializer(vikingdb, viking_fs=viking_fs)
ctx = RequestContext(
user=UserIdentifier("acme", "support-bot"),
role=Role.USER,
actor_peer_id="customer-a",
)
count = await initializer.initialize_user_directories(ctx)
user_root = canonical_user_root(ctx)
expected_uris = {
user_root,
*(f"{user_root}/{child.path}" for child in PRESET_DIRECTORIES["user"].children),
}
assert count == len(expected_uris)
assert set(viking_fs.contexts) == expected_uris
@pytest.mark.asyncio
async def test_system_assets_sync_only_for_account_initialization():
synchronizer = SimpleNamespace(sync=AsyncMock())
initializer = DirectoryInitializer(
_FakeVikingDB(),
viking_fs=_FakeVikingFS(),
system_asset_synchronizer=synchronizer,
)
ctx = RequestContext(user=UserIdentifier("acme", "alice"), role=Role.ADMIN)
await initializer.initialize_account_workspace(ctx, sync_system_assets=False)
synchronizer.sync.assert_not_awaited()
await initializer.initialize_account_workspace(ctx)
await initializer.initialize_account_directories(ctx)
await initializer.initialize_user_directories(ctx)
assert synchronizer.sync.await_args_list == [call(ctx), call(ctx)]
def test_preset_directory_uris_cover_seeded_directories_only():
from openviking.core.directories import preset_directory_uris
ctx = RequestContext(user=UserIdentifier("acme", "alice"), role=Role.USER)
user_root = canonical_user_root(ctx)
uris = preset_directory_uris(ctx)
assert {
"viking://resources",
"viking://agent",
"viking://agent/skills",
user_root,
f"{user_root}/memories",
f"{user_root}/resources",
f"{user_root}/privacy",
f"{user_root}/peers",
} <= uris
assert f"{user_root}/memories/preferences" not in uris
assert "viking://resources/proj" not in uris