refactor: Update response types to use common schemas across API endpoints

app/schemas/player.py

@@ -1,5 +1,7 @@
 """Player schemas."""
 
+from typing import Any
+
 from pydantic import BaseModel, Field
 
 from app.services.player import PlayerMode
@@ -21,3 +23,24 @@ class PlayerModeRequest(BaseModel):
     """Request model for mode change."""
 
     mode: PlayerMode = Field(description="Playback mode")
+
+
+class PlayerStateResponse(BaseModel):
+    """Response model for player state."""
+
+    status: str = Field(description="Player status (playing, paused, stopped)")
+    current_sound: dict[str, Any] | None = Field(
+        None, description="Current sound information"
+    )
+    playlist: dict[str, Any] | None = Field(
+        None, description="Current playlist information"
+    )
+    position_ms: int = Field(description="Current position in milliseconds")
+    duration_ms: int | None = Field(
+        None, description="Total duration in milliseconds",
+    )
+    volume: int = Field(description="Current volume (0-100)")
+    mode: str = Field(description="Current playback mode")
+    index: int | None = Field(
+        None, description="Current track index in playlist",
+    )