@danhachuel/thunderbolt 0.4.14 → 0.4.16

package/hermes_ui/llm_providers.py

@@ -14,6 +14,7 @@ from integrations.openai_model_discovery import (
     OpenAICompatibleAPIError,
     fetch_openai_compatible_models,
     validate_openai_compatible_api_key,
+    validate_openrouter_api_key,
 )
 
 
@@ -420,7 +421,10 @@ def test_llm_provider_card(card: Mapping[str, Any]) -> dict[str, Any]:
     if not model:
         return {"ok": False, "status": "error", "message": "Missing configuration — introduza o modelo antes do teste."}
     try:
-        validate_openai_compatible_api_key(api_key, base_url, model)
+        if normalized["provider"] == "openrouter":
+            validate_openrouter_api_key(api_key, base_url, model)
+        else:
+            validate_openai_compatible_api_key(api_key, base_url, model)
     except OpenAICompatibleAPIError as exc:
         return {
             "ok": False,

package/integrations/openai_model_discovery.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from typing import Any
+from urllib.parse import urlsplit, urlunsplit
 
 import requests
 
@@ -20,11 +21,23 @@ class OpenAICompatibleAPIError(ValueError):
     """Raised when an authenticated OpenAI-compatible API check fails."""
 
 
+def _normalise_http_base_url(base_url: str, *, error_type: type[Exception]) -> str:
+    """Keep only the HTTP origin/path used to build OpenAI-compatible endpoints."""
+    raw = str(base_url or "").strip()
+    if not raw:
+        raise error_type("Informe a Base URL antes da chamada.")
+    try:
+        parsed = urlsplit(raw)
+    except ValueError as exc:
+        raise error_type("A Base URL não é válida.") from exc
+    if parsed.scheme not in {"http", "https"} or not parsed.netloc:
+        raise error_type("A Base URL deve começar por http:// ou https://.")
+    return urlunsplit((parsed.scheme, parsed.netloc, parsed.path.rstrip("/"), "", ""))
+
+
 def models_endpoint(base_url: str) -> str:
     """Return the ``/models`` endpoint for an OpenAI-compatible base URL."""
-    value = str(base_url or "").strip().rstrip("/")
-    if not value:
-        raise ModelDiscoveryError("Informe a Base URL antes de consultar os modelos.")
+    value = _normalise_http_base_url(base_url, error_type=ModelDiscoveryError)
     if value.endswith("/models"):
         return value
     return f"{value}/models"
@@ -32,14 +45,62 @@ def models_endpoint(base_url: str) -> str:
 
 def chat_completions_endpoint(base_url: str) -> str:
     """Return the Chat Completions endpoint for an OpenAI-compatible base URL."""
-    value = str(base_url or "").strip().rstrip("/")
-    if not value:
-        raise OpenAICompatibleAPIError("Informe a Base URL antes do teste.")
+    value = _normalise_http_base_url(base_url, error_type=OpenAICompatibleAPIError)
     if value.endswith("/chat/completions"):
         return value
+    if value.endswith("/models"):
+        value = value.removesuffix("/models")
     return f"{value}/chat/completions"
 
 
+def validate_openrouter_api_key(
+    api_key: str,
+    base_url: str,
+    model: str,
+    *,
+    timeout: float = DEFAULT_TIMEOUT_SECONDS,
+) -> None:
+    """Validate an OpenRouter key and model without spending credits on a chat call."""
+    token = str(api_key or "").strip()
+    model_id = str(model or "").strip()
+    if not token:
+        raise OpenAICompatibleAPIError("Informe a API key antes do teste.")
+    if not model_id:
+        raise OpenAICompatibleAPIError("Informe o modelo antes do teste.")
+
+    base = _normalise_http_base_url(base_url, error_type=OpenAICompatibleAPIError)
+    headers = {
+        "Accept": "application/json",
+        "Authorization": f"Bearer {token}",
+    }
+    key_endpoint = f"{base}/key"
+    try:
+        key_response = requests.get(key_endpoint, headers=headers, timeout=timeout)
+    except requests.RequestException as exc:
+        raise OpenAICompatibleAPIError("Não foi possível contactar o OpenRouter para validar a API key.") from exc
+
+    if key_response.status_code in (401, 403):
+        raise OpenAICompatibleAPIError(
+            f"A API key do OpenRouter foi recusada (HTTP {key_response.status_code}). Verifique a credencial."
+        )
+    if key_response.status_code >= 400:
+        raise OpenAICompatibleAPIError(
+            f"O diagnóstico da API key do OpenRouter devolveu HTTP {key_response.status_code}."
+        )
+
+    try:
+        available_models = fetch_openai_compatible_models(token, base, timeout=timeout)
+    except ModelDiscoveryError as exc:
+        raise OpenAICompatibleAPIError(
+            "A API key foi aceite, mas não foi possível consultar o catálogo de modelos OpenRouter."
+        ) from exc
+    if model_id not in available_models:
+        raise OpenAICompatibleAPIError(
+            f"A API key OpenRouter foi validada, mas o modelo '{model_id}' não está no catálogo actual. "
+            "Clique em Consultar modelos e seleccione um modelo disponível."
+        )
+
+
 def validate_openai_compatible_api_key(
     api_key: str,
     base_url: str,
@@ -77,6 +138,13 @@ def validate_openai_compatible_api_key(
             raise OpenAICompatibleAPIError(
                 f"O endpoint recusou a API key (HTTP {response.status_code}). Verifique a API key."
             )
+        if response.status_code == 404 and "openrouter.ai" in str(urlsplit(base_url).netloc).casefold():
+            raise OpenAICompatibleAPIError(
+                "O OpenRouter devolveu HTTP 404. Confirme a Base URL "
+                "https://openrouter.ai/api/v1 e seleccione um modelo válido do catálogo "
+                "(por exemplo, openai/gpt-4o-mini). O teste envia POST para "
+                "https://openrouter.ai/api/v1/chat/completions."
+            )
         raise OpenAICompatibleAPIError(f"O endpoint de teste devolveu HTTP {response.status_code}.")
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/thunderbolt",
-  "version": "0.4.14",
+  "version": "0.4.16",
   "description": "Thunderbolt — interface local para operação de canais faceless e motor MoneyPrinterTurbo",
   "license": "MIT",
   "main": "scripts/cli.mjs",