Import AITURK IDE 1.0.0-beta.1 from Hermes 63279301; preserve MIT license

tests/hermes_cli/test_runtime_transport_precedence.py

@@ -0,0 +1,98 @@
+"""Runtime transport precedence: declared provider transport is the fallback.
+
+The Coatue data-residency report (2026-07): pointing ``openai-api`` at
+``us.api.openai.com`` silently fell back to ``chat_completions`` — every
+tool-calling turn 400'd — because the runtime resolvers defaulted to
+``chat_completions`` and consulted URL detection only, never the transport
+the provider overlay itself declares.
+
+Contract pinned here: when URL detection has no opinion, the runtime falls
+back to ``providers.determine_api_mode(provider, base_url, model)`` (the
+provider's declared transport), and only lands on ``chat_completions`` for
+genuinely unknown providers/endpoints. Covers the explicit-runtime path and
+the API-key-provider path; the pool-entry path shares the same helper.
+"""
+
+from __future__ import annotations
+
+from unittest.mock import patch as mock_patch
+
+import pytest
+
+from hermes_cli.runtime_provider import _fallback_api_mode
+
+
+class TestFallbackApiMode:
+    @pytest.mark.parametrize(
+        "base_url",
+        [
+            "https://api.openai.com/v1",
+            "https://us.api.openai.com/v1",
+            "https://eu.api.openai.com/v1",
+        ],
+    )
+    def test_openai_api_official_hosts_resolve_codex_responses(self, base_url):
+        assert _fallback_api_mode("openai-api", base_url) == "codex_responses"
+
+    def test_openai_api_unknown_custom_proxy_still_uses_declared_transport(self):
+        # Explicitly selected openai-api against a custom proxy keeps the
+        # provider's declared transport (mirrors determine_api_mode semantics;
+        # host identity is a separate question from provider selection).
+        assert (
+            _fallback_api_mode("openai-api", "https://proxy.corp.test/v1")
+            == "codex_responses"
+        )
+
+    def test_lookalike_host_is_not_treated_as_official(self):
+        # The spoof host must not be detected AS OpenAI by the URL lane —
+        # the provider-declared transport may still apply, but host-derived
+        # detection must return None for it.
+        from hermes_cli.runtime_provider import _detect_api_mode_for_url
+
+        assert _detect_api_mode_for_url("https://api.openai.com.attacker.test/v1") is None
+
+    def test_openrouter_stays_chat_completions(self):
+        assert _fallback_api_mode("openrouter", "https://openrouter.ai/api/v1") == "chat_completions"
+
+    def test_minimax_declared_anthropic_transport_honored(self):
+        # Same latent bug class: minimax declares an Anthropic-compatible
+        # transport but previously fell back to chat_completions when the
+        # URL carried no /anthropic hint.
+        from hermes_cli.providers import determine_api_mode
+
+        expected = determine_api_mode("minimax", "https://api.minimax.io")
+        assert _fallback_api_mode("minimax", "https://api.minimax.io") == expected
+        assert expected != "chat_completions" or expected == determine_api_mode("minimax", "")
+
+    def test_unknown_provider_defaults_chat_completions(self):
+        assert _fallback_api_mode("some-unknown", "https://example.test/v1") == "chat_completions"
+
+    def test_url_detection_wins_over_provider_declaration(self):
+        # /anthropic suffix on any provider routes anthropic_messages —
+        # URL detection stays the higher-priority signal.
+        assert (
+            _fallback_api_mode("openai-api", "https://gateway.test/anthropic")
+            == "anthropic_messages"
+        )
+
+
+class TestExplicitRuntimeIntegration:
+    """The explicit-runtime path resolves regional OpenAI to codex_responses."""
+
+    def test_explicit_openai_api_regional_host(self):
+        from hermes_cli.runtime_provider import _resolve_explicit_runtime
+
+        with mock_patch(
+            "hermes_cli.runtime_provider._get_model_config",
+            return_value={"provider": "openai-api", "default": "gpt-5.6-terra"},
+        ):
+            result = _resolve_explicit_runtime(
+                provider="openai-api",
+                requested_provider="openai-api",
+                explicit_api_key="sk-test",
+                explicit_base_url="https://us.api.openai.com/v1",
+                model_cfg={"provider": "openai-api", "default": "gpt-5.6-terra"},
+            )
+        assert result is not None
+        assert result["api_mode"] == "codex_responses"
+        assert result["base_url"] == "https://us.api.openai.com/v1"