python-open-router 0.4.0__py3-none-any.whl → 0.5.0__py3-none-any.whl

python_open_router/__init__.py

@@ -18,10 +18,12 @@ from python_open_router.models import (
     Model,
     ModelArchitecture,
     ModelLinks,
+    ModelReasoning,
     ModelResponseWrapper,
     ModelsDataWrapper,
     PerRequestLimits,
     PublicPricing,
+    ReasoningEffort,
     SupportedParameter,
     TopProviderInfo,
 )
@@ -40,6 +42,7 @@ __all__ = [
     "Model",
     "ModelArchitecture",
     "ModelLinks",
+    "ModelReasoning",
     "ModelResponseWrapper",
     "ModelsDataWrapper",
     "OpenRouterAuthenticationError",
@@ -48,6 +51,7 @@ __all__ = [
     "OpenRouterError",
     "PerRequestLimits",
     "PublicPricing",
+    "ReasoningEffort",
     "SupportedParameter",
     "TopProviderInfo",
 ]

python_open_router/models.py

@@ -128,6 +128,7 @@ class SupportedParameter(StrEnum):
     SEED = "seed"
     RESPONSE_FORMAT = "response_format"
     STRUCTURED_OUTPUTS = "structured_outputs"
+    PREDICTION = "prediction"
     TOOLS = "tools"
     TOOL_CHOICE = "tool_choice"
     PARALLEL_TOOL_CALLS = "parallel_tool_calls"
@@ -157,6 +158,18 @@ class Modality(StrEnum):
     TRANSCRIPTION = "transcription"
 
 
+class ReasoningEffort(StrEnum):
+    """Reasoning effort levels."""
+
+    MAX = "max"
+    XHIGH = "xhigh"
+    HIGH = "high"
+    MEDIUM = "medium"
+    LOW = "low"
+    MINIMAL = "minimal"
+    NONE = "none"
+
+
 @dataclass(kw_only=True)
 class ModelArchitecture(DataClassORJSONMixin):
     """Model architecture data."""
@@ -210,6 +223,39 @@ class DefaultParameters(DataClassORJSONMixin):
     repetition_penalty: float | None = None
 
 
+@dataclass(kw_only=True)
+class ModelReasoning(DataClassORJSONMixin):
+    """Model reasoning options."""
+
+    mandatory: bool
+    supported_efforts: list[ReasoningEffort] | None = None
+    default_effort: ReasoningEffort | None = None
+    default_enabled: bool | None = None
+    supports_max_tokens: bool = False
+
+    @classmethod
+    def __pre_deserialize__(cls, d: dict[str, Any]) -> dict[str, Any]:
+        """Pre deserialize hook."""
+        supported = set(ReasoningEffort)
+        if "supported_efforts" in d and d["supported_efforts"] is None:
+            # Null means every effort is accepted, unlike an omitted field,
+            # which means the model has no effort selection.
+            d["supported_efforts"] = list(ReasoningEffort)
+        efforts = d.get("supported_efforts")
+        default = d.get("default_effort")
+        for effort in [*(efforts or []), default]:
+            if effort is not None and effort not in supported:
+                _LOGGER.warning(
+                    "Unsupported reasoning effort: %s. Please report at https://github.com/joostlek/python-open-router/issues.",
+                    effort,
+                )
+        if efforts is not None:
+            d["supported_efforts"] = [e for e in efforts if e in supported]
+        if default not in supported:
+            d["default_effort"] = None
+        return d
+
+
 @dataclass(kw_only=True)
 class PerRequestLimits(DataClassORJSONMixin):
     """Per-request limits."""
@@ -246,6 +292,7 @@ class Model(DataClassORJSONMixin):
     supported_voices: list[str] | None = None
     expiration_date: str | None = None
     knowledge_cutoff: str | None = None
+    reasoning: ModelReasoning | None = None
 
     @classmethod
     def __pre_deserialize__(cls, d: dict[str, Any]) -> dict[str, Any]:

python_open_router/open_router.py

@@ -31,7 +31,7 @@ from python_open_router.models import (
 )
 
 if TYPE_CHECKING:
-    from typing_extensions import Self
+    from typing import Self
 
 
 VERSION = metadata.version(__package__)
@@ -77,7 +77,7 @@ class OpenRouterClient:
                     headers=headers,
                     json=data,
                 )
