Class SideChannelTaskConfig

uncommon_route/semantic.py:68–113

@dataclass(frozen=True, slots=True)
class SideChannelTaskConfig:
    primary: str
    fallback: tuple[str, ...] = ()
    max_tokens: int = 256
    quality: QualityFallbackPolicy = field(default_factory=QualityFallbackPolicy)

    def candidates(self) -> list[str]:
        return [self.primary, *self.fallback]

    @classmethod
    def from_dict(
        cls,
        data: Mapping[str, Any] | None,
        *,
        base: SideChannelTaskConfig,
    ) -> SideChannelTaskConfig:
        if not data:
            return base
        primary = str(data.get("primary", base.primary)).strip()
        if not primary:
            raise ValueError("side-channel primary model cannot be empty")
        fallback = tuple(
            str(model).strip()
            for model in data.get("fallback", base.fallback)
            if str(model).strip()
        )
        task = cls(
            primary=primary,
            fallback=fallback,
            max_tokens=int(data.get("max_tokens", base.max_tokens)),
            quality=QualityFallbackPolicy.from_dict(
                data.get("quality"),
                base=base.quality,
            ),
        )
        if task.max_tokens <= 0:
            raise ValueError("side-channel max_tokens must be > 0")
        return task

    def to_dict(self) -> dict[str, Any]:
        return {
            "primary": self.primary,
            "fallback": list(self.fallback),
            "max_tokens": self.max_tokens,
            "quality": self.quality.to_dict(),
        }


@dataclass(frozen=True, slots=True)