Skip to content

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

4.5 KB
Raw Blame
# Copyright (c) 2026 Beijing Volcano Engine Technology Co., Ltd.
# SPDX-License-Identifier: AGPL-3.0
"""Unit tests for Gemini-specific EmbeddingModelConfig and EmbeddingConfig behavior."""

from unittest.mock import MagicMock, patch

import pytest

from openviking_cli.utils.config.embedding_config import EmbeddingConfig, EmbeddingModelConfig


def _gcfg(**kw) -> EmbeddingModelConfig:
    """Helper: build a Gemini EmbeddingModelConfig with defaults."""
    return EmbeddingModelConfig(
        model="gemini-embedding-2", provider="gemini", api_key="test-key", **kw
    )


class TestGeminiDimension:
    def test_stable_defaults_3072(self):
        assert _gcfg().get_effective_dimension() == 3072

    def test_001_defaults_3072(self):
        cfg = EmbeddingModelConfig(model="gemini-embedding-001", provider="gemini", api_key="k")
        assert cfg.get_effective_dimension() == 3072

    def test_004_defaults_768(self):
        cfg = EmbeddingModelConfig(model="text-embedding-004", provider="gemini", api_key="k")
        assert cfg.get_effective_dimension() == 768

    def test_unknown_model_defaults_3072(self):
        cfg = EmbeddingModelConfig(model="gemini-embedding-future", provider="gemini", api_key="k")
        assert cfg.get_effective_dimension() == 3072

    def test_explicit_dimension_overrides_default(self):
        assert _gcfg(dimension=1536).get_effective_dimension() == 1536

    def test_text_embedding_prefix_defaults_768(self):
        """text-embedding-* future models default to 768 via prefix rule."""
        cfg = EmbeddingModelConfig(model="text-embedding-005", provider="gemini", api_key="k")
        assert cfg.get_effective_dimension() == 768

    def test_future_gemini_model_defaults_3072(self):
        """Future gemini-embedding-* models default to 3072 via fallback."""
        for model in ["gemini-embedding-2", "gemini-embedding-2.1", "gemini-embedding-3-preview"]:
            cfg = EmbeddingModelConfig(model=model, provider="gemini", api_key="k")
            assert cfg.get_effective_dimension() == 3072


class TestGeminiContextRouting:
    @patch("openviking.models.embedder.gemini_embedders.genai.Client")
    def test_nonsymmetric_routes_query_and_document(self, mock_client):
        cfg = EmbeddingConfig(
            dense=_gcfg(query_param="RETRIEVAL_QUERY", document_param="RETRIEVAL_DOCUMENT")
        )
        embedder = cfg.get_embedder()
        request = mock_client.return_value.models.embed_content
        request.return_value = MagicMock(embeddings=[MagicMock(values=[0.1])])
        embedder.embed("text")
        embedder.embed("text", is_query=True)
        assert [call.kwargs["contents"] for call in request.call_args_list] == [
            "title: none | text: text",
            "task: search result | query: text",
        ]
        assert request.call_args.kwargs["config"].task_type is None

    @patch("openviking.models.embedder.gemini_embedders.genai.Client")
    def test_only_query_param_set(self, _mock):
        """When only query_param is set, document_param is None."""
        cfg = EmbeddingConfig(dense=_gcfg(query_param="RETRIEVAL_QUERY"))
        embedder = cfg.get_embedder()
        assert embedder.query_param == "retrieval_query"
        assert embedder.document_param is None


def test_factory_raises_clear_error_when_google_genai_not_installed():
    cfg = _gcfg()

    with patch("openviking.models.embedder.GeminiDenseEmbedder", None):
        with pytest.raises(ValueError) as excinfo:
            EmbeddingConfig(dense=cfg).get_embedder()

    message = str(excinfo.value)
    assert "google-genai" in message
    assert "pip install openviking[gemini]" in message
    assert "NoneType" not in message


class TestGeminiConfigValidation:
    def test_missing_api_key_raises(self):
        with pytest.raises(ValueError, match="api_key"):
            EmbeddingModelConfig(model="gemini-embedding-2", provider="gemini")

    def test_invalid_query_param_raises(self):
        with pytest.raises(ValueError, match="invalid query_param"):
            _gcfg(query_param="NOT_A_VALID_TYPE")

    def test_invalid_document_param_raises(self):
        with pytest.raises(ValueError, match="invalid document_param"):
            _gcfg(document_param="ALSO_INVALID")

    def test_query_document_param_case_normalized(self):
        """query_param/document_param are lowercased by the generic normalizer."""
        cfg = _gcfg(query_param="RETRIEVAL_QUERY", document_param="RETRIEVAL_DOCUMENT")
        assert cfg.query_param == "retrieval_query"
        assert cfg.document_param == "retrieval_document"