Class SceneConfig

uncommon_route/scene_store.py:45–85

A named routing scene.

@dataclass
class SceneConfig:
    """A named routing scene."""

    name: str
    primary: str
    fallback: list[str] = field(default_factory=list)
    hard_pin: bool = False
    description: str = ""

    # Optional tier floor/cap — lets a scene say "at least MEDIUM".
    tier_floor: Tier | None = None
    tier_cap: Tier | None = None

    # Provider-level constraint (e.g. only allow anthropic/).
    allowed_providers: list[str] = field(default_factory=list)

    # Per-scene spend limit ($/request).  None = no limit.
    max_cost_per_request: float | None = None

    def model_pool(self) -> list[str]:
        """Return ordered candidate list: [primary, *fallback]."""
        seen: set[str] = set()
        pool: list[str] = []
        for model in [self.primary, *self.fallback]:
            normalized = model.strip()
            if normalized and normalized not in seen:
                pool.append(normalized)
                seen.add(normalized)
        return pool

    def as_routing_constraints(self) -> RoutingConstraints:
        """Build a RoutingConstraints from scene settings."""
        return RoutingConstraints(
            allowed_models=tuple(self.model_pool()),
            allowed_providers=tuple(self.allowed_providers),
            max_cost=self.max_cost_per_request,
        )

    def as_selection_weights(self) -> None:
        """Reserved for future use when route() supports injected weights."""
        return None


def _serialize_scene(scene: SceneConfig) -> dict[str, Any]: