refactor(gateway): 适配器暴露 probe_connection 公开探测——provider_deps 弃私有 _client 反手（CR-M1.4）

packages/llm_gateway/tests/test_openai_adapter.py

@@ -7,6 +7,7 @@ from collections.abc import AsyncIterator
 from types import SimpleNamespace
 from typing import Any, cast
 
+import pytest
 from openai import AsyncOpenAI
 from ww_llm_gateway.adapters.openai_compat import OpenAICompatAdapter, _messages
 from ww_llm_gateway.types import Block, LlmRequest, Scope
@@ -100,3 +101,36 @@ async def test_stream_yields_text_then_final_usage() -> None:
     assert "".join(texts) == "他说"
     assert usage_seen is not None
     assert usage_seen.output_tokens == 2
+
+
+class _FakeModels:
+    def __init__(self, *, error: Exception | None = None) -> None:
+        self._error = error
+        self.calls = 0
+
+    async def list(self) -> Any:
+        self.calls += 1
+        if self._error is not None:
+            raise self._error
+        return SimpleNamespace(data=[])
+
+
+async def test_probe_connection_lists_models() -> None:
+    # CR-M1.4：连通性探测经公开 `probe_connection`（不再让调用方反手私有 `_client`）。
+    models = _FakeModels()
+    client = SimpleNamespace(models=models)
+    adapter = OpenAICompatAdapter("deepseek", cast(AsyncOpenAI, client))
+
+    await adapter.probe_connection()
+
+    assert models.calls == 1
+
+
+async def test_probe_connection_propagates_failure() -> None:
+    # 探测失败原样上抛（调用方据此映射 LLM 不可用）。
+    models = _FakeModels(error=RuntimeError("bad key"))
+    client = SimpleNamespace(models=models)
+    adapter = OpenAICompatAdapter("deepseek", cast(AsyncOpenAI, client))
+
+    with pytest.raises(RuntimeError):
+        await adapter.probe_connection()