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
"""Options carried with content as it enters downstream processing."""
from __future__ import annotations
from dataclasses import dataclass, replace
from typing import Any, Iterable, Mapping, Optional
from openviking.storage.acl import AclUpdate
from openviking.utils.tags import normalize_search_tags
@dataclass(frozen=True)
class IngestOptions:
"""Small, serializable options shared across processing stages.
This is not limited to resource imports. It may be used by any producer
that submits content into summarization, semantic indexing, or vector
writing pipelines. Do not put request identity, locks, telemetry collectors,
or large source payloads here.
"""
search_tags: Optional[list[str]] = None
search_tag_mode: str = "replace"
acl_update: AclUpdate | None = None
@staticmethod
def vector_search_tag_mode(mode: str) -> str:
"""Map request intent to the modes understood by vector backends."""
return "replace" if mode == "clear" else mode
@classmethod
def from_search_tags(
cls,
tags: Iterable[str] | None,
*,
mode: str = "replace",
) -> "IngestOptions":
if mode == "clear":
return cls(search_tags=[], search_tag_mode="clear")
if tags is None:
return cls()
normalized_tags = normalize_search_tags(tags, discard_invalid=True)
if mode == "replace" and not normalized_tags:
return cls()
return cls(
search_tags=normalized_tags,
search_tag_mode=mode,
)
@classmethod
def from_value(cls, value: "IngestOptions | Mapping[str, Any] | None") -> "IngestOptions":
if value is None:
return cls()
if isinstance(value, IngestOptions):
return replace(
cls.from_search_tags(value.search_tags, mode=value.search_tag_mode),
acl_update=value.acl_update,
)
return replace(
cls.from_search_tags(
value.get("search_tags"),
mode=str(value.get("search_tag_mode", "replace")),
),
acl_update=(
AclUpdate.model_validate(value["acl_update"])
if value.get("acl_update") is not None
else None
),
)
def to_dict(self) -> dict[str, Any]:
return {
"search_tags": list(self.search_tags) if self.search_tags is not None else None,
"search_tag_mode": self.search_tag_mode,
"acl_update": self.acl_update.model_dump(mode="json") if self.acl_update else None,
}