6cab9e56fc
fix: model definition re-introduced into the schema but intelligently and only a summary is generated per tool. Required to ensure CLI calls and uses the correct model fix: removed `model` param from some tools where this wasn't needed fix: fixed adherence to `*_ALLOWED_MODELS` by advertising only the allowed models to the CLI fix: removed duplicates across providers when passing canonical names back to the CLI; the first enabled provider wins
253 lines
9.2 KiB
Python
253 lines
9.2 KiB
Python
"""OpenRouter provider implementation."""
|
||
|
||
import logging
|
||
import os
|
||
from typing import Optional
|
||
|
||
from .openai_compatible import OpenAICompatibleProvider
|
||
from .openrouter_registry import OpenRouterModelRegistry
|
||
from .shared import (
|
||
ModelCapabilities,
|
||
ModelResponse,
|
||
ProviderType,
|
||
RangeTemperatureConstraint,
|
||
)
|
||
|
||
|
||
class OpenRouterProvider(OpenAICompatibleProvider):
|
||
"""Client for OpenRouter's multi-model aggregation service.
|
||
|
||
Role
|
||
Surface OpenRouter’s dynamic catalogue through the same interface as
|
||
native providers so tools can reference OpenRouter models and aliases
|
||
without special cases.
|
||
|
||
Characteristics
|
||
* Pulls live model definitions from :class:`OpenRouterModelRegistry`
|
||
(aliases, provider-specific metadata, capability hints)
|
||
* Applies alias-aware restriction checks before exposing models to the
|
||
registry or tooling
|
||
* Reuses :class:`OpenAICompatibleProvider` infrastructure for request
|
||
execution so OpenRouter endpoints behave like standard OpenAI-style
|
||
APIs.
|
||
"""
|
||
|
||
FRIENDLY_NAME = "OpenRouter"
|
||
|
||
# Custom headers required by OpenRouter
|
||
DEFAULT_HEADERS = {
|
||
"HTTP-Referer": os.getenv("OPENROUTER_REFERER", "https://github.com/BeehiveInnovations/zen-mcp-server"),
|
||
"X-Title": os.getenv("OPENROUTER_TITLE", "Zen MCP Server"),
|
||
}
|
||
|
||
# Model registry for managing configurations and aliases
|
||
_registry: Optional[OpenRouterModelRegistry] = None
|
||
|
||
def __init__(self, api_key: str, **kwargs):
|
||
"""Initialize OpenRouter provider.
|
||
|
||
Args:
|
||
api_key: OpenRouter API key
|
||
**kwargs: Additional configuration
|
||
"""
|
||
base_url = "https://openrouter.ai/api/v1"
|
||
super().__init__(api_key, base_url=base_url, **kwargs)
|
||
|
||
# Initialize model registry
|
||
if OpenRouterProvider._registry is None:
|
||
OpenRouterProvider._registry = OpenRouterModelRegistry()
|
||
# Log loaded models and aliases only on first load
|
||
models = self._registry.list_models()
|
||
aliases = self._registry.list_aliases()
|
||
logging.info(f"OpenRouter loaded {len(models)} models with {len(aliases)} aliases")
|
||
|
||
# ------------------------------------------------------------------
|
||
# Capability surface
|
||
# ------------------------------------------------------------------
|
||
|
||
def _lookup_capabilities(
|
||
self,
|
||
canonical_name: str,
|
||
requested_name: Optional[str] = None,
|
||
) -> Optional[ModelCapabilities]:
|
||
"""Fetch OpenRouter capabilities from the registry or build a generic fallback."""
|
||
|
||
capabilities = self._registry.get_capabilities(canonical_name)
|
||
if capabilities:
|
||
return capabilities
|
||
|
||
base_identifier = canonical_name.split(":", 1)[0]
|
||
if "/" in base_identifier:
|
||
logging.debug(
|
||
"Using generic OpenRouter capabilities for %s (provider/model format detected)", canonical_name
|
||
)
|
||
generic = ModelCapabilities(
|
||
provider=ProviderType.OPENROUTER,
|
||
model_name=canonical_name,
|
||
friendly_name=self.FRIENDLY_NAME,
|
||
intelligence_score=9,
|
||
context_window=32_768,
|
||
max_output_tokens=32_768,
|
||
supports_extended_thinking=False,
|
||
supports_system_prompts=True,
|
||
supports_streaming=True,
|
||
supports_function_calling=False,
|
||
temperature_constraint=RangeTemperatureConstraint(0.0, 2.0, 1.0),
|
||
)
|
||
generic._is_generic = True
|
||
return generic
|
||
|
||
logging.debug(
|
||
"Rejecting unknown OpenRouter model '%s' (no provider prefix); requires explicit configuration",
|
||
canonical_name,
|
||
)
|
||
return None
|
||
|
||
# ------------------------------------------------------------------
|
||
# Provider identity
|
||
# ------------------------------------------------------------------
|
||
|
||
def get_provider_type(self) -> ProviderType:
|
||
"""Identify this provider for restrictions and logging."""
|
||
return ProviderType.OPENROUTER
|
||
|
||
# ------------------------------------------------------------------
|
||
# Request execution
|
||
# ------------------------------------------------------------------
|
||
|
||
def generate_content(
|
||
self,
|
||
prompt: str,
|
||
model_name: str,
|
||
system_prompt: Optional[str] = None,
|
||
temperature: float = 0.3,
|
||
max_output_tokens: Optional[int] = None,
|
||
**kwargs,
|
||
) -> ModelResponse:
|
||
"""Generate content using the OpenRouter API.
|
||
|
||
Args:
|
||
prompt: User prompt to send to the model
|
||
model_name: Name of the model (or alias) to use
|
||
system_prompt: Optional system prompt for model behavior
|
||
temperature: Sampling temperature
|
||
max_output_tokens: Maximum tokens to generate
|
||
**kwargs: Additional provider-specific parameters
|
||
|
||
Returns:
|
||
ModelResponse with generated content and metadata
|
||
"""
|
||
# Resolve model alias to actual OpenRouter model name
|
||
resolved_model = self._resolve_model_name(model_name)
|
||
|
||
# Always disable streaming for OpenRouter
|
||
# MCP doesn't use streaming, and this avoids issues with O3 model access
|
||
if "stream" not in kwargs:
|
||
kwargs["stream"] = False
|
||
|
||
# Call parent method with resolved model name
|
||
return super().generate_content(
|
||
prompt=prompt,
|
||
model_name=resolved_model,
|
||
system_prompt=system_prompt,
|
||
temperature=temperature,
|
||
max_output_tokens=max_output_tokens,
|
||
**kwargs,
|
||
)
|
||
|
||
# ------------------------------------------------------------------
|
||
# Registry helpers
|
||
# ------------------------------------------------------------------
|
||
|
||
def list_models(
|
||
self,
|
||
*,
|
||
respect_restrictions: bool = True,
|
||
include_aliases: bool = True,
|
||
lowercase: bool = False,
|
||
unique: bool = False,
|
||
) -> list[str]:
|
||
"""Return formatted OpenRouter model names, respecting alias-aware restrictions."""
|
||
|
||
if not self._registry:
|
||
return []
|
||
|
||
from utils.model_restrictions import get_restriction_service
|
||
|
||
restriction_service = get_restriction_service() if respect_restrictions else None
|
||
allowed_configs: dict[str, ModelCapabilities] = {}
|
||
|
||
for model_name in self._registry.list_models():
|
||
config = self._registry.resolve(model_name)
|
||
if not config:
|
||
continue
|
||
|
||
# Custom models belong to CustomProvider; skip them here so the two
|
||
# providers don't race over the same registrations (important for tests
|
||
# that stub the registry with minimal objects lacking attrs).
|
||
if hasattr(config, "is_custom") and config.is_custom is True:
|
||
continue
|
||
|
||
if restriction_service:
|
||
allowed = restriction_service.is_allowed(self.get_provider_type(), model_name)
|
||
|
||
if not allowed and config.aliases:
|
||
for alias in config.aliases:
|
||
if restriction_service.is_allowed(self.get_provider_type(), alias):
|
||
allowed = True
|
||
break
|
||
|
||
if not allowed:
|
||
continue
|
||
|
||
allowed_configs[model_name] = config
|
||
|
||
if not allowed_configs:
|
||
return []
|
||
|
||
# When restrictions are in place, don't include aliases to avoid confusion
|
||
# Only return the canonical model names that are actually allowed
|
||
actual_include_aliases = include_aliases and not respect_restrictions
|
||
|
||
return ModelCapabilities.collect_model_names(
|
||
allowed_configs,
|
||
include_aliases=actual_include_aliases,
|
||
lowercase=lowercase,
|
||
unique=unique,
|
||
)
|
||
|
||
# ------------------------------------------------------------------
|
||
# Registry helpers
|
||
# ------------------------------------------------------------------
|
||
|
||
def _resolve_model_name(self, model_name: str) -> str:
|
||
"""Resolve aliases defined in the OpenRouter registry."""
|
||
|
||
config = self._registry.resolve(model_name)
|
||
if config:
|
||
if config.model_name != model_name:
|
||
logging.info(f"Resolved model alias '{model_name}' to '{config.model_name}'")
|
||
return config.model_name
|
||
|
||
logging.debug(f"Model '{model_name}' not found in registry, using as-is")
|
||
return model_name
|
||
|
||
def get_all_model_capabilities(self) -> dict[str, ModelCapabilities]:
|
||
"""Expose registry-backed OpenRouter capabilities."""
|
||
|
||
if not self._registry:
|
||
return {}
|
||
|
||
capabilities: dict[str, ModelCapabilities] = {}
|
||
for model_name in self._registry.list_models():
|
||
config = self._registry.resolve(model_name)
|
||
if not config:
|
||
continue
|
||
|
||
# See note in list_models: respect the CustomProvider boundary.
|
||
if hasattr(config, "is_custom") and config.is_custom is True:
|
||
continue
|
||
|
||
capabilities[model_name] = config
|
||
return capabilities
|