JiuwenSwarm is an intelligent AI Agent built on openJiuwen. It extends the powerful capabilities of large language models directly to your fingertips through various communication apps you use daily.
Python
import copy
from types import SimpleNamespace
import pytest
from jiuwenswarm.agents.harness.common.rails.model_routing import capability as capability_module
from jiuwenswarm.common.schema.agent import AgentRequest
from jiuwenswarm.common.model_identity import build_model_identity_reference
from jiuwenswarm.server.runtime.agent_adapter import interface_deep
from jiuwenswarm.server.runtime.agent_adapter.interface_deep import JiuWenSwarmDeepAdapter
def _adapter(*models):
adapter = object.__new__(JiuWenSwarmDeepAdapter)
adapter._model = models[0] if models else None
adapter._model_cache = {
f"{model.model_config.model_name}#{i}": model for i, model in enumerate(models)
}
adapter._model_name_to_keys = {}
for i, model in enumerate(models):
adapter._model_name_to_keys.setdefault(model.model_config.model_name, []).append(
f"{model.model_config.model_name}#{i}"
)
adapter._model_identity_to_keys = {}
for i, model in enumerate(models):
config = model.model_client_config
ref = build_model_identity_reference(model.model_config.model_name, vars(config))
adapter._model_identity_to_keys.setdefault(ref, []).append(f"glm-5.3#{i}")
return adapter
def _model(base, name="glm-5.3"):
return SimpleNamespace(
model_client_config=SimpleNamespace(api_base=base, client_provider="OpenAI"),
model_config=SimpleNamespace(model_name=name),
)
def _request(**params):
return AgentRequest(request_id="r1", params=params)
def test_single_request_resolves_same_name_by_identity():
first, second = _model("https://one.example"), _model("https://two.example")
adapter = _adapter(first, second)
ref = build_model_identity_reference("glm-5.3", vars(second.model_client_config))
assert adapter._resolve_model_for_request(_request(model_name="glm-5.3", model_ref=ref)) is second
def test_missing_owner_reference_fails_closed():
adapter = _adapter(_model("https://one.example"))
with pytest.raises(ValueError, match="not found"):
adapter._resolve_model_for_request(_request(model_name="glm-5.3", model_ref="model-identity-v1:" + "0" * 64))
def test_malformed_reference_fails_closed():
adapter = _adapter(_model("https://one.example"))
with pytest.raises(ValueError, match="invalid"):
adapter._resolve_model_for_request(_request(model_name="glm-5.3", model_ref="bad-ref"))
def test_ambiguous_reference_fails_closed():
model = _model("https://one.example")
adapter = _adapter(model, model)
ref = build_model_identity_reference("glm-5.3", vars(model.model_client_config))
with pytest.raises(ValueError, match="ambiguous"):
adapter._resolve_model_for_request(_request(model_name="glm-5.3", model_ref=ref))
def test_name_mismatch_fails_closed():
adapter = _adapter(_model("https://one.example"))
ref = build_model_identity_reference("glm-5.3", vars(adapter._model.model_client_config))
with pytest.raises(ValueError, match="does not match"):
adapter._resolve_model_for_request(_request(model_name="other-model", model_ref=ref))
def test_without_model_ref_preserves_name_lookup():
first = _model("https://one.example")
second = _model("https://two.example", name="qwen3-32b")
adapter = _adapter(first, second)
assert adapter._resolve_model_for_request(_request(model_name="glm-5.3")) is first
def test_name_only_resolution_fails_closed_for_duplicate_model_names():
adapter = _adapter(_model("https://one.example"), _model("https://two.example"))
with pytest.raises(ValueError, match="ambiguous"):
adapter._resolve_model_for_request(_request(model_name="glm-5.3"))
def test_subagent_name_only_resolution_fails_closed_for_duplicate_model_names():
adapter = _adapter(_model("https://one.example"), _model("https://two.example"))
with pytest.raises(ValueError, match="ambiguous"):
adapter._resolve_model(model_name="glm-5.3")
def test_legacy_cache_build_populates_identity_index(monkeypatch):
model = _model("https://legacy.example")
adapter = object.__new__(JiuWenSwarmDeepAdapter)
adapter._model_cache = {}
adapter._model_identity_to_keys = {}
capability_kwargs: dict = {}
def _build(mcc, mco, **kwargs):
capability_kwargs.update(kwargs)
return model
# builder 已从类方法提升到 deep.model_factory,interface_deep 命名空间持有该符号
monkeypatch.setattr(interface_deep, "_build_model_from_entry", _build)
adapter._build_model_cache_legacy(
{
"models": {
"default": {
"model_client_config": {
"api_base": "https://legacy.example",
"model_name": "glm-5.3",
"client_provider": "OpenAI",
},
"model_config_obj": {},
# legacy 段也必须把图片能力声明透传给 Model,否则回退路径丢能力
"modalities": ["text"],
}
}
}
)
assert capability_kwargs == {"modalities": ["text"]}
ref = build_model_identity_reference(
"glm-5.3",
{
"api_base": "https://legacy.example",
"model_name": "glm-5.3",
"client_provider": "OpenAI",
},
)
assert adapter._resolve_model_for_request(_request(model_name="glm-5.3", model_ref=ref)) is model
def _registry_adapter():
"""仅装配注册所需状态;_build_model_from_entry 用桩,避免真实凭证/网络依赖。"""
adapter = object.__new__(JiuWenSwarmDeepAdapter)
adapter._model = None
adapter._model_cache, adapter._model_name_to_keys = {}, {}
adapter._model_identity_to_keys, adapter._model_identity_owners = {}, {}
adapter._model_entry_by_ref = {}
adapter._tier_model_cache = {}
interface_deep._build_model_from_entry = lambda mcc, mco, *args, **kwargs: SimpleNamespace(
model_client_config=SimpleNamespace(
api_key=mcc.get("api_key"),
custom_headers=dict(mcc.get("custom_headers") or {}),
)
)
return adapter
def _entry(api_key, *, api_base="https://maas.example/v1", provider="OpenAI", headers=None):
return {
"model_client_config": {
"model_name": "glm-5.2",
"api_base": api_base,
"client_provider": provider,
"api_key": api_key,
"custom_headers": headers or {},
},
"model_config_obj": {},
}
def _ref(entry):
mcc = entry["model_client_config"]
return build_model_identity_reference(mcc["model_name"], mcc)
def _register(adapter, entries):
counter = {}
for entry in entries:
adapter._register_model_cache_entry(copy.deepcopy(entry), counter)
def test_registry_reuses_cache_key_for_equivalent_owner():
adapter, entry = _registry_adapter(), _entry("sk-A")
_register(adapter, [entry, entry])
assert adapter._model_identity_to_keys[_ref(entry)] == ["glm-5.2#0"]
assert adapter._model_name_to_keys["glm-5.2"] == ["glm-5.2#0"]
assert adapter._resolve_model_by_name("glm-5.2") is adapter._model_cache["glm-5.2#0"]
@pytest.mark.parametrize(
"first,second",
[
(_entry("sk-A"), _entry("sk-B")), # 不同 api_key
(
_entry("sk-A", headers={"Authorization": "Basic one"}),
_entry("sk-A", headers={"Authorization": "Basic two"}),
), # 不同 headers
],
)
def test_registry_keeps_ambiguous_for_different_credentials(first, second):
adapter = _registry_adapter()
_register(adapter, [first, second])
assert len(adapter._model_identity_to_keys[_ref(first)]) == 2
with pytest.raises(ValueError, match="ambiguous"):
adapter._resolve_model_by_identity(_ref(first))
def test_same_model_name_different_provider_keeps_both_owners():
adapter = _registry_adapter()
first, second = _entry("sk-A"), _entry("sk-A", provider="Anthropic")
_register(adapter, [first, second])
assert _ref(first) != _ref(second)
assert adapter._resolve_model_by_identity(_ref(first)) is adapter._model_cache["glm-5.2#0"]
assert adapter._resolve_model_by_identity(_ref(second)) is adapter._model_cache["glm-5.2#1"]
# 同名多 owner:名称查询歧义,调用方须改用 model_ref
with pytest.raises(ValueError, match="ambiguous"):
adapter._resolve_model_by_name("glm-5.2")
def _build_from_defaults(monkeypatch, config_entry, json_entry):
monkeypatch.setattr(capability_module, "_load_models_json", lambda: {"defaults": [json_entry]})
adapter = _registry_adapter()
adapter._build_model_cache_from_defaults({"models": {"defaults": [config_entry]}})
return adapter
def test_same_id_across_sources_equivalent_owner_registers_once(monkeypatch):
entry = _entry("sk-A")
adapter = _build_from_defaults(monkeypatch, copy.deepcopy(entry), copy.deepcopy(entry))
assert adapter._model_identity_to_keys[_ref(entry)] == ["glm-5.2#0"]
assert adapter._resolve_model_by_name("glm-5.2") is adapter._model_cache["glm-5.2#0"]
def test_same_id_across_sources_distinct_endpoint_keeps_both_owners(monkeypatch):
cfg = _entry("sk-volcano", api_base="https://volcano.example/v1")
js = _entry("sk-maas")
adapter = _build_from_defaults(monkeypatch, copy.deepcopy(cfg), copy.deepcopy(js))
# models.json 独有的 owner 不再被「同名跳过」丢掉,各自 model_ref 均可解析
assert _ref(cfg) != _ref(js)
assert adapter._resolve_model_by_identity(_ref(cfg)) is adapter._model_cache["glm-5.2#0"]
assert adapter._resolve_model_by_identity(_ref(js)) is adapter._model_cache["glm-5.2#1"]