|
| 1 | +"""Tests for memory embedding dimension consistency.""" |
| 2 | +from unittest.mock import MagicMock, patch |
| 3 | +from runtime.node.agent.memory.memory_base import MemoryContentSnapshot, MemoryItem |
| 4 | +from runtime.node.agent.memory.simple_memory import SimpleMemory |
| 5 | + |
| 6 | + |
| 7 | +# --------------------------------------------------------------------------- |
| 8 | +# Helpers |
| 9 | +# --------------------------------------------------------------------------- |
| 10 | + |
| 11 | +def _make_store(memory_path=None): |
| 12 | + """Build a minimal MemoryStoreConfig mock for SimpleMemory.""" |
| 13 | + simple_cfg = MagicMock() |
| 14 | + simple_cfg.memory_path = memory_path |
| 15 | + simple_cfg.embedding = None # We'll set embedding manually |
| 16 | + |
| 17 | + store = MagicMock() |
| 18 | + store.name = "test_store" |
| 19 | + store.as_config.return_value = simple_cfg |
| 20 | + return store |
| 21 | + |
| 22 | + |
| 23 | +def _make_embedding(dim: int): |
| 24 | + """Create a mock EmbeddingBase that produces vectors of the given dimension.""" |
| 25 | + emb = MagicMock() |
| 26 | + emb.get_embedding.return_value = [0.1] * dim |
| 27 | + return emb |
| 28 | + |
| 29 | + |
| 30 | +def _make_memory_item(item_id: str, dim: int): |
| 31 | + """Create a MemoryItem with an embedding of the specified dimension.""" |
| 32 | + return MemoryItem( |
| 33 | + id=item_id, |
| 34 | + content_summary=f"content for {item_id}", |
| 35 | + metadata={}, |
| 36 | + embedding=[float(i) for i in range(dim)], |
| 37 | + ) |
| 38 | + |
| 39 | + |
| 40 | +# --------------------------------------------------------------------------- |
| 41 | +# Tests |
| 42 | +# --------------------------------------------------------------------------- |
| 43 | + |
| 44 | +class TestSimpleMemoryRetrieveMixedDimensions: |
| 45 | + """Task 2.1: verify retrieve() handles mixed-dimension embeddings.""" |
| 46 | + |
| 47 | + def test_mixed_dimensions_does_not_crash(self): |
| 48 | + """Retrieve with mixed-dimensional embeddings MUST not raise.""" |
| 49 | + store = _make_store() |
| 50 | + memory = SimpleMemory(store) |
| 51 | + memory.embedding = _make_embedding(dim=768) |
| 52 | + |
| 53 | + # 3 items with correct dim, 2 with wrong dim |
| 54 | + memory.contents = [ |
| 55 | + _make_memory_item("ok_1", 768), |
| 56 | + _make_memory_item("bad_1", 1536), |
| 57 | + _make_memory_item("ok_2", 768), |
| 58 | + _make_memory_item("bad_2", 256), |
| 59 | + _make_memory_item("ok_3", 768), |
| 60 | + ] |
| 61 | + |
| 62 | + query = MemoryContentSnapshot(text="test query") |
| 63 | + # Should NOT raise ValueError / numpy error |
| 64 | + results = memory.retrieve( |
| 65 | + agent_role="tester", |
| 66 | + query=query, |
| 67 | + top_k=5, |
| 68 | + similarity_threshold=-1.0, |
| 69 | + ) |
| 70 | + # Only the 3 correct-dimension items should be candidates |
| 71 | + assert len(results) <= 3 |
| 72 | + |
| 73 | + def test_all_same_dimension_returns_results(self): |
| 74 | + """When all embeddings share the correct dimension, all are candidates.""" |
| 75 | + store = _make_store() |
| 76 | + memory = SimpleMemory(store) |
| 77 | + memory.embedding = _make_embedding(dim=768) |
| 78 | + |
| 79 | + memory.contents = [ |
| 80 | + _make_memory_item("a", 768), |
| 81 | + _make_memory_item("b", 768), |
| 82 | + ] |
| 83 | + |
| 84 | + query = MemoryContentSnapshot(text="test query") |
| 85 | + results = memory.retrieve( |
| 86 | + agent_role="tester", |
| 87 | + query=query, |
| 88 | + top_k=5, |
| 89 | + similarity_threshold=-1.0, |
| 90 | + ) |
| 91 | + assert len(results) == 2 |
| 92 | + |
| 93 | + def test_all_wrong_dimension_returns_empty(self): |
| 94 | + """When every stored embedding has a wrong dimension, return empty.""" |
| 95 | + store = _make_store() |
| 96 | + memory = SimpleMemory(store) |
| 97 | + memory.embedding = _make_embedding(dim=768) |
| 98 | + |
| 99 | + memory.contents = [ |
| 100 | + _make_memory_item("x", 1536), |
| 101 | + _make_memory_item("y", 1536), |
| 102 | + ] |
| 103 | + |
| 104 | + query = MemoryContentSnapshot(text="test query") |
| 105 | + results = memory.retrieve( |
| 106 | + agent_role="tester", |
| 107 | + query=query, |
| 108 | + top_k=5, |
| 109 | + similarity_threshold=-1.0, |
| 110 | + ) |
| 111 | + assert results == [] |
| 112 | + |
| 113 | + |
| 114 | +class TestOpenAIEmbeddingDynamicFallback: |
| 115 | + """Task 2.2: verify dynamic fallback dimension caching.""" |
| 116 | + |
| 117 | + def test_fallback_uses_model_dimension_after_success(self): |
| 118 | + """After a successful call the fallback dimension MUST match the model.""" |
| 119 | + from runtime.node.agent.memory.embedding import OpenAIEmbedding |
| 120 | + |
| 121 | + cfg = MagicMock() |
| 122 | + cfg.base_url = "http://localhost:11434/v1" |
| 123 | + cfg.api_key = "test" |
| 124 | + cfg.model = "test-model" |
| 125 | + cfg.params = {} |
| 126 | + |
| 127 | + emb = OpenAIEmbedding(cfg) |
| 128 | + assert emb._fallback_dim == 1536 # default before any call |
| 129 | + |
| 130 | + # Simulate a successful 768-dim response |
| 131 | + mock_data = MagicMock() |
| 132 | + mock_data.embedding = [0.1] * 768 |
| 133 | + mock_response = MagicMock() |
| 134 | + mock_response.data = [mock_data] |
| 135 | + |
| 136 | + with patch.object(emb.client.embeddings, "create", return_value=mock_response): |
| 137 | + result = emb.get_embedding("hello world") |
| 138 | + |
| 139 | + assert len(result) == 768 |
| 140 | + assert emb._fallback_dim == 768 # updated after success |
| 141 | + |
| 142 | + def test_fallback_zero_vector_matches_cached_dim(self): |
| 143 | + """After caching dim, fallback zero-vectors MUST use that dim.""" |
| 144 | + from runtime.node.agent.memory.embedding import OpenAIEmbedding |
| 145 | + |
| 146 | + cfg = MagicMock() |
| 147 | + cfg.base_url = "http://localhost:11434/v1" |
| 148 | + cfg.api_key = "test" |
| 149 | + cfg.model = "test-model" |
| 150 | + cfg.params = {} |
| 151 | + |
| 152 | + emb = OpenAIEmbedding(cfg) |
| 153 | + |
| 154 | + # Simulate successful 512-dim call |
| 155 | + mock_data = MagicMock() |
| 156 | + mock_data.embedding = [0.1] * 512 |
| 157 | + mock_response = MagicMock() |
| 158 | + mock_response.data = [mock_data] |
| 159 | + |
| 160 | + with patch.object(emb.client.embeddings, "create", return_value=mock_response): |
| 161 | + emb.get_embedding("first call") |
| 162 | + |
| 163 | + # Now simulate a failure — fallback should be 512-dim |
| 164 | + with patch.object(emb.client.embeddings, "create", side_effect=Exception("API down")): |
| 165 | + fallback = emb.get_embedding("failing call") |
| 166 | + |
| 167 | + assert len(fallback) == 512 |
| 168 | + assert all(v == 0.0 for v in fallback) |
0 commit comments