fix(types): modernize type annotations to Python 3.9+ syntax

- Replace Dict/List/Optional with dict/list/| None
- Replace Any with object for runtime values
- Add type annotations to class attributes
- Add @OverRide decorator to __str__ method
- Fixes all basedpyright strict mode warnings

Author: subtleGradient

src/openrouter/call_model/exceptions.py

@@ -4,7 +4,7 @@
 providing actionable error messages with context for debugging.
 """
 
-from typing import Any, Dict, List, Optional
+from typing import override
 
 
 class CallModelError(Exception):
@@ -19,11 +19,15 @@ class CallModelError(Exception):
         context: Optional dictionary with additional error context
     """
 
+    message: str
+    code: str | None
+    context: dict[str, object]
+
     def __init__(
         self,
         message: str,
-        code: Optional[str] = None,
-        context: Optional[Dict[str, Any]] = None,
+        code: str | None = None,
+        context: dict[str, object] | None = None,
     ):
         """Initialize the error with message, code, and context.
 
@@ -37,6 +41,7 @@ def __init__(
         self.code = code
         self.context = context or {}
 
+    @override
     def __str__(self) -> str:
         """Return the error message."""
         return self.message
@@ -59,7 +64,10 @@ class ToolExecutionError(CallModelError):
         ...     )
     """
 
-    def __init__(self, tool_name: str, error: Exception, context: Dict[str, Any]):
+    tool_name: str
+    original_error: Exception
+
+    def __init__(self, tool_name: str, error: Exception, context: dict[str, object]):
         """Initialize the tool execution error.
 
         Args:
@@ -92,7 +100,10 @@ class ToolValidationError(CallModelError):
         ... )
     """
 
-    def __init__(self, tool_name: str, validation_errors: List[str]):
+    tool_name: str
+    validation_errors: list[str]
+
+    def __init__(self, tool_name: str, validation_errors: list[str]):
         """Initialize the tool validation error.
 
         Args:
@@ -120,7 +131,9 @@ class StreamInterruptedError(CallModelError):
         ... )
     """
 
-    def __init__(self, last_event: Optional[Dict[str, Any]] = None):
+    last_event: dict[str, object] | None
+
+    def __init__(self, last_event: dict[str, object] | None = None):
         """Initialize the stream interrupted error.
 
         Args:
@@ -147,6 +160,9 @@ class MaxToolRoundsExceededError(CallModelError):
         >>> raise MaxToolRoundsExceededError(rounds=10, max_rounds=5)
     """
 
+    rounds: int
+    max_rounds: int
+
     def __init__(self, rounds: int, max_rounds: int):
         """Initialize the max tool rounds exceeded error.
 

src/openrouter/call_model/types.py

@@ -6,7 +6,7 @@
 """
 
 from enum import Enum
-from typing import Any, Dict, List, Optional, TypedDict
+from typing import TypedDict
 
 
 # Type aliases for clarity and maintainability
@@ -16,7 +16,7 @@
 EventType = str
 """Type of SSE event (e.g., 'content.delta', 'tool.call')."""
 
-StreamEvent = Dict[str, Any]
+StreamEvent = dict[str, object]
 """Raw SSE event dictionary from the API."""
 
 
@@ -57,11 +57,11 @@ class ToolContext(TypedDict, total=False):
     """
 
     number_of_turns: int
-    message_history: List[Dict[str, Any]]
-    model: Optional[str]
-    models: Optional[List[str]]
-    previous_tool_results: Optional[List[Dict[str, Any]]]
-    request_id: Optional[str]
+    message_history: list[dict[str, object]]
+    model: str | None
+    models: list[str] | None
+    previous_tool_results: list[dict[str, object]] | None
+    request_id: str | None
 
 
 class ResponseState(str, Enum):
@@ -103,7 +103,7 @@ class CachedData(TypedDict, total=False):
         ... }
     """
 
-    message: Optional[Dict[str, Any]]
-    text: Optional[str]
-    tool_calls: Optional[List[Dict[str, Any]]]
-    raw_response: Optional[Dict[str, Any]]
+    message: dict[str, object] | None
+    text: str | None
+    tool_calls: list[dict[str, object]] | None
+    raw_response: dict[str, object] | None