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
"""
Tests for GeminiDenseEmbedder.
Pattern: patch at module import path, use MagicMock, never make real API calls.
"""
from unittest.mock import AsyncMock, MagicMock, patch
import pytest
from openviking.models.model_error import ModelError, ModelErrorKind
def _make_mock_embedding(values):
emb = MagicMock()
emb.values = values
return emb
def _make_mock_result(values_list):
result = MagicMock()
result.embeddings = [_make_mock_embedding(v) for v in values_list]
return result
def test_input_token_limit_constant():
from openviking.models.embedder.gemini_embedders import _GEMINI_INPUT_TOKEN_LIMIT
assert _GEMINI_INPUT_TOKEN_LIMIT == 8192
class TestGeminiDenseEmbedderInit:
def test_requires_api_key(self):
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
with pytest.raises(ValueError, match="api_key"):
GeminiDenseEmbedder("gemini-embedding-2-preview")
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_init_stores_fields(self, mock_client_class):
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
embedder = GeminiDenseEmbedder(
"gemini-embedding-2-preview",
api_key="test-key",
dimension=1536,
task_type="RETRIEVAL_DOCUMENT",
)
assert embedder.model_name == "gemini-embedding-2-preview"
assert embedder.task_type == "RETRIEVAL_DOCUMENT"
assert embedder.get_dimension() == 1536
mock_client_class.assert_called_once()
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_default_dimension_3072(self, mock_client_class):
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
embedder = GeminiDenseEmbedder(api_key="key")
assert embedder.model_name == "gemini-embedding-2"
assert embedder.get_dimension() == 3072
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_dimension_1_valid(self, mock_client_class):
"""API accepts dimension=1 (128 is a quality recommendation, not a hard limit)."""
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
embedder = GeminiDenseEmbedder("gemini-embedding-2-preview", api_key="key", dimension=1)
assert embedder.get_dimension() == 1
def test_default_dimension_classmethod_prefix_rule(self):
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
assert GeminiDenseEmbedder._default_dimension("gemini-embedding-2") == 3072
assert GeminiDenseEmbedder._default_dimension("gemini-embedding-2.1") == 3072
assert GeminiDenseEmbedder._default_dimension("gemini-embedding-3-preview") == 3072
assert GeminiDenseEmbedder._default_dimension("text-embedding-005") == 768
assert (
GeminiDenseEmbedder._default_dimension("text-embedding-004") == 768
) # exact match wins
assert (
GeminiDenseEmbedder._default_dimension("gemini-embedding-2-preview") == 3072
) # exact match
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_token_limit_per_model(self, mock_client_class):
from openviking.models.embedder.gemini_embedders import (
_MODEL_TOKEN_LIMITS,
GeminiDenseEmbedder,
)
for model, expected in _MODEL_TOKEN_LIMITS.items():
e = GeminiDenseEmbedder(model, api_key="key")
assert e._token_limit == expected
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_supports_multimodal_false(self, mock_client_class):
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
embedder = GeminiDenseEmbedder("gemini-embedding-2-preview", api_key="key")
assert embedder.supports_multimodal is False
class TestGeminiDenseEmbedderEmbed:
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_embed_text(self, mock_client_class):
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
mock_client = mock_client_class.return_value
mock_client.models.embed_content.return_value = _make_mock_result([[0.1, 0.2, 0.3]])
embedder = GeminiDenseEmbedder(api_key="key", dimension=3)
result = embedder.embed("hello world")
assert result.dense_vector is not None
assert len(result.dense_vector) == 3
mock_client.models.embed_content.assert_called_once()
_, kwargs = mock_client.models.embed_content.call_args
assert kwargs["model"] == "gemini-embedding-2"
assert kwargs["contents"] == "hello world"
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_preview_embed_passes_task_type_in_config(self, mock_client_class):
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
mock_client = mock_client_class.return_value
mock_client.models.embed_content.return_value = _make_mock_result([[0.1]])
embedder = GeminiDenseEmbedder(
"gemini-embedding-2-preview",
api_key="key",
dimension=1,
task_type="RETRIEVAL_QUERY",
)
embedder.embed("query text", title="Guide")
_, kwargs = mock_client.models.embed_content.call_args
assert kwargs["contents"] == "query text"
assert kwargs["config"].task_type == "RETRIEVAL_QUERY"
assert kwargs["config"].title == "Guide"
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_embed_raises_model_error_on_api_error(self, mock_client_class):
from google.genai.errors import APIError
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
mock_client = mock_client_class.return_value
mock_response = MagicMock()
mock_response.status_code = 401
mock_client.models.embed_content.side_effect = APIError(401, {}, response=mock_response)
embedder = GeminiDenseEmbedder("gemini-embedding-2-preview", api_key="key")
with pytest.raises(ModelError, match="Gemini embedding failed"):
embedder.embed("hello")
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_retry_embedder_retries_transient_429(self, mock_client_class, monkeypatch):
from google.genai.errors import APIError
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
from openviking.models.embedder.retry_embedder import RetryEmbedder
monkeypatch.setattr("openviking.utils.model_retry.time.sleep", lambda _delay: None)
mock_client = mock_client_class.return_value
mock_response = MagicMock()
mock_response.status_code = 429
mock_client.models.embed_content.side_effect = [
APIError(
429,
{"error": {"message": "Rate limit exceeded. Please retry."}},
response=mock_response,
),
_make_mock_result([[0.1, 0.2, 0.3]]),
]
inner = GeminiDenseEmbedder(
"gemini-embedding-2-preview",
api_key="key",
dimension=3,
config={"max_retries": 1},
)
result = RetryEmbedder(inner).embed("hello")
assert result.dense_vector == [0.1, 0.2, 0.3]
assert mock_client.models.embed_content.call_count == 2
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_embed_empty_string_returns_zero_vector(self, mock_client_class):
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
mock_client = mock_client_class.return_value
embedder = GeminiDenseEmbedder("gemini-embedding-2-preview", api_key="key", dimension=3)
for text in ["", " ", "\t\n"]:
result = embedder.embed(text)
assert result.dense_vector == [0.0, 0.0, 0.0]
mock_client.models.embed_content.assert_not_called()
class TestGeminiValidation:
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_all_valid_task_types_accepted(self, mock_client):
from openviking.models.embedder.gemini_embedders import (
_VALID_TASK_TYPES,
GeminiDenseEmbedder,
)
for tt in _VALID_TASK_TYPES:
e = GeminiDenseEmbedder("gemini-embedding-2-preview", api_key="k", task_type=tt)
assert e.task_type == tt
def test_invalid_task_type_raises_on_init(self):
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
with pytest.raises(ValueError, match="Invalid task_type"):
GeminiDenseEmbedder("gemini-embedding-2-preview", api_key="k", task_type="NOT_VALID")
def test_valid_task_types_count(self):
from openviking.models.embedder.gemini_embedders import _VALID_TASK_TYPES
assert len(_VALID_TASK_TYPES) == 8
def test_code_retrieval_query_in_task_types(self):
from openviking.models.embedder.gemini_embedders import _VALID_TASK_TYPES
assert "CODE_RETRIEVAL_QUERY" in _VALID_TASK_TYPES
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_dimension_too_high_raises(self, mock_client):
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
with pytest.raises(ValueError, match="3072"):
GeminiDenseEmbedder("gemini-embedding-2-preview", api_key="k", dimension=4096)
class TestGeminiErrorMessages:
@pytest.mark.parametrize(
"reason,expected_kind",
[
("QUOTA_EXCEEDED", ModelErrorKind.QUOTA_EXHAUSTED),
("RATE_LIMIT_EXCEEDED", ModelErrorKind.RATE_LIMIT_ERROR),
(None, ModelErrorKind.UNKNOWN),
],
)
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_resource_exhausted_uses_structured_reason(self, mock_client, reason, expected_kind):
from google.genai.errors import ClientError
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
mock = mock_client.return_value
error = ClientError(
429,
{"error": {"details": [] if reason is None else [{"reason": reason}]}},
)
mock.models.embed_content.side_effect = error
embedder = GeminiDenseEmbedder("gemini-embedding-2-preview", api_key="k")
with pytest.raises(ModelError, match="Resource exhausted") as raised:
embedder.embed("hello")
assert raised.value.kind is expected_kind
assert raised.value.status_code == 429
assert raised.value.__cause__.__cause__ is error
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_error_message_includes_http_code(self, mock_client):
from google.genai.errors import APIError
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
mock = mock_client.return_value
mock_resp = MagicMock()
mock_resp.status_code = 404
mock.models.embed_content.side_effect = APIError(404, {}, response=mock_resp)
embedder = GeminiDenseEmbedder("gemini-embedding-2-preview", api_key="k")
with pytest.raises(ModelError, match="HTTP 404"):
embedder.embed("hello")
class TestGeminiRequest:
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_embed_per_call_task_type(self, mock_client_class):
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
mock_client = mock_client_class.return_value
mock_client.models.embed_content.return_value = _make_mock_result([[0.1]])
embedder = GeminiDenseEmbedder(api_key="key", dimension=1, task_type="RETRIEVAL_QUERY")
embedder.embed("text", task_type="clustering")
_, kwargs = mock_client.models.embed_content.call_args
assert kwargs["contents"] == "task: clustering | query: text"
assert kwargs["config"].model_dump(exclude_none=True) == {"output_dimensionality": 1}
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
async def test_embed_async_per_call_title(self, mock_client_class):
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
mock_client = mock_client_class.return_value.__enter__.return_value
mock_async = mock_client.aio.__aenter__.return_value
mock_async.models.embed_content = AsyncMock(return_value=_make_mock_result([[0.1]]))
embedder = GeminiDenseEmbedder(api_key="key", dimension=1)
result = await embedder.embed_async("text", title="Doc Title")
kwargs = mock_async.models.embed_content.call_args.kwargs
assert result.dense_vector == [0.1]
assert kwargs["contents"] == "title: Doc Title | text: text"
assert kwargs["config"].model_dump(exclude_none=True) == {"output_dimensionality": 1}
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_repr(self, mock_client_class):
from openviking.models.embedder.gemini_embedders import GeminiDenseEmbedder
embedder = GeminiDenseEmbedder(
"gemini-embedding-2-preview",
api_key="key",
dimension=768,
task_type="RETRIEVAL_DOCUMENT",
)
r = repr(embedder)
assert "GeminiDenseEmbedder(" in r
assert "gemini-embedding-2-preview" in r
assert "768" in r
assert "RETRIEVAL_DOCUMENT" in r
@patch("openviking.models.embedder.gemini_embedders.genai.Client")
def test_client_constructed_with_retry_options(self, mock_client_class):
from openviking.models.embedder.gemini_embedders import (
_HTTP_RETRY_AVAILABLE,
GeminiDenseEmbedder,
)
GeminiDenseEmbedder(api_key="key")
mock_client_class.assert_called_once()
call_kwargs = mock_client_class.call_args[1]
assert call_kwargs.get("api_key") == "key"
if _HTTP_RETRY_AVAILABLE:
assert "http_options" in call_kwargs