-        except asyncio.TimeoutError as exception:
+        except TimeoutError as exception:
             msg = "Timeout occurred while connecting to the service"
             raise OpenRouterConnectionError(msg) from exception
         except (

{python_open_router-0.4.0.dist-info → python_open_router-0.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python_open_router
-Version: 0.4.0
+Version: 0.5.0
 Summary: Asynchronous Python client for Open Router.
 License: MIT
 License-File: LICENSE.md
@@ -19,6 +19,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Dist: aiohttp (>=3.0.0)
 Requires-Dist: mashumaro (>=3.11,<4.0)
@@ -121,7 +122,7 @@ check [the contributor's page][contributors].
 
 MIT License
 
-Copyright (c) 2025 Joost Lekkerkerker
+Copyright (c) 2025-2026 Joost Lekkerkerker
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -151,7 +152,7 @@ SOFTWARE.
 [joostlek]: https://github.com/joostlek
 [keepchangelog]: http://keepachangelog.com/en/1.0.0/
 [license-shield]: https://img.shields.io/github/license/joostlek/python-open-router.svg
-[maintenance-shield]: https://img.shields.io/maintenance/yes/2025.svg
+[maintenance-shield]: https://img.shields.io/maintenance/yes/2026.svg
 [poetry-install]: https://python-poetry.org/docs/#installation
 [poetry]: https://python-poetry.org
 [pre-commit]: https://pre-commit.com/

python_open_router-0.5.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+python_open_router/__init__.py,sha256=F9bDtJw9vCGzeQ7lWcRdap7V9R0du16mSnHOjevpwtc,1252
+python_open_router/exceptions.py,sha256=68nskqNdXNMIK4iA1XOE1E5P5rbhAf27DDACkk-ZVwU,312
+python_open_router/models.py,sha256=wj6SQw0z83R9t9WPEw_6ZT-JgmclHpSUPtKhzKzXm8k,8579
+python_open_router/open_router.py,sha256=FGeuavXDh_39PJgjurVu98qzsEs7olNSqe-MJF_L4eg,9501
+python_open_router/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_open_router-0.5.0.dist-info/METADATA,sha256=6Zqp1Td__jkjvGfTUoFMxx3oV1KKZlEv3kMJu5YS9Fk,6111
+python_open_router-0.5.0.dist-info/WHEEL,sha256=L-WvLdSBvJWHXv5zrQxDvNRnIgoBzLUpcbuiw19KCuQ,88
+python_open_router-0.5.0.dist-info/licenses/LICENSE.md,sha256=nVkEdxeRRC-wzKM8tgyAhQTR1hxiY2jftVwlTDKKQMQ,1082
+python_open_router-0.5.0.dist-info/RECORD,,

{python_open_router-0.4.0.dist-info → python_open_router-0.5.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.4.0
+Generator: poetry-core 2.5.0
 Root-Is-Purelib: true
 Tag: py3-none-any

{python_open_router-0.4.0.dist-info → python_open_router-0.5.0.dist-info}/licenses/LICENSE.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright (c) 2025 Joost Lekkerkerker
+Copyright (c) 2025-2026 Joost Lekkerkerker
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

python_open_router-0.4.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-python_open_router/__init__.py,sha256=9a8JXk66oCsPUc-XxgHBI29sVi6QbjlnUuCUxLDJUfo,1166
-python_open_router/exceptions.py,sha256=68nskqNdXNMIK4iA1XOE1E5P5rbhAf27DDACkk-ZVwU,312
-python_open_router/models.py,sha256=oVEE8q195laYFa7WXSYOKI6FiTqvJ6lPSTzTphj8eHI,6943
-python_open_router/open_router.py,sha256=JB_2fu1akGJ8niuP7FOlExWTV3ytDvmH_sXWKY5iO6I,9520
-python_open_router/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-python_open_router-0.4.0.dist-info/METADATA,sha256=Iv2GN34OuueJ3t0rUj_ELgoEFu-aHPYX7TvCm1XvSqU,6055
-python_open_router-0.4.0.dist-info/WHEEL,sha256=EGEvSphFYqXKs23-kQBeyNoJP1nrT8ZJKQoi5p5DYL8,88
-python_open_router-0.4.0.dist-info/licenses/LICENSE.md,sha256=Xbw7n2Ic30r4j8_MDNND4ss_sdoj9IGeIkEWc2Hsfs8,1077
-python_open_router-0.4.0.dist-info/RECORD,,