feat(balatrobench): add package exports and fix models types

Author: S1M0N38

src/balatrobench/__init__.py

@@ -0,0 +1,69 @@
+"""BalatroBench - Benchmark analysis for BalatroLLM."""
+
+from .analyzer import BenchmarkAnalyzer
+from .enums import Deck, Stake
+from .extractor import (
+    extract_request_content,
+    extract_request_metadata,
+    extract_response_data,
+)
+from .models import (
+    Config,
+    LeaderboardEntry,
+    Manifest,
+    Model,
+    ModelsLeaderboard,
+    ModelsLeaderboardEntry,
+    Request,
+    Run,
+    Runs,
+    Stats,
+    StrategiesLeaderboard,
+    StrategiesLeaderboardEntry,
+    Strategy,
+    Version,
+)
+from .source import (
+    SourceModel,
+    SourceStats,
+    SourceStrategy,
+    SourceTask,
+)
+from .writer import BenchmarkWriter
+
+__version__ = "1.0.0"
+
+__all__ = [
+    # Version
+    "__version__",
+    # Enums
+    "Deck",
+    "Stake",
+    # Output Models
+    "Config",
+    "LeaderboardEntry",
+    "Manifest",
+    "Model",
+    "ModelsLeaderboard",
+    "ModelsLeaderboardEntry",
+    "Request",
+    "Run",
+    "Runs",
+    "Stats",
+    "StrategiesLeaderboard",
+    "StrategiesLeaderboardEntry",
+    "Strategy",
+    "Version",
+    # Source Models
+    "SourceModel",
+    "SourceStats",
+    "SourceStrategy",
+    "SourceTask",
+    # Classes
+    "BenchmarkAnalyzer",
+    "BenchmarkWriter",
+    # Functions
+    "extract_request_content",
+    "extract_request_metadata",
+    "extract_response_data",
+]

src/balatrobench/models.py

@@ -218,8 +218,8 @@ class Run:
     final_ante: int
     final_round: int
 
-    # Provider usage distribution
-    providers: dict[str, int]  # provider_name -> call count
+    # Provider usage distribution (immutable tuple of (name, count) pairs)
+    providers: tuple[tuple[str, int], ...]
 
     # Per-call statistics within this run
     stats: Stats
@@ -244,7 +244,7 @@ class Runs:
 class Request:
     """Metadata for a single LLM API request."""
 
-    id: str  # Request identifier (e.g., "00042")
+    id: str  # Request identifier (e.g., "request-00042")
     status: Literal["success", "error"]
     provider: str  # LLM provider (e.g., "openai", "azure", "groq")