"""Versioned mobile semantics; no model, device or frozen codec changes on import."""

import math
from dataclasses import asdict, dataclass

LEGACY_PROTOCOL = "gui-owl-unified133-desktop-android-historybins-v1"
PROTOCOL = "gui-owl-unified133-mobile-semantics-v2"
SCHEMA = "unified133-mobile-subgoal-sft-v2"
DIRECTIONS = ("up", "down", "left", "right")
ANDROID_WORLD_REVISION = "55ddaf5edc6f6c25673aed343907d5b9dca66f84"


@dataclass(frozen=True)
class MobileExecutionConfig:
    """Runtime policy, never a claim about missing demonstration durations.

    AndroidWorld uses 1 second for wait and long press. Its directional scroll
    leaves duration to Android's input command. Coordinate swipe stays on the
    frozen executor's explicit 800 ms path.
    """

    protocol: str = PROTOCOL
    wait_seconds: float = 1.0
    long_press_seconds: float = 1.0
    scroll_duration_ms: int | None = None
    scroll_geometry: str = "androidworld-screen-center-to-edge"
    reference_revision: str = ANDROID_WORLD_REVISION

    def __post_init__(self):
        if self.protocol != PROTOCOL:
            raise ValueError("execution_protocol_mismatch")
        for value in (self.wait_seconds, self.long_press_seconds):
            if (
                type(value) not in (int, float)
                or not math.isfinite(value)
                or not 0 < value <= 999.99
            ):
                raise ValueError("invalid_execution_default_duration")
        if self.scroll_duration_ms is not None and (
            type(self.scroll_duration_ms) is not int or not 1 <= self.scroll_duration_ms <= 999990
        ):
            raise ValueError("invalid_scroll_duration")
        if self.scroll_geometry != "androidworld-screen-center-to-edge":
            raise ValueError("unknown_scroll_geometry")
        if self.reference_revision != ANDROID_WORLD_REVISION:
            raise ValueError("execution_reference_mismatch")

    def as_dict(self):
        return asdict(self)


def direction_scroll_argv(direction, size, config):
    """Small argv-only adapter for pinned AndroidWorld execute_adb_action(scroll).

    Apache-2.0 reference: third_party/android_world_mobile_reference. The full
    executor imports AndroidEnv/ADB services and also changes text-entry semantics;
    only this GUI primitive is adapted. Endpoints are runtime geometry, not labels.
    """
    if direction not in DIRECTIONS:
        raise ValueError("invalid_scroll_direction")
    if len(size) != 2 or any(type(v) is not int or v <= 0 for v in size):
        raise ValueError("invalid_screen_size")
    width, height = size
    start = [width // 2, height // 2]
    ends = {
        "down": [width // 2, 0],
        "up": [width // 2, height],
        "right": [0, height // 2],
        "left": [width, height // 2],
    }
    argv = ["input", "swipe", *map(str, start + ends[direction])]
    if config.scroll_duration_ms is not None:
        argv.append(str(config.scroll_duration_ms))
    return argv