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
from types import SimpleNamespace
from unittest.mock import AsyncMock
import pytest
from openviking.session.memory.dataclass import MemoryFile, MemoryTypeSchema
from openviking.session.memory.patch_merge_context_provider import (
PatchMergeContextProvider,
PatchMergePatch,
)
from openviking.session.skill.session_skill_context_provider import load_skill_extract_registry
def _memory_file(
*,
name: str,
uri: str | None,
content: str,
memory_type: str = "experiences",
) -> MemoryFile:
return MemoryFile(
uri=uri,
content=content,
memory_type=memory_type,
extra_fields={
"memory_type": memory_type,
"experience_name": name,
"status": "production",
},
)
@pytest.mark.asyncio
async def test_patch_merge_context_provider_prefetch_reads_originals_and_renders_patch():
uri = "viking://user/u/memories/experiences/booking.md"
provider = PatchMergeContextProvider(
memory_type="experiences",
required_file_uris=[uri],
patches=[
PatchMergePatch(
before_file=_memory_file(name="booking", uri=uri, content="old line\nkeep line"),
after_file=_memory_file(name="booking", uri=uri, content="new line\nkeep line"),
)
],
)
provider.read_file = AsyncMock(
return_value={
"memory_type": "experiences",
"experience_name": "booking",
"content": "1\told line\n2\tkeep line",
}
)
messages = await provider.prefetch()
assert provider.get_tools() == []
assert provider.read_file.await_count == 1
read_message = json.loads(messages[0]["content"])
assert read_message["tool_call_name"] == "read"
assert read_message["args"] == {"uri": "viking://user/u/memories/experiences/booking.md"}
assert read_message["result"]["experience_name"] == "booking"
assert messages[1]["role"] == "user"
assert messages[1]["content"].startswith("# Memory File Patches")
assert "Patch 1" in messages[1]["content"]
# Patch headers should not include target_uri/target_name/memory_type
assert "target_uri:" not in messages[1]["content"]
assert "target_name:" not in messages[1]["content"]
assert " content:" in messages[1]["content"]
assert "--- content.before" not in messages[1]["content"]
assert "+++ content.after" not in messages[1]["content"]
assert " -old line" in messages[1]["content"]
assert " +new line" in messages[1]["content"]
assert " keep line" in messages[1]["content"] # n=1 context line
assert " status:" not in messages[1]["content"]
@pytest.mark.asyncio
async def test_patch_merge_context_provider_prefetch_searches_and_reads_extra_candidates():
schema = MemoryTypeSchema(
memory_type="experiences",
description="Experiences",
directory="viking://user/{{ user_space }}/memories/experiences",
filename_template="{{ experience_name }}.md",
fields=[],
)
provider = PatchMergeContextProvider(
memory_type="experiences",
required_file_uris=["viking://user/u/memories/experiences/book.md"],
patches=[
PatchMergePatch(
before_file=None,
after_file=_memory_file(
name="books",
uri="viking://user/u/memories/experiences/books.md",
content="用户喜欢阅读科幻书籍,尤其是太空歌剧。",
),
)
],
)
provider._registry = SimpleNamespace(get=lambda name: schema if name == "experiences" else None)
provider._ctx = SimpleNamespace(user=SimpleNamespace(user_id="u"))
provider.search_files = AsyncMock(
return_value=[
"viking://user/u/memories/experiences/book.md",
*[f"viking://user/u/memories/experiences/candidate_{idx}.md" for idx in range(10)],
]
)
provider.read_file = AsyncMock(
return_value={
"memory_type": "experiences",
"experience_name": "candidate",
"content": "candidate content",
}
)
messages = await provider.prefetch()
provider.search_files.assert_awaited_once()
_, search_kwargs = provider.search_files.await_args
assert search_kwargs["search_uris"] == ["viking://user/u/memories/experiences"]
assert search_kwargs["limit"] == 10
assert provider.read_file.await_count == 6
read_uris = [call.args[0] for call in provider.read_file.await_args_list]
assert read_uris[0] == "viking://user/u/memories/experiences/book.md"
assert "viking://user/u/memories/experiences/candidate_0.md" in read_uris
assert "viking://user/u/memories/experiences/candidate_4.md" in read_uris
assert "viking://user/u/memories/experiences/candidate_5.md" not in read_uris
assert messages[-1]["content"].startswith("# Memory File Patches")
@pytest.mark.asyncio
async def test_patch_merge_context_provider_skips_extra_candidates_for_existing_files():
uri = "viking://user/u/memories/experiences/booking.md"
provider = PatchMergeContextProvider(
memory_type="experiences",
required_file_uris=[uri],
patches=[
PatchMergePatch(
before_file=_memory_file(name="booking", uri=uri, content="old line"),
after_file=_memory_file(name="booking", uri=uri, content="new line"),
)
],
)
provider.search_files = AsyncMock(
return_value=["viking://user/u/memories/experiences/other.md"]
)
provider.read_file = AsyncMock(
return_value={
"memory_type": "experiences",
"experience_name": "booking",
"content": "1\told line",
}
)
messages = await provider.prefetch()
provider.search_files.assert_not_awaited()
provider.read_file.assert_awaited_once_with(uri)
assert len(messages) == 2
@pytest.mark.asyncio
async def test_patch_merge_context_provider_caps_extra_candidate_reads_at_ten():
schema = MemoryTypeSchema(
memory_type="experiences",
description="Experiences",
directory="viking://user/{{ user_space }}/memories/experiences",
filename_template="{{ experience_name }}.md",
fields=[],
)
required_uris = [f"viking://user/u/memories/experiences/required_{idx}.md" for idx in range(12)]
provider = PatchMergeContextProvider(
memory_type="experiences",
required_file_uris=required_uris,
patches=[
PatchMergePatch(
before_file=None,
after_file=_memory_file(
name="books",
uri="viking://user/u/memories/experiences/books.md",
content="用户喜欢阅读科幻书籍,尤其是太空歌剧。",
),
)
],
)
provider._registry = SimpleNamespace(get=lambda name: schema if name == "experiences" else None)
provider._ctx = SimpleNamespace(user=SimpleNamespace(user_id="u"))
provider.search_files = AsyncMock(
return_value=[
*required_uris,
*[f"viking://user/u/memories/experiences/candidate_{idx}.md" for idx in range(20)],
]
)
provider.read_file = AsyncMock(
return_value={
"memory_type": "experiences",
"experience_name": "candidate",
"content": "candidate content",
}
)
await provider.prefetch()
_, search_kwargs = provider.search_files.await_args
assert search_kwargs["limit"] == 20
assert provider.read_file.await_count == 22
read_uris = [call.args[0] for call in provider.read_file.await_args_list]
assert required_uris[-1] in read_uris
assert "viking://user/u/memories/experiences/candidate_9.md" in read_uris
assert "viking://user/u/memories/experiences/candidate_10.md" not in read_uris
@pytest.mark.asyncio
async def test_patch_merge_context_provider_renders_compact_patch_metadata():
provider = PatchMergeContextProvider(
memory_type="experiences",
required_file_uris=[],
patches=[
PatchMergePatch(
before_file=None,
after_file=_memory_file(
name="new_booking",
uri=None,
content="created line",
),
metadata={
"base_version": 3,
"rationale": "useful reason",
"confidence": 0.9,
"links": [{"to_uri": "viking://user/u/memories/trajectories/t.md"}],
"memory_fields": {"content": "created line"},
"uris": ["viking://user/u/memories/experiences/new_booking.md"],
"gradient_metadata": {
"trajectory_outcome": "success",
"rubric_passed": True,
"training_category": "tau2:airline:train:1",
"memory_fields": {"content": "duplicated"},
},
},
)
],
)
messages = await provider.prefetch()
content = messages[0]["content"]
assert 'meta: {"confidence": 0.9}' in content
assert "base_version" not in content
assert "rationale" not in content
assert "trajectory_outcome" not in content
assert "gradient_metadata" not in content
assert "links" not in content
assert "memory_fields" not in content
assert "duplicated" not in content
@pytest.mark.asyncio
async def test_patch_merge_context_provider_hides_last_update_trace_id_from_patch_diff():
provider = PatchMergeContextProvider(
memory_type="experiences",
required_file_uris=[],
patches=[
PatchMergePatch(
before_file=MemoryFile(
uri="viking://user/u/memories/experiences/booking.md",
content="same content",
memory_type="experiences",
extra_fields={
"memory_type": "experiences",
"experience_name": "booking",
"last_update_trace_id": "trace_old",
},
),
after_file=MemoryFile(
uri="viking://user/u/memories/experiences/booking.md",
content="same content",
memory_type="experiences",
extra_fields={
"memory_type": "experiences",
"experience_name": "booking",
"last_update_trace_id": "trace_new",
},
),
)
],
)
messages = await provider.prefetch()
content = messages[0]["content"]
assert "last_update_trace_id" not in content
assert "trace_old" not in content
assert "trace_new" not in content
assert "(no changes)" in content
@pytest.mark.asyncio
async def test_patch_merge_context_provider_renders_create_patch_from_dev_null():
provider = PatchMergeContextProvider(
memory_type="experiences",
required_file_uris=[],
patches=[
PatchMergePatch(
before_file=None,
after_file=_memory_file(name="new_booking", uri=None, content="created line"),
)
],
)
messages = await provider.prefetch()
assert len(messages) == 1
assert "Patch 1" in messages[0]["content"]
# Patch headers should not include target_name/target_uri/memory_type
assert "target_name:" not in messages[0]["content"]
assert "target_uri:" not in messages[0]["content"]
# Field diffs may include memory_type field changes (that's expected)
assert " content:" in messages[0]["content"]
assert "--- content.before" not in messages[0]["content"]
assert "+++ content.after" not in messages[0]["content"]
assert " +created line" in messages[0]["content"]
def test_patch_merge_context_provider_get_memory_schema_single_type(monkeypatch):
schema = MemoryTypeSchema(
memory_type="experiences",
description="Experiences",
directory="viking://user/{{ user_space }}/memories/experiences",
filename_template="{{ experience_name }}.md",
fields=[],
)
provider = PatchMergeContextProvider(
memory_type="experiences",
required_file_uris=[],
patches=[],
)
provider._registry = SimpleNamespace(get=lambda name: schema if name == "experiences" else None)
assert provider.get_memory_schemas(ctx=None) == [schema]
def test_patch_merge_context_provider_get_memory_schema_raises_for_missing_type():
provider = PatchMergeContextProvider(
memory_type="missing",
required_file_uris=[],
patches=[],
)
provider._registry = SimpleNamespace(get=lambda name: None)
with pytest.raises(ValueError, match="Memory schema not found or disabled: missing"):
provider.get_memory_schemas(ctx=None)
def test_patch_merge_context_provider_uses_registry_override_for_session_skills():
provider = PatchMergeContextProvider(
memory_type="session_skills",
memory_registry=load_skill_extract_registry(),
required_file_uris=[],
patches=[],
)
schemas = provider.get_memory_schemas(ctx=None)
assert len(schemas) == 1
assert schemas[0].memory_type == "session_skills"
assert schemas[0].enabled is True
def test_patch_merge_context_provider_instruction_mentions_path_field_normalization():
provider = PatchMergeContextProvider(
memory_type="entities",
required_file_uris=[],
patches=[],
)
instruction = provider.instruction()
assert "independent extraction patch proposals" in instruction
assert "same identity under the active memory schema" in instruction
assert "same object or occurrence" in instruction
assert "overlapping topic only identifies candidates" in instruction
assert "never sufficient evidence" in instruction
assert "every substantive atomic fact" in instruction
assert "If identity is uncertain" in instruction
assert "directory/filename fields" in instruction
assert "schema identifiers" in instruction
assert "book not books" in instruction
assert "Chinese" in instruction
assert "书籍 not 书/图书" in instruction
assert "verified duplicate existing file" in instruction
assert "put it in delete_ids" in instruction
def test_patch_merge_context_provider_detects_language_from_patch_content(monkeypatch):
monkeypatch.setenv("TZ", "Asia/Shanghai")
provider = PatchMergeContextProvider(
memory_type="preferences",
required_file_uris=[],
patches=[
PatchMergePatch(
before_file=None,
after_file=MemoryFile(
uri=None,
content="User prefers concise implementation and minimal fallback logic.",
memory_type="preferences",
extra_fields={
"memory_type": "preferences",
"user": "alice",
"topic": "code_style",
},
),
)
],
)
assert provider.get_output_language() == "en"
assert "All memory content must be written in en." in provider.instruction()
def test_patch_merge_context_provider_empty_patches_fallback_to_english(monkeypatch):
monkeypatch.setenv("TZ", "Asia/Shanghai")
provider = PatchMergeContextProvider(
memory_type="preferences",
required_file_uris=[],
patches=[],
)
assert provider.get_output_language() == "en"
def test_patch_merge_context_provider_ignores_before_file_language(monkeypatch):
monkeypatch.setenv("TZ", "Asia/Shanghai")
provider = PatchMergeContextProvider(
memory_type="preferences",
required_file_uris=[],
patches=[
PatchMergePatch(
before_file=MemoryFile(
uri="viking://user/u/memories/preferences/old.md",
content="用户偏好简洁实现。",
memory_type="preferences",
extra_fields={"memory_type": "preferences", "topic": "代码风格"},
),
after_file=MemoryFile(
uri="viking://user/u/memories/preferences/old.md",
content="User prefers concise implementation.",
memory_type="preferences",
extra_fields={"memory_type": "preferences", "topic": "code_style"},
),
)
],
)
assert provider.get_output_language() == "en"