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 types import SimpleNamespace
import pytest
from openviking.storage.queuefs import semantic_processor as semantic_processor_module
from openviking.storage.queuefs.semantic_processor import SemanticProcessor
class RecordingVLM:
def __init__(self):
self.prompts = []
def is_available(self):
return True
async def get_completion_async(self, prompt):
self.prompts.append(prompt)
return f"overview-{len(self.prompts)}"
class MergePlaceholderVLM(RecordingVLM):
async def get_completion_async(self, prompt):
self.prompts.append(prompt)
if len(self.prompts) == 1:
return "[first](viking://input_sample_f1)"
if len(self.prompts) == 2:
return "[second](viking://input_sample_f2)"
return "[first](viking://input_sample_f1) and [second](viking://input_sample_f2)"
class _TestVLMResolver:
def __init__(self, vlm):
self._vlm = vlm
async def get_vlm(self, account_id):
del account_id
return self._vlm
@pytest.mark.asyncio
async def test_children_only_oversized_overview_is_batched(monkeypatch):
vlm = RecordingVLM()
config = SimpleNamespace(
vlm=vlm,
semantic=SimpleNamespace(
max_overview_prompt_chars=20,
overview_batch_size=2,
),
output_language_override="en",
)
monkeypatch.setattr(
semantic_processor_module,
"get_openviking_config",
lambda: config,
)
monkeypatch.setattr(
semantic_processor_module,
"render_prompt",
lambda _name, values: (
f"files={values['file_summaries']}|children={values['children_abstracts']}"
),
)
children = [{"name": f"child-{index}", "abstract": "x" * 20} for index in range(3)]
overview = await SemanticProcessor(
vlm_resolver=_TestVLMResolver(vlm)
)._generate_overview(
"viking://resources/root",
file_summaries=[],
children_abstracts=children,
)
assert overview == "overview-3"
assert len(vlm.prompts) == 3
assert "child-0" in vlm.prompts[0]
assert "child-1" in vlm.prompts[0]
assert "child-2" not in vlm.prompts[0]
assert "child-2" in vlm.prompts[1]
assert all(f"child-{index}" not in vlm.prompts[2] for index in range(3))
@pytest.mark.asyncio
async def test_sampled_overview_prompt_describes_full_directory_coverage(monkeypatch):
vlm = RecordingVLM()
config = SimpleNamespace(
vlm=vlm,
semantic=SimpleNamespace(
max_overview_prompt_chars=10_000,
overview_batch_size=32,
),
output_language_override="en",
)
captured = {}
monkeypatch.setattr(
semantic_processor_module,
"get_openviking_config",
lambda: config,
)
def fake_render_prompt(_name, values):
captured.update(values)
return "prompt"
monkeypatch.setattr(semantic_processor_module, "render_prompt", fake_render_prompt)
await SemanticProcessor(vlm_resolver=_TestVLMResolver(vlm))._generate_overview(
"viking://resources/docs_flat",
file_summaries=[],
children_abstracts=[{"name": "sample", "abstract": "summary"}],
total_files=0,
total_children=513,
)
coverage = captured["directory_coverage"]
assert "Total direct entries: 513" in coverage
assert "Summaries provided for this aggregation: 1" in coverage
assert "Direct entries not individually shown: 512" in coverage
assert "Coverage: sampled" in coverage
@pytest.mark.asyncio
async def test_batched_merge_resolves_placeholders_from_merge_output(monkeypatch):
vlm = MergePlaceholderVLM()
config = SimpleNamespace(
vlm=vlm,
semantic=SimpleNamespace(
max_overview_prompt_chars=1,
overview_batch_size=1,
),
output_language_override="en",
)
monkeypatch.setattr(
semantic_processor_module,
"get_openviking_config",
lambda: config,
)
monkeypatch.setattr(
semantic_processor_module,
"render_prompt",
lambda _name, values: values["file_summaries"],
)
overview = await SemanticProcessor(
vlm_resolver=_TestVLMResolver(vlm)
)._generate_overview(
"viking://resources/业务 docs",
file_summaries=[
{"name": "first file.md", "summary": "first summary"},
{"name": "第二章#file.md", "summary": "second summary"},
],
children_abstracts=[],
)
assert overview == (
"[first](viking://resources/业务%20docs/first%20file.md) and "
"[second](viking://resources/业务%20docs/第二章%23file.md)"
)
assert "viking://input_sample_" not in overview
@pytest.mark.asyncio
async def test_overview_includes_more_than_32_children_under_budget(monkeypatch):
from openviking_cli.utils.config.parser_config import SemanticConfig
vlm = RecordingVLM()
config = SimpleNamespace(semantic=SemanticConfig(), output_language_override="en")
monkeypatch.setattr(semantic_processor_module, "get_openviking_config", lambda: config)
files = [{"name": f"file-{i:03}.md", "summary": f"marker-{i:03}"} for i in range(40)]
await SemanticProcessor(vlm_resolver=_TestVLMResolver(vlm))._generate_overview(
"viking://resources/wide", files, []
)
assert len(vlm.prompts) == 1
assert all(item["summary"] in vlm.prompts[0] for item in files)