#2869 - Agents Refactor

src/primaite/game/agent/scripted_agents/abstract_tap.py

@@ -0,0 +1,34 @@
+# © Crown-owned copyright 2024, Defence Science and Technology Laboratory UK
+from __future__ import annotations
+
+import random
+from abc import abstractmethod
+
+from primaite.game.agent.interface import AbstractScriptedAgent
+
+
+class AbstractTAPAgent(AbstractScriptedAgent, identifier="Abstract_TAP"):
+    """Base class for TAP agents to inherit from."""
+
+    config: "AbstractTAPAgent.ConfigSchema"
+
+    class ConfigSchema(AbstractScriptedAgent.ConfigSchema):
+        """Configuration schema for Abstract TAP agents."""
+
+        starting_node_name: str
+        next_execution_timestep: int
+
+    @abstractmethod
+    def setup_agent(self) -> None:
+        """Set up agent."""
+        pass
+
+    def _set_next_execution_timestep(self, timestep: int) -> None:
+        """Set the next execution timestep with a configured random variance.
+
+        :param timestep: The timestep to add variance to.
+        """
+        random_timestep_increment = random.randint(
+            -self.config.agent_settings.start_settings.variance, self.config.agent_settings.start_settings.variance
+        )
+        self.config.next_execution_timestep = timestep + random_timestep_increment