mistle/tools.py

from __future__ import annotations

import re
from abc import ABC, abstractmethod

from collections import deque
from dataclasses import dataclass, field
from typing import Deque, Optional, Pattern, Set, Tuple


class Tool(ABC):
    """Interface for autonomous Telnet tools."""

    @abstractmethod
    def observe(self, output: str) -> None:
        """Receive the latest text emitted by the server."""

    @abstractmethod
    def decide(self) -> Optional[str]:
        """Return the next command to send, or ``None`` to stay idle."""


@dataclass
class LookTool(Tool):
    """Tool that sends a look command to refresh the room description."""

    default_command: str = "schau"
    last_output: str = field(default="", init=False)
    needs_look: bool = field(default=True, init=False)

    def observe(self, output: str) -> None:
        if output:
            self.last_output = output
            # Once we received output, we consider the look complete.
            self.needs_look = False

    def decide(self) -> Optional[str]:
        if self.needs_look:
            self.needs_look = False
            return self.default_command
        return None


@dataclass
class ExploreTool(Tool):
    """Tool that inspects room nouns, or only explicit targets when provided."""

    look_command: str = "schau"
    inspect_command: str = "untersuche"
    targets: Tuple[str, ...] = ()
    nouns_pattern: Pattern[str] = field(
        default_factory=lambda: re.compile(r"\b[A-ZÄÖÜ][A-Za-zÄÖÜäöüß-]*\b")
    )
    last_output: str = field(default="", init=False)
    look_sent: bool = field(default=False, init=False)
    pending_targets: Deque[str] = field(default_factory=deque, init=False)
    seen_targets: Set[str] = field(default_factory=set, init=False)
    inspected_targets: Set[str] = field(default_factory=set, init=False)

    def __post_init__(self) -> None:
        normalized: list[str] = []
        seen: set[str] = set()
        for raw_target in self.targets:
            target = raw_target.strip()
            key = target.lower()
            if not target or key in seen:
                continue
            seen.add(key)
            normalized.append(target)
        self.targets = tuple(normalized)
        for target in self.targets:
            self.seen_targets.add(target.lower())
            self.pending_targets.append(target)

    @property
    def targeted_mode(self) -> bool:
        return bool(self.targets)

    def observe(self, output: str) -> None:
        if not output:
            return
        self.last_output = output
        if self.targeted_mode:
            return
        if not self.look_sent:
            return

        for noun in self.nouns_pattern.findall(output):
            target = noun.strip()
            key = target.lower()
            if not target or key in self.seen_targets:
                continue
            self.seen_targets.add(key)
            self.pending_targets.append(target)

    def decide(self) -> Optional[str]:
        if self.targeted_mode:
            if not self.look_sent:
                self.look_sent = True
                print(
                    f"[Tool] Targeted explore mode, inspecting {len(self.targets)} object(s)"
                )
            if not self.pending_targets:
                return None
            target = self.pending_targets.popleft()
            key = target.lower()
            self.inspected_targets.add(key)
            progress = (
                f"[Tool] Targeted {len(self.inspected_targets)}/{len(self.targets)} "
                f"- untersuche {target}"
            )
            print(progress)
            return f"{self.inspect_command} {target}"

        if not self.look_sent:
            self.look_sent = True
            print("[Tool] Exploring room, sending 'schau'")
            return self.look_command

        if self.pending_targets:
            target = self.pending_targets.popleft()
            key = target.lower()
            self.inspected_targets.add(key)
            progress = f"[Tool] Explored {len(self.inspected_targets)}/{len(self.seen_targets)} — untersuche {target}"
            print(progress)
            return f"{self.inspect_command} {target}"

        return None


@dataclass
class CommunicationTool(Tool):
    """Tool that replies to private tells."""

    reply_template: str = "teile {player} mit Hallo! Ich bin Mistle und ein Bot."
    tell_pattern: Pattern[str] = field(
        default_factory=lambda: re.compile(
            r"^(?P<player>[^\s]+) teilt (d|D)ir mit: (?P<message>.+)$",
            re.MULTILINE,
        )
    )
    last_output: str = field(default="", init=False)
    pending_replies: Deque[Tuple[str, str]] = field(default_factory=deque, init=False)

    def observe(self, output: str) -> None:
        if not output:
            return
        self.last_output = output
        for match in self.tell_pattern.finditer(output):
            player = match.group("player").strip()
            message = match.group("message").strip()
            if not player:
                continue
            self.pending_replies.append((player, message))
            print(f"[Tool] Received message from {player}: {message}")

    def decide(self) -> Optional[str]:
        if not self.pending_replies:
            return None
        player, _ = self.pending_replies.popleft()
        reply = self.reply_template.format(player=player)
        print(f"[Tool] Replying to {player}")
        return reply