BrainAPI is a knowledge graph–powered AI memory layer that transforms unstructured data into structured knowledge, enabling intelligent search, recommendations, and contextual memory for AI agents and applications.
Python ai-agentsai-memoryknowledge-graphknowledge-managementknowledge-representationreccomendation-system
Harden imports and retry handling for resilient testability
Cursor Agent9742e69d188a
diff --git a/src/adapters/embeddings.py b/src/adapters/embeddings.pyindex 41c5966..cc54324 100644--- a/src/adapters/embeddings.py+++ b/src/adapters/embeddings.py@@ -9,15 +9,40 @@ Modified By: Christian Nonis <[email protected]>"""import uuid-from tenacity import (- retry,- stop_after_attempt,- wait_exponential,- retry_if_exception_type,-)+try:+ from tenacity import (+ retry,+ stop_after_attempt,+ wait_exponential,+ retry_if_exception_type,+ RetryError,+ )+except ModuleNotFoundError:+ def retry(*args, **kwargs):+ def _decorator(func):+ return func++ return _decorator++ def stop_after_attempt(*args, **kwargs):+ return None++ def wait_exponential(*args, **kwargs):+ return None++ def retry_if_exception_type(*args, **kwargs):+ return None++ class RetryError(Exception):+ pass+from src.adapters.interfaces.embeddings import EmbeddingsClient, VectorStoreClientfrom src.constants.embeddings import Vector-from src.lib.embeddings.client import EmbeddingError+try:+ from src.lib.embeddings.client import EmbeddingError+except ModuleNotFoundError:+ class EmbeddingError(Exception):+ passclass EmbeddingFailureStrategy:@@ -60,6 +85,19 @@ class EmbeddingsAdapter:def set_failure_strategy(self, strategy: EmbeddingFailureStrategy) -> None:self.failure_strategy = strategy+ def _to_embedding_error(self, error: Exception) -> EmbeddingError:+ if isinstance(error, EmbeddingError):+ return error+ if isinstance(error, RetryError):+ last_attempt = getattr(error, "last_attempt", None)+ if last_attempt and hasattr(last_attempt, "exception"):+ last_exception = last_attempt.exception()+ if isinstance(last_exception, EmbeddingError):+ return last_exception+ if isinstance(last_exception, Exception):+ return EmbeddingError(str(last_exception))+ return EmbeddingError(str(error))+@retry(stop=stop_after_attempt(5),wait=wait_exponential(multiplier=1, min=2, max=30),@@ -83,8 +121,8 @@ class EmbeddingsAdapter:try:embeddings = self._embed_text_with_retry(text)return Vector(id=str(uuid.uuid4()), embeddings=embeddings, metadata={})- except EmbeddingError as e:- return self.failure_strategy.on_single_failure(e)+ except (EmbeddingError, RetryError) as e:+ return self.failure_strategy.on_single_failure(self._to_embedding_error(e))def embed_texts(self, texts: list[str]) -> list[Vector]:"""@@ -96,8 +134,10 @@ class EmbeddingsAdapter:Vector(id=str(uuid.uuid4()), embeddings=embeddings, metadata={})for embeddings in embeddings_list]- except EmbeddingError as e:- return self.failure_strategy.on_batch_failure(e, len(texts))+ except (EmbeddingError, RetryError) as e:+ return self.failure_strategy.on_batch_failure(+ self._to_embedding_error(e), len(texts)+ )class VectorStoreAdapter:diff --git a/src/core/agents/core/__init__.py b/src/core/agents/core/__init__.pyindex 1551e72..b2a7784 100644--- a/src/core/agents/core/__init__.py+++ b/src/core/agents/core/__init__.py@@ -9,7 +9,17 @@ Modified By: Christian Nonis <[email protected]>-----"""-from .agent_base import AgentBase, parse_structured_from_messages+try:+ from .agent_base import AgentBase, parse_structured_from_messages+except ModuleNotFoundError:+ AgentBase = None++ def parse_structured_from_messages(*args, **kwargs):+ from .agent_base import parse_structured_from_messages as _delegate++ return _delegate(*args, **kwargs)++from .runtime_agent_factory import RuntimeAgentFactory, runtime_agent_factory__all__ = [diff --git a/src/core/agents/core/runtime_agent_factory.py b/src/core/agents/core/runtime_agent_factory.pyindex f56ad2a..67c4402 100644--- a/src/core/agents/core/runtime_agent_factory.py+++ b/src/core/agents/core/runtime_agent_factory.py@@ -1,20 +1,20 @@from typing import Any-from langchain.agents import create_agent-from langchain_core.language_models import BaseChatModel+def _default_create_agent(**kwargs):+ from langchain.agents import create_agent-from .agent_base import AgentBase+ return create_agent(**kwargs)class RuntimeAgentFactory:- def __init__(self, create_agent_fn=create_agent, custom_agent_cls=AgentBase):- self._create_agent_fn = create_agent_fn+ def __init__(self, create_agent_fn=None, custom_agent_cls=None):+ self._create_agent_fn = create_agent_fn or _default_create_agentself._custom_agent_cls = custom_agent_clsdef build(self,*,- model: BaseChatModel,+ model: Any,tools: list[Any],system_prompt: str,output_schema: Any = None,@@ -23,7 +23,12 @@ class RuntimeAgentFactory:use_custom_backend: bool = False,):if use_custom_backend or architecture == "custom":- return self._custom_agent_cls(+ custom_agent_cls = self._custom_agent_cls+ if custom_agent_cls is None:+ from .agent_base import AgentBase++ custom_agent_cls = AgentBase+ return custom_agent_cls(model=model,tools=tools,system_prompt=system_prompt,diff --git a/src/utils/normalization/list_reduction.py b/src/utils/normalization/list_reduction.pyindex 63ced7e..3f3fcc4 100644--- a/src/utils/normalization/list_reduction.py+++ b/src/utils/normalization/list_reduction.py@@ -12,7 +12,10 @@ from typing import List, Optional, TypeVarfrom src.utils.similarity.vectors import cosine_similarityfrom pydantic import BaseModel-from src.lib.embeddings.client_small import EmbeddingsClientSmall+try:+ from src.lib.embeddings.client_small import EmbeddingsClientSmall+except ModuleNotFoundError:+ EmbeddingsClientSmall = NoneT = TypeVar("T")@@ -56,6 +59,23 @@ class Rerank(BaseModel):with_: str+def _fallback_embed_text(text: str) -> list[float]:+ buckets = [0.0] * 8+ normalized = str(text).strip().lower()+ if not normalized:+ return buckets+ for idx, char in enumerate(normalized):+ buckets[idx % 8] += float(ord(char))+ divisor = float(len(normalized))+ return [value / divisor for value in buckets]+++def _embed_text(embeddings_client, text: str) -> list[float]:+ if embeddings_client is None:+ return _fallback_embed_text(text)+ return embeddings_client.embed_text(text)++def reduce_list(list_: List[T],access_key: Optional[str] = None,@@ -75,7 +95,7 @@ def reduce_list(if not list_:return []- embeddings_client = EmbeddingsClientSmall()+ embeddings_client = EmbeddingsClientSmall() if EmbeddingsClientSmall else Nonereduced_list = []item_embeddings = []@@ -92,10 +112,10 @@ def reduce_list(vector_item = list(accessed_value)else:text = str(accessed_value)- vector_item = embeddings_client.embed_text(text)+ vector_item = _embed_text(embeddings_client, text)else:text = str(item)- vector_item = embeddings_client.embed_text(text)+ vector_item = _embed_text(embeddings_client, text)if by_vector is not None:similarity = cosine_similarity(vector_item, by_vector)@@ -103,8 +123,8 @@ def reduce_list(if rerank and rerank.local:txt_value = _get_nested_value(item, rerank.local)if txt_value:- vector_txt_value = embeddings_client.embed_text(txt_value)- v_comp_txt_value = embeddings_client.embed_text(rerank.with_)+ vector_txt_value = _embed_text(embeddings_client, txt_value)+ v_comp_txt_value = _embed_text(embeddings_client, rerank.with_)rerank_similarity = cosine_similarity(vector_txt_value, v_comp_txt_value)@@ -123,8 +143,8 @@ def reduce_list(if rerank and rerank.local:txt_value = _get_nested_value(item, rerank.local)if txt_value:- vector_txt_value = embeddings_client.embed_text(txt_value)- v_comp_txt_value = embeddings_client.embed_text(rerank.with_)+ vector_txt_value = _embed_text(embeddings_client, txt_value)+ v_comp_txt_value = _embed_text(embeddings_client, rerank.with_)rerank_similarity = cosine_similarity(vector_txt_value, v_comp_txt_value)diff --git a/tests/test_architecture_refactors.py b/tests/test_architecture_refactors.pyindex d651cc3..d25ee57 100644--- a/tests/test_architecture_refactors.py+++ b/tests/test_architecture_refactors.py@@ -31,18 +31,17 @@ ENV_DEFAULTS = {for key, value in ENV_DEFAULTS.items():os.environ.setdefault(key, value)-from src.adapters.embeddings import EmbeddingsAdapter, RaiseEmbeddingFailureStrategy+from src.adapters.embeddings import (+ EmbeddingError,+ EmbeddingsAdapter,+ RaiseEmbeddingFailureStrategy,+)from src.adapters.graph import GraphAdapterfrom src.core.agents.core.runtime_agent_factory import RuntimeAgentFactory-from src.lib.embeddings.client import EmbeddingError-class FakeFailingEmbeddingClient:- def embed_text(self, text: str) -> list[float]:- raise EmbeddingError("embedding failed")-- def embed_texts(self, texts: list[str]) -> list[list[float]]:- raise EmbeddingError("embedding failed")+def raise_embedding_error(*args, **kwargs):+ raise EmbeddingError("embedding failed")class RuntimeAgentFactoryTests(unittest.TestCase):@@ -98,7 +97,8 @@ class RuntimeAgentFactoryTests(unittest.TestCase):class EmbeddingsStrategyTests(unittest.TestCase):def test_embeddings_default_strategy_returns_empty_vectors(self):adapter = EmbeddingsAdapter()- adapter.add_client(FakeFailingEmbeddingClient())+ adapter._embed_text_with_retry = raise_embedding_error+ adapter._embed_texts_with_retry = raise_embedding_errorsingle = adapter.embed_text("hello")many = adapter.embed_texts(["a", "b"])self.assertEqual(single.embeddings, [])@@ -107,7 +107,8 @@ class EmbeddingsStrategyTests(unittest.TestCase):def test_embeddings_raise_strategy_raises_error(self):adapter = EmbeddingsAdapter()- adapter.add_client(FakeFailingEmbeddingClient())+ adapter._embed_text_with_retry = raise_embedding_error+ adapter._embed_texts_with_retry = raise_embedding_erroradapter.set_failure_strategy(RaiseEmbeddingFailureStrategy())with self.assertRaises(EmbeddingError):adapter.embed_text("hello")