Class RoutingFeatures

uncommon_route/router/types.py:113–191

@dataclass(frozen=True, slots=True)
class RoutingFeatures:
    step_type: str = "general"
    tool_names: tuple[str, ...] = ()
    has_tool_results: bool = False
    streaming: bool = False
    needs_tool_calling: bool = False
    needs_vision: bool = False
    needs_structured_output: bool = False
    response_format: str | None = None
    step_risk: str = "normal"
    is_agentic: bool = False
    is_coding: bool = False
    prefers_reasoning: bool = False
    requested_max_output_tokens: int | None = None
    tier_floor: Tier | None = None
    tier_cap: Tier | None = None
    tier_cap_reason: str = ""
    session_present: bool = False
    agent_step_count: int = 0
    agent_pressure: float = 0.0
    capability_lane: CapabilityLane | None = None
    previous_served_quality: ServedQuality | None = None
    continuity_quality_floor: ServedQuality | None = None
    verification_failed: bool = False
    failure_kind: str = ""

    @property
    def tool_count(self) -> int:
        return len(self.tool_names)

    def request_requirements(self) -> RequestRequirements:
        return RequestRequirements(
            needs_tool_calling=self.needs_tool_calling,
            needs_vision=self.needs_vision,
            prefers_reasoning=self.prefers_reasoning,
        )

    def workload_hints(self) -> WorkloadHints:
        return WorkloadHints(
            is_agentic=self.is_agentic,
            is_coding=self.is_coding,
            needs_structured_output=self.needs_structured_output,
        )

    def tags(self) -> tuple[str, ...]:
        labels: list[str] = []
        if self.step_type != "general":
            labels.append(f"step:{self.step_type}")
        if self.tool_names:
            labels.append(f"tools:{len(self.tool_names)}")
        if self.has_tool_results:
            labels.append("tool-results")
        if self.step_risk != "normal":
            labels.append(f"risk:{self.step_risk}")
        if self.needs_vision:
            labels.append("vision")
        if self.needs_structured_output:
            labels.append("structured-output")