feat(memory): add hybrid gateway configuration

app-instance/backend/tests/unit/test_config_loader.py

@@ -1,6 +1,7 @@
 import json
 import asyncio
 
+import pytest
 from fastapi.testclient import TestClient
 
 from beaver.engine import AgentLoop, EngineLoader
@@ -474,3 +475,130 @@ def test_load_config_adds_managed_local_mcp_servers(tmp_path) -> None:
     assert local.managed is True
     assert local.display_name == "个人智能体文件系统工具"
     assert "beaver.interfaces.mcp.tools_server" in local.args
+
+
+def test_missing_memory_config_defaults_to_implicit_hybrid(tmp_path) -> None:
+    config = load_config(config_path=tmp_path / "missing.json")
+
+    assert config.memory.mode == "hybrid"
+    assert config.memory.explicit is False
+    assert config.memory.gateway.scope == ["current_chat", "resources"]
+
+
+def test_load_config_reads_explicit_curated_memory_mode(tmp_path) -> None:
+    config_path = tmp_path / "config.json"
+    config_path.write_text(json.dumps({"memory": {"mode": "curated"}}), encoding="utf-8")
+
+    config = load_config(config_path=config_path)
+
+    assert config.memory.mode == "curated"
+    assert config.memory.explicit is True
+
+
+def test_load_config_reads_explicit_hybrid_gateway_settings(tmp_path) -> None:
+    config_path = tmp_path / "config.json"
+    config_path.write_text(
+        json.dumps(
+            {
+                "memory": {
+                    "mode": "hybrid",
+                    "gateway": {
+                        "baseUrl": "http://127.0.0.1:8010",
+                        "userId": "gateway-user",
+                        "userKey": "uk_secret",
+                        "appId": "beaver",
+                        "projectId": "sandbox",
+                        "scope": ["current_chat", "resources"],
+                        "topK": 5,
+                        "timeoutSeconds": 12.5,
+                    },
+                }
+            }
+        ),
+        encoding="utf-8",
+    )
+
+    config = load_config(config_path=config_path)
+
+    assert config.memory.mode == "hybrid"
+    assert config.memory.explicit is True
+    assert config.memory.gateway.base_url == "http://127.0.0.1:8010"
+    assert config.memory.gateway.user_id == "gateway-user"
+    assert config.memory.gateway.user_key == "uk_secret"
+    assert config.memory.gateway.app_id == "beaver"
+    assert config.memory.gateway.project_id == "sandbox"
+    assert config.memory.gateway.scope == ["current_chat", "resources"]
+    assert config.memory.gateway.top_k == 5
+    assert config.memory.gateway.timeout_seconds == 12.5
+
+
+def test_explicit_hybrid_requires_gateway_credentials_without_leaking_secret(tmp_path) -> None:
+    config_path = tmp_path / "config.json"
+    config_path.write_text(
+        json.dumps(
+            {
+                "memory": {
+                    "mode": "hybrid",
+                    "gateway": {
+                        "baseUrl": "http://127.0.0.1:8010",
+                        "userKey": "uk_super_secret",
+                    },
+                }
+            }
+        ),
+        encoding="utf-8",
+    )
+
+    with pytest.raises(ValueError) as exc_info:
+        load_config(config_path=config_path)
+
+    assert "userId" in str(exc_info.value)
+    assert "uk_super_secret" not in str(exc_info.value)
+
+
+def test_hybrid_memory_rejects_unknown_scope(tmp_path) -> None:
+    config_path = tmp_path / "config.json"
+    config_path.write_text(
+        json.dumps(
+            {
+                "memory": {
+                    "mode": "hybrid",
+                    "gateway": {
+                        "baseUrl": "http://127.0.0.1:8010",
+                        "userId": "gateway-user",
+                        "userKey": "uk_secret",
+                        "scope": ["current_chat", "unknown"],
+                    },
+                }
+            }
+        ),
+        encoding="utf-8",
+    )
+
+    with pytest.raises(ValueError, match="scope"):
+        load_config(config_path=config_path)
+
+
+@pytest.mark.parametrize(
+    ("gateway_override", "expected_error"),
+    [
+        ({"topK": 0}, "topK"),
+        ({"topK": 101}, "topK"),
+        ({"timeoutSeconds": 0}, "timeoutSeconds"),
+    ],
+)
+def test_hybrid_memory_rejects_invalid_limits(tmp_path, gateway_override, expected_error) -> None:
+    config_path = tmp_path / "config.json"
+    gateway = {
+        "baseUrl": "http://127.0.0.1:8010",
+        "userId": "gateway-user",
+        "userKey": "uk_secret",
+        **gateway_override,
+    }
+    config_path.write_text(
+        json.dumps({"memory": {"mode": "hybrid", "gateway": gateway}}),
+        encoding="utf-8",
+    )
+
+    with pytest.raises(ValueError, match=expected_error):
+        load_config(config_path=config_path)