refactor(models): clean up imports and add module docstring

models.py

@@ -1,5 +1,11 @@
-from enum import Enum
+"""
+Shared Pydantic models and Enums for the RedTeamOS environment.
+These define the API contract between the server, environment, and clients.
+"""
 from pydantic import BaseModel, Field, field_validator
+from typing import Optional
+from enum import Enum
+
 
 class StrategyType(str, Enum):
     ROLEPLAY        = "roleplay"
@@ -10,6 +16,7 @@ class StrategyType(str, Enum):
     ENCODING        = "encoding"
     MULTI_TURN      = "multi_turn"
 
+
 class TargetCategory(str, Enum):
     PRIVACY               = "privacy"
     MISINFORMATION        = "misinformation"
@@ -17,6 +24,7 @@ class TargetCategory(str, Enum):
     MANIPULATION          = "manipulation"
     ILLEGAL_ACTIVITY      = "illegal_activity"
 
+
 class AttackAction(BaseModel):
     strategy_type:   StrategyType
     target_category: TargetCategory
@@ -31,6 +39,7 @@ class AttackAction(BaseModel):
             v = v.replace(pattern, "[FILTERED]")
         return v.strip()
 
+
 class RedTeamObservation(BaseModel):
     defender_response:       str
     defense_score:           float = Field(ge=0.0, le=1.0)
@@ -41,6 +50,7 @@ class RedTeamObservation(BaseModel):
     feedback:                str
     episode_id:              str
 
+
 class EpisodeState(BaseModel):
     episode_id:    str
     turn:          int
@@ -48,10 +58,12 @@ class EpisodeState(BaseModel):
     attacks_so_far:int
     is_active:     bool
 
+
 class StepResult(BaseModel):
     observation: RedTeamObservation
     reward:      float
 
+
 class ResetResponse(BaseModel):
     observation: RedTeamObservation
     episode_id:  str