import json
import os
import shutil
from typing import Dict, List, Tuple, Optional
from pathlib import Path
[docs]
class ModelPreferencesV2:
"""New model preferences system supporting ordered provider/model pairs for fallback selection."""
def __init__(self):
self.data_dir = Path.cwd() / 'data'
self.preferences_file = self.data_dir / 'preferred_models_v2.json'
script_dir = Path(__file__)
self.template_file = script_dir.parent / 'default_preferred_models.json'
[docs]
def ensure_preferences_exist(self) -> None:
"""Copy template preferences file to data directory if it doesn't exist."""
self.data_dir.mkdir(exist_ok=True)
if not self.preferences_file.exists():
if self.template_file.exists():
shutil.copy2(self.template_file, self.preferences_file)
else:
default_prefs = {'stream_chat': [['ah_openrouter', 'deepseek/deepseek-chat-v3.1'], ['ah_anthropic', 'claude-sonnet-4-0'], ['mr_gemini', 'models/gemini-2.5-pro'], ['ah_openai', 'gpt-5']], 'text_to_image': [['ah_flux', 'flux-dev']]}
self.save_preferences(default_prefs)
[docs]
def get_preferences(self) -> Dict[str, List[List[str]]]:
"""Get preferences in new format: {service: [[provider, model], ...]}"""
self.ensure_preferences_exist()
try:
with open(self.preferences_file, 'r') as f:
return json.load(f)
except (FileNotFoundError, json.JSONDecodeError) as e:
return {}
[docs]
def save_preferences(self, preferences: Dict[str, List[List[str]]]) -> None:
"""Save preferences in new format."""
self.data_dir.mkdir(exist_ok=True)
try:
with open(self.preferences_file, 'w') as f:
json.dump(preferences, f, indent=2)
except Exception as e:
raise
[docs]
def get_ordered_providers_for_service(self, service_name: str) -> List[Tuple[str, str]]:
"""Get ordered list of (provider, model) pairs for a service."""
preferences = self.get_preferences()
if service_name not in preferences:
return []
return [(provider, model) for provider, model in preferences[service_name]]
def _guess_provider_from_model(self, model_name: str) -> str:
"""Best-effort guess of provider based on model name."""
model_lower = model_name.lower()
if 'claude' in model_lower:
return 'ah_anthropic'
elif 'gpt' in model_lower or 'chatgpt' in model_lower:
return 'ah_openai'
elif 'gemini' in model_lower:
return 'mr_gemini'
elif 'llama' in model_lower:
return 'ah_together'
elif 'flux' in model_lower:
return 'ah_flux'
elif 'stable' in model_lower or 'sd' in model_lower:
return 'ah_stability'
else:
return 'unknown_provider'
[docs]
def add_preference(self, service: str, provider: str, model: str, position: Optional[int]=None) -> None:
"""Add a provider/model preference for a service at specified position (or end)."""
preferences = self.get_preferences()
if service not in preferences:
preferences[service] = []
provider_model_pair = [provider, model]
preferences[service] = [pm for pm in preferences[service] if pm != provider_model_pair]
if position is not None and 0 <= position <= len(preferences[service]):
preferences[service].insert(position, provider_model_pair)
else:
preferences[service].append(provider_model_pair)
self.save_preferences(preferences)
[docs]
def remove_preference(self, service: str, provider: str, model: str) -> bool:
"""Remove a provider/model preference for a service. Returns True if removed."""
preferences = self.get_preferences()
if service not in preferences:
return False
provider_model_pair = [provider, model]
if provider_model_pair in preferences[service]:
preferences[service].remove(provider_model_pair)
self.save_preferences(preferences)
return True
return False
[docs]
def reorder_preferences(self, service: str, ordered_pairs: List[List[str]]) -> None:
"""Set the complete ordered list of provider/model pairs for a service."""
preferences = self.get_preferences()
preferences[service] = ordered_pairs
self.save_preferences(preferences)