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 pytest
from openviking.session.memory.dataclass import MemoryFile
from openviking.session.memory.utils.resource_refs import (
contains_resource_uri,
content_references_resource,
extract_resource_uris,
sync_memory_resource_refs,
unlink_resource_references_from_memory,
)
@pytest.mark.parametrize(
("name", "encoded"),
[("a#one.md", "a%23one.md"), ("a%23one.md", "a%2523one.md")],
)
@pytest.mark.parametrize("bare", [False, True])
def test_resource_refs_preserve_literal_filenames(name, encoded, bare):
root = "viking://resources/source/"
uri = root + name
content = f"Source {uri}" if bare else f"[Source]({root}{encoded}#intro)"
mf = MemoryFile(content=content, extra_fields={})
assert extract_resource_uris(content) == [uri]
assert sync_memory_resource_refs(mf, source="compile")
assert mf.extra_fields["resource_refs"][0]["resource_uri"] == uri
assert f"]({root}{encoded}" in mf.content
assert not sync_memory_resource_refs(mf, source="compile")
assert extract_resource_uris(mf.content) == [uri]
assert content_references_resource(mf.content, uri)
for other in {"a#one.md", "a%23one.md", "a#two.md", "a"} - {name}:
assert not content_references_resource(mf.content, root + other)
assert not unlink_resource_references_from_memory(mf, root + other)
assert unlink_resource_references_from_memory(mf, uri)
assert mf.content == "Source"
assert "resource_refs" not in mf.extra_fields
def test_extract_resource_uris_stops_at_common_sentence_delimiters():
cases = [
(
"看了 viking://resources/images/foo.jpeg,觉得不错",
"viking://resources/images/foo.jpeg",
),
(
"看了 viking://resources/images/foo.jpeg。还看了别的",
"viking://resources/images/foo.jpeg",
),
(
"看了 viking://resources/images/foo.jpeg;然后记录",
"viking://resources/images/foo.jpeg",
),
(
"看了 viking://resources/images/foo.jpeg!真的好",
"viking://resources/images/foo.jpeg",
),
(
"看了 viking://resources/images/foo.jpeg?真的好",
"viking://resources/images/foo.jpeg",
),
(
"看了 viking://resources/images/foo.jpeg、还有别的",
"viking://resources/images/foo.jpeg",
),
(
"看了 viking://resources/images/foo.jpeg)然后记录",
"viking://resources/images/foo.jpeg",
),
(
"看了 viking://resources/images/foo.jpeg(临时上传)",
"viking://resources/images/foo.jpeg",
),
(
"read viking://resources/images/foo.jpeg, then commented",
"viking://resources/images/foo.jpeg",
),
]
for content, expected in cases:
assert extract_resource_uris(content) == [expected]
def test_extract_resource_uris_does_not_match_resource_prefix_words():
cases = [
"viking://resources2/images/foo",
"viking://resources-old/images/foo",
"viking://user/alice/resources2/images/foo",
"viking://user/alice/resources-old/images/foo",
"viking://user/alice/peers/bob/resources2/images/foo",
"viking://user/alice/peers/bob/resources-old/images/foo",
]
for content in cases:
assert not contains_resource_uri(content)
assert extract_resource_uris(content) == []
def test_sync_memory_resource_refs_keeps_bare_uri_clean_before_chinese_punctuation():
resource_uri = "viking://resources/images/2026/06/12/yueqian_jpeg"
mf = MemoryFile(
content=(
f"昨天晚上我看了 {resource_uri},这张图是越前龙马的照片。"
"以后提到越前龙马照片,可以参考这个资源。"
),
extra_fields={},
)
changed = sync_memory_resource_refs(mf, source="session.commit")
assert changed is True
assert f"]({resource_uri}),这张图是越前龙马的照片。" in mf.content
refs = mf.extra_fields["resource_refs"]
assert refs == [
{
"resource_uri": resource_uri,
"source": "session.commit",
"created_at": refs[0]["created_at"],
"match_text": "昨天晚上我看了",
}
]
@pytest.mark.parametrize(
("content", "expected"),
[
(
"## Notes\n- saved at viking://resources/a\n- other",
"## Notes\n- [saved at](viking://resources/a)\n- other",
),
("# Title viking://resources/a", "# [Title](viking://resources/a)"),
(
"> quote viking://resources/a",
"> [quote](viking://resources/a)",
),
(
"| col | viking://resources/a |",
"| col | viking://resources/a |",
),
(
"| A \\| B viking://resources/a |",
"| [A \\| B](viking://resources/a) |",
),
(
"fallback A | use B viking://resources/a",
"[fallback A | use B](viking://resources/a)",
),
(
"- handoff viking://resources/a(temp_upload 通道)",
"- [handoff](viking://resources/a)(temp_upload 通道)",
),
(
"> 2. [x] handoff viking://resources/a",
"> 2. [x] [handoff](viking://resources/a)",
),
(
"#5 release viking://resources/a",
"[#5 release](viking://resources/a)",
),
(
"-42 release viking://resources/a",
"[-42 release](viking://resources/a)",
),
(
"1. viking://resources/a",
"1. viking://resources/a",
),
(
"- [ ] viking://resources/a",
"- [ ] viking://resources/a",
),
],
)
def test_sync_memory_resource_refs_preserves_markdown_line_structure(content, expected):
mf = MemoryFile(content=content, extra_fields={})
assert sync_memory_resource_refs(mf, source="session.commit")
assert mf.content == expected
assert mf.extra_fields["resource_refs"][0]["resource_uri"] == "viking://resources/a"
def test_unlink_resource_references_preserves_visible_markdown_text():
resource_uri = "viking://resources/images/2026/06/12/yueqian_jpeg"
child_uri = f"{resource_uri}/child.jpeg"
mf = MemoryFile(
content=(f"用户保存了[越前龙马照片]({resource_uri})。\n用户也保存了[子图]({child_uri})。"),
extra_fields={
"resource_refs": [
{"resource_uri": resource_uri, "source": "content.write"},
{"resource_uri": child_uri, "source": "content.write"},
]
},
)
changed = unlink_resource_references_from_memory(mf, resource_uri, recursive=False)
assert changed is True
assert mf.content == f"用户保存了越前龙马照片。\n用户也保存了[子图]({child_uri})。"
assert mf.extra_fields["resource_refs"] == [
{"resource_uri": child_uri, "source": "content.write"}
]
def test_unlink_resource_references_removes_bare_uri_but_keeps_sentence():
resource_uri = "viking://resources/images/2026/06/12/yueqian_jpeg"
mf = MemoryFile(
content=f"用户保存了越前龙马照片 {resource_uri}。",
extra_fields={"resource_refs": [{"resource_uri": resource_uri}]},
)
changed = unlink_resource_references_from_memory(mf, resource_uri)
assert changed is True
assert mf.content == "用户保存了越前龙马照片。"
assert "resource_refs" not in mf.extra_fields