2026-07-05 15:39:33 +08:00
|
|
|
"""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),
|
|
|
|
|
)
|