"""Model route selection helpers.""" from __future__ import annotations from dataclasses import dataclass, field from typing import Any SUPPORTED = "confirmed_supported" UNSUPPORTED = "confirmed_unsupported" UNCONFIRMED = "unconfirmed" @dataclass(frozen=True) class ModelRoute: provider_id: str model_id: str route_id: str | None = None status: str = UNCONFIRMED capabilities: set[str] = field(default_factory=set) priority: int = 100 @property def key(self) -> str: return self.route_id or f"{self.provider_id}/{self.model_id}" def to_dict(self) -> dict[str, Any]: return { "route_id": self.route_id, "provider_id": self.provider_id, "model_id": self.model_id, "status": self.status, "capabilities": sorted(self.capabilities), "priority": self.priority, } @dataclass(frozen=True) class RouteSelection: selected: ModelRoute | None status: str reason: str = "" candidates: list[ModelRoute] = field(default_factory=list) @property def valid(self) -> bool: return self.selected is not None and self.status == SUPPORTED def select_model_route( routes: list[ModelRoute], *, required_capabilities: list[str] | None = None, preferred_route_id: str | None = None, ) -> RouteSelection: required = set(required_capabilities or []) candidates = [route for route in routes if required.issubset(route.capabilities)] if preferred_route_id: preferred = [route for route in candidates if route.key == preferred_route_id or route.route_id == preferred_route_id] if preferred: candidates = preferred candidates = sorted(candidates, key=lambda route: (route.status != SUPPORTED, route.priority, route.key)) if not candidates: return RouteSelection(None, UNCONFIRMED, "no route advertises required capabilities", []) selected = candidates[0] if selected.status == SUPPORTED: return RouteSelection(selected, SUPPORTED, candidates=candidates) if selected.status == UNSUPPORTED: return RouteSelection(None, UNSUPPORTED, "best matching route is unsupported", candidates) return RouteSelection(None, UNCONFIRMED, "best matching route is unconfirmed", candidates) def route_from_capability_profile(profile: dict[str, Any]) -> ModelRoute: capabilities = profile.get("capabilities") or {} supports = capabilities.get("supports", capabilities if isinstance(capabilities, list) else []) return ModelRoute( provider_id=str(profile.get("provider_id") or ""), model_id=str(profile.get("model_id") or ""), route_id=profile.get("route_id"), status=str(profile.get("status") or UNCONFIRMED), capabilities={str(item) for item in supports}, priority=int(profile.get("priority") or 100), )