Teknium
624723130b
First actioned report from the overhauled model-catalog-scout cron (2026-08-21 validation run), every item re-verified live before edit: Delisted (gone from live catalogs): - opencode-zen curated: claude-opus-4-1, qwen3.7-max, qwen3.7-plus (absent from live zen /v1/models; qwen3.7 family remains on Go) - OPENROUTER_MODELS free section: poolside/laguna-m.1:free (rotated to s-2.1/xs-2.1), tencent/hy3:free, inclusionai/ring-2.6-1t:free Added (present + verified in live catalogs): - OpenRouter free: z-ai/glm-5.2:free (256K), poolside/laguna-s-2.1:free + laguna-xs-2.1:free (262K), nvidia/nemotron-3.5-lightning:free (1M) - opencode-go curated: ox-alpha-free (Go-subscription twin of the Zen keyless Ox Alpha; keyed — Go relay 401s anonymous requests) Metadata: - DEFAULT_CONTEXT_LENGTHS: laguna-s-2.1/xs-2.1 262144; nemotron-3.5-lightning 1M (overrides the generic 131K nemotron entry); glm-5.2:free 256K (the free variant is capped below the 1M paid entry) Keyless-heal hardening (the real find): - opencode_zen_free_runtime now gates the zen/go→keyless heal on MEMBERSHIP in the verified opencode-free catalog, not the -free suffix — ox-alpha-free is a KEYED Go model despite its suffix, and suffix-based healing would have routed it to a Zen relay that doesn't serve it (verified: zen 401s 'not supported', go 401s 'Missing API key'). New regression test pins this. Fixture sweep: tencent/hy3:free catalog assertion updated (delisted slug); nous-route fixtures using hy3:free as incidental model names left alone (self-consistent mocks). model-catalog.json regenerated.
362 lines
13 KiB
Python
362 lines
13 KiB
Python
"""Tests for Tencent TokenHub provider support (Hy3 Preview)."""
|
|
|
|
import json
|
|
import os
|
|
|
|
import pytest
|
|
|
|
from hermes_cli.auth import (
|
|
PROVIDER_REGISTRY,
|
|
resolve_provider,
|
|
get_api_key_provider_status,
|
|
resolve_api_key_provider_credentials,
|
|
)
|
|
|
|
|
|
# Other provider env vars to clear during auto-detection tests
|
|
_OTHER_PROVIDER_KEYS = (
|
|
"OPENAI_API_KEY", "ANTHROPIC_API_KEY", "DEEPSEEK_API_KEY",
|
|
"GOOGLE_API_KEY", "GEMINI_API_KEY", "DASHSCOPE_API_KEY",
|
|
"XAI_API_KEY", "KIMI_API_KEY", "KIMI_CN_API_KEY",
|
|
"MINIMAX_API_KEY", "MINIMAX_CN_API_KEY", "AI_GATEWAY_API_KEY",
|
|
"KILOCODE_API_KEY", "HF_TOKEN", "GLM_API_KEY", "ZAI_API_KEY",
|
|
"XIAOMI_API_KEY", "OPENROUTER_API_KEY", "COPILOT_GITHUB_TOKEN",
|
|
"GH_TOKEN", "GITHUB_TOKEN", "ARCEEAI_API_KEY",
|
|
)
|
|
|
|
|
|
# =============================================================================
|
|
# Provider Registry
|
|
# =============================================================================
|
|
|
|
|
|
class TestTencentTokenhubProviderRegistry:
|
|
"""Verify tencent-tokenhub is registered correctly in the PROVIDER_REGISTRY."""
|
|
|
|
def test_registered(self):
|
|
assert "tencent-tokenhub" in PROVIDER_REGISTRY
|
|
|
|
|
|
def test_inference_base_url(self):
|
|
assert PROVIDER_REGISTRY["tencent-tokenhub"].inference_base_url == "https://tokenhub.tencentmaas.com/v1"
|
|
|
|
|
|
# =============================================================================
|
|
# Aliases
|
|
# =============================================================================
|
|
|
|
|
|
class TestTencentTokenhubAliases:
|
|
"""All aliases should resolve to 'tencent-tokenhub'."""
|
|
|
|
@pytest.mark.parametrize("alias", [
|
|
"tencent-tokenhub", "tencent", "tokenhub", "tencent-cloud", "tencentmaas",
|
|
])
|
|
def test_alias_resolves(self, alias, monkeypatch):
|
|
for key in _OTHER_PROVIDER_KEYS:
|
|
monkeypatch.delenv(key, raising=False)
|
|
monkeypatch.setenv("TOKENHUB_API_KEY", "sk-test-key-12345678")
|
|
assert resolve_provider(alias) == "tencent-tokenhub"
|
|
|
|
def test_normalize_provider_models_py(self):
|
|
from hermes_cli.models import normalize_provider
|
|
assert normalize_provider("tencent") == "tencent-tokenhub"
|
|
assert normalize_provider("tokenhub") == "tencent-tokenhub"
|
|
assert normalize_provider("tencent-cloud") == "tencent-tokenhub"
|
|
assert normalize_provider("tencentmaas") == "tencent-tokenhub"
|
|
|
|
def test_normalize_provider_providers_py(self):
|
|
from hermes_cli.providers import normalize_provider
|
|
assert normalize_provider("tencent") == "tencent-tokenhub"
|
|
assert normalize_provider("tokenhub") == "tencent-tokenhub"
|
|
assert normalize_provider("tencent-cloud") == "tencent-tokenhub"
|
|
assert normalize_provider("tencentmaas") == "tencent-tokenhub"
|
|
|
|
|
|
# =============================================================================
|
|
# Auto-detection
|
|
# =============================================================================
|
|
|
|
|
|
|
|
|
|
# =============================================================================
|
|
# Credentials
|
|
# =============================================================================
|
|
|
|
|
|
class TestTencentTokenhubCredentials:
|
|
"""Test credential resolution for the tencent-tokenhub provider."""
|
|
|
|
|
|
|
|
def test_resolve_credentials(self, monkeypatch):
|
|
monkeypatch.setenv("TOKENHUB_API_KEY", "sk-test-12345678")
|
|
monkeypatch.delenv("TOKENHUB_BASE_URL", raising=False)
|
|
creds = resolve_api_key_provider_credentials("tencent-tokenhub")
|
|
assert creds["api_key"] == "sk-test-12345678"
|
|
assert creds["base_url"] == "https://tokenhub.tencentmaas.com/v1"
|
|
|
|
def test_openrouter_key_does_not_make_tokenhub_configured(self, monkeypatch):
|
|
"""OpenRouter users should NOT see tencent-tokenhub as configured."""
|
|
monkeypatch.delenv("TOKENHUB_API_KEY", raising=False)
|
|
monkeypatch.setenv("OPENROUTER_API_KEY", "sk-or-test")
|
|
status = get_api_key_provider_status("tencent-tokenhub")
|
|
assert not status["configured"]
|
|
|
|
|
|
|
|
# =============================================================================
|
|
# Model catalog
|
|
# =============================================================================
|
|
|
|
|
|
class TestTencentTokenhubModelCatalog:
|
|
"""Tencent TokenHub static model list."""
|
|
|
|
def test_static_model_list_exists(self):
|
|
from hermes_cli.models import _PROVIDER_MODELS
|
|
assert "tencent-tokenhub" in _PROVIDER_MODELS
|
|
assert len(_PROVIDER_MODELS["tencent-tokenhub"]) >= 1
|
|
|
|
|
|
def test_default_model(self):
|
|
from hermes_cli.models import get_default_model_for_provider
|
|
assert get_default_model_for_provider("tencent-tokenhub") == "hy3-preview"
|
|
|
|
|
|
# =============================================================================
|
|
# CANONICAL_PROVIDERS (hermes model picker)
|
|
# =============================================================================
|
|
|
|
|
|
class TestTencentTokenhubCanonicalProvider:
|
|
"""Tencent TokenHub appears in the interactive model picker."""
|
|
|
|
|
|
def test_description_contains_hy3(self):
|
|
from hermes_cli.models import CANONICAL_PROVIDERS
|
|
entry = next(p for p in CANONICAL_PROVIDERS if p.slug == "tencent-tokenhub")
|
|
assert "Hy3 Preview" in entry.tui_desc
|
|
|
|
|
|
# =============================================================================
|
|
# OpenRouter / Nous Portal curated lists
|
|
# =============================================================================
|
|
|
|
|
|
|
|
|
|
# =============================================================================
|
|
# Model normalization
|
|
# =============================================================================
|
|
|
|
|
|
class TestTencentTokenhubNormalization:
|
|
"""Model name normalization — Tencent TokenHub is a direct provider
|
|
not in _MATCHING_PREFIX_STRIP_PROVIDERS, so names pass through as-is.
|
|
"""
|
|
|
|
|
|
def test_not_in_matching_prefix_strip_set(self):
|
|
"""tencent-tokenhub does NOT need prefix stripping — it only has
|
|
one model (hy3-preview) and users won't copy vendor/ form."""
|
|
from hermes_cli.model_normalize import _MATCHING_PREFIX_STRIP_PROVIDERS
|
|
assert "tencent-tokenhub" not in _MATCHING_PREFIX_STRIP_PROVIDERS
|
|
|
|
def test_not_in_lowercase_providers(self):
|
|
"""tencent-tokenhub does not require lowercase normalization."""
|
|
from hermes_cli.model_normalize import _LOWERCASE_MODEL_PROVIDERS
|
|
assert "tencent-tokenhub" not in _LOWERCASE_MODEL_PROVIDERS
|
|
|
|
@pytest.mark.parametrize("empty_input", ["", None, " "])
|
|
def test_normalize_empty_and_none(self, empty_input):
|
|
"""None, empty, and whitespace-only inputs return empty string."""
|
|
from hermes_cli.model_normalize import normalize_model_for_provider
|
|
result = normalize_model_for_provider(empty_input, "tencent-tokenhub")
|
|
assert result == "" or result.strip() == ""
|
|
|
|
|
|
# =============================================================================
|
|
# Provider label
|
|
# =============================================================================
|
|
|
|
|
|
|
|
|
|
# =============================================================================
|
|
# URL mapping
|
|
# =============================================================================
|
|
|
|
|
|
|
|
|
|
# =============================================================================
|
|
# Context length
|
|
# =============================================================================
|
|
|
|
|
|
class TestTencentTokenhubContextLength:
|
|
"""hy3-preview has a context-length entry registered.
|
|
|
|
Asserting the relationship (registered + ≥ 4096) instead of a
|
|
specific value, per AGENTS.md "Don't write change-detector tests".
|
|
The previous version of this class pinned an exact integer that
|
|
broke whenever Tencent / OpenRouter bumped the published context
|
|
window (#22268).
|
|
"""
|
|
|
|
def test_hy3_preview_has_registered_context_length(self):
|
|
from agent.model_metadata import get_model_context_length
|
|
ctx = get_model_context_length("hy3-preview")
|
|
assert isinstance(ctx, int)
|
|
assert ctx >= 4096, f"hy3-preview context length looks unset/wrong: {ctx}"
|
|
|
|
|
|
# =============================================================================
|
|
# providers.py (unified provider module)
|
|
# =============================================================================
|
|
|
|
|
|
class TestTencentTokenhubProvidersModule:
|
|
"""Test Tencent TokenHub in the unified providers module."""
|
|
|
|
def test_overlay_exists(self):
|
|
from hermes_cli.providers import HERMES_OVERLAYS
|
|
assert "tencent-tokenhub" in HERMES_OVERLAYS
|
|
overlay = HERMES_OVERLAYS["tencent-tokenhub"]
|
|
assert overlay.transport == "openai_chat"
|
|
assert overlay.base_url_env_var == "TOKENHUB_BASE_URL"
|
|
assert not overlay.is_aggregator
|
|
|
|
def test_alias_resolves(self):
|
|
from hermes_cli.providers import normalize_provider
|
|
assert normalize_provider("tencent") == "tencent-tokenhub"
|
|
assert normalize_provider("tokenhub") == "tencent-tokenhub"
|
|
|
|
|
|
def test_get_provider(self):
|
|
pdef = None
|
|
try:
|
|
from hermes_cli.providers import get_provider
|
|
pdef = get_provider("tencent-tokenhub")
|
|
except Exception:
|
|
pass
|
|
if pdef is not None:
|
|
assert pdef.id == "tencent-tokenhub"
|
|
assert pdef.transport == "openai_chat"
|
|
|
|
|
|
# =============================================================================
|
|
# Auxiliary client
|
|
# =============================================================================
|
|
|
|
|
|
|
|
|
|
# =============================================================================
|
|
# Doctor
|
|
# =============================================================================
|
|
|
|
|
|
|
|
|
|
# =============================================================================
|
|
# Agent init (no SyntaxError, correct api_mode)
|
|
# =============================================================================
|
|
|
|
|
|
class TestTencentTokenhubAgentInit:
|
|
"""Verify the agent can be constructed with tencent-tokenhub provider without errors."""
|
|
|
|
def test_no_syntax_errors(self):
|
|
"""Importing run_agent with tencent-tokenhub should not raise."""
|
|
import importlib
|
|
importlib.import_module("run_agent")
|
|
|
|
def test_api_mode_is_chat_completions(self):
|
|
from hermes_cli.providers import HERMES_OVERLAYS, TRANSPORT_TO_API_MODE
|
|
overlay = HERMES_OVERLAYS["tencent-tokenhub"]
|
|
api_mode = TRANSPORT_TO_API_MODE[overlay.transport]
|
|
assert api_mode == "chat_completions"
|
|
|
|
|
|
# =============================================================================
|
|
# CLI model flow dispatch (main.py)
|
|
# =============================================================================
|
|
|
|
|
|
|
|
|
|
# =============================================================================
|
|
# Remote model catalog (model-catalog.json)
|
|
# =============================================================================
|
|
|
|
|
|
class TestTencentTokenhubModelCatalogJSON:
|
|
"""Verify tencent/hy3 is present in the website model-catalog.json.
|
|
|
|
tencent/hy3:free was delisted 2026-08-21 — the slug vanished from
|
|
OpenRouter's live catalog (free promo rotated out), so the paid hy3
|
|
entry is the surviving assertion target.
|
|
"""
|
|
|
|
def test_in_model_catalog_json(self):
|
|
catalog_path = os.path.join(
|
|
os.path.dirname(__file__),
|
|
"..", "..",
|
|
"website", "static", "api", "model-catalog.json",
|
|
)
|
|
if not os.path.isfile(catalog_path):
|
|
pytest.skip("model-catalog.json not found in workspace")
|
|
with open(catalog_path) as f:
|
|
data = json.load(f)
|
|
# Collect all model IDs across all provider lists.
|
|
# providers is a dict keyed by provider name, each value has a "models" list.
|
|
all_ids = set()
|
|
providers = data.get("providers", {})
|
|
if isinstance(providers, dict):
|
|
for provider_entry in providers.values():
|
|
for model in provider_entry.get("models", []):
|
|
all_ids.add(model.get("id", ""))
|
|
else:
|
|
for provider_entry in providers:
|
|
for model in provider_entry.get("models", []):
|
|
all_ids.add(model.get("id", ""))
|
|
assert "tencent/hy3" in all_ids
|
|
|
|
|
|
# =============================================================================
|
|
# determine_api_mode (providers.py)
|
|
# =============================================================================
|
|
|
|
|
|
class TestTencentTokenhubApiMode:
|
|
"""Verify determine_api_mode routes tencent-tokenhub correctly."""
|
|
|
|
|
|
def test_determine_api_mode_via_alias(self):
|
|
from hermes_cli.providers import determine_api_mode
|
|
mode = determine_api_mode("tencent")
|
|
assert mode == "chat_completions"
|
|
|
|
|
|
# =============================================================================
|
|
# _KNOWN_PROVIDER_NAMES (models.py)
|
|
# =============================================================================
|
|
|
|
|
|
class TestTencentTokenhubKnownProviderNames:
|
|
"""Verify tencent-tokenhub and its aliases are recognized as valid
|
|
provider names for the ``provider:model`` syntax.
|
|
"""
|
|
|
|
|
|
@pytest.mark.parametrize("alias", [
|
|
"tencent", "tokenhub", "tencent-cloud", "tencentmaas",
|
|
])
|
|
def test_alias_known(self, alias):
|
|
from hermes_cli.models import _KNOWN_PROVIDER_NAMES
|
|
assert alias in _KNOWN_PROVIDER_NAMES
|
|
|