Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

2.7 KB
Raw Blame
# Copyright (c) 2026 Beijing Volcano Engine Technology Co., Ltd.
# SPDX-License-Identifier: AGPL-3.0
import time
from typing import Optional

from openviking_cli.utils.logger import get_logger

from .embedding_msg import EmbeddingMsg
from .named_queue import NamedQueue

logger = get_logger(__name__)


class EmbeddingQueue(NamedQueue):
    """EmbeddingQueue: Named queue specifically for processing EmbeddingMsg.

    Supports direct enqueue and dequeue of EmbeddingMsg objects.
    """

    async def enqueue(self, msg: Optional[EmbeddingMsg]) -> str:
        """Serialize EmbeddingMsg object and store in queue."""
        if msg is None:
            logger.warning("Embedding message is None, skipping enqueuing")
            return ""
        msg.queue_enqueued_at = time.time()
        logger.debug("Enqueued embedding message: uri=%s", msg.context_data.get("uri", ""))
        return await super().enqueue(msg.to_dict())

    async def dequeue(self) -> Optional[EmbeddingMsg]:
        """Get message from queue and deserialize to EmbeddingMsg object."""
        data_dict = await super().dequeue()
        if not data_dict:
            return None
        if "data" in data_dict:
            if isinstance(data_dict["data"], str):
                try:
                    return EmbeddingMsg.from_json(data_dict["data"])
                except Exception as e:
                    logger.debug(f"[EmbeddingQueue] Failed to parse message data: {e}")
                    return None
            elif isinstance(data_dict["data"], dict):
                try:
                    return EmbeddingMsg.from_dict(data_dict["data"])
                except Exception as e:
                    logger.debug(
                        f"[EmbeddingQueue] Failed to create EmbeddingMsg from data dict: {e}"
                    )
                    return None

        # Otherwise try to convert directly from dict
        try:
            return EmbeddingMsg.from_dict(data_dict)
        except Exception:
            return None

    async def peek(self) -> Optional[EmbeddingMsg]:
        """Peek at head message in queue."""
        data_dict = await super().peek()
        if not data_dict:
            return None

        if "data" in data_dict:
            if isinstance(data_dict["data"], str):
                try:
                    return EmbeddingMsg.from_json(data_dict["data"])
                except Exception:
                    return None
            elif isinstance(data_dict["data"], dict):
                try:
                    return EmbeddingMsg.from_dict(data_dict["data"])
                except Exception:
                    return None

        try:
            return EmbeddingMsg.from_dict(data_dict)
        except Exception:
            return None