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
"""Flat XML rendering of assembled context.
Metadata lives in node attributes and the body is the tag content, so the
envelope costs a fraction of what recall v1's nested groups did.
"""
from __future__ import annotations
import re
from typing import Sequence
from openviking.retrieve.context_assembler.models import AssembledEntry
from openviking.utils.token_estimation import estimate_text_tokens
FRAGMENT_SEPARATOR = "\n"
# Both ends of the envelope, case- and whitespace-tolerant: a body that can emit
# an opening <memory ...> tag can forge a sibling entry with its own uri, type
# and score, which is exactly the provenance the envelope exists to carry.
_ENVELOPE_TAG = re.compile(r"<(/?)memory(?=[\s/>])", re.IGNORECASE)
def _attr(value: str) -> str:
return value.replace("&", "&").replace('"', """).replace("<", "<")
def _body(text: str) -> str:
# Protect the envelope without escaping the body wholesale: agents read this
# text as markdown, and escaping would also mangle the viking:// citations.
return _ENVELOPE_TAG.sub(r"<\\\1memory", text)
def render_entry(entry: AssembledEntry) -> str:
head = (
f'<memory uri="{_attr(entry.uri)}" type="{_attr(entry.category)}"'
f' score="{entry.score:.2f}" detail="{entry.detail}"'
)
if not entry.text:
return f"{head} />"
return f"{head}>\n{_body(entry.text)}\n</memory>"
def render_context(entries: Sequence[AssembledEntry]) -> str:
return FRAGMENT_SEPARATOR.join(render_entry(entry) for entry in entries)
def fragment_tokens(entry: AssembledEntry) -> int:
"""Token cost of one rendered fragment, envelope included."""
return estimate_text_tokens(render_entry(entry))