Commits included in this export:

- 56d382078cfce7fa597d1da2bce531af2d060b47
  - 9ef6db7e04c9401536763a321b05d00311cef31a
  - bf855082e30820d466f0f86a6d6e87de2ecfb06f
  - 335b1cbe361214e48b945b987b4e164457aa817b
  - 648485fdc7f9d8ae86fd857eccedcc5e41fb2e69
  - 80c49474a15a2bd549a5f26efad3858aa45b7c7b
  - 70e8ac317f9c4472db3decd024d1819650df4182
  - 9f2a6659ab6dbf111a0c29e4366328c3d2048826
  - a3a28b1fc6ec7d2941232a4ebde8c5f470497876
  - 4b5dc9193480b7c5c9ddb882ccf3ee2128ca0d51
  - bb413e979a46ef67c2f266743f7ebd798af42afb
  - b60e92d5dcec83f31986164f51c010d1728b2b17
  - 45687f423707f5838461585c568a024a19eb2f06
  - 3103d3ca68b6e42ccdb6136588ec2b6edc8dcab0
  - fd9f991606027cd86116317c71f8eb7b4e2aa3eb
  - 0f312019161edd76c1e5923d142c788d22f096d5
  - 5dbab2094bc744db4a90b3097520d897e5d0d634
  - 4c47d1af1735db18a1c1a7f463e801c7f71ad4e5

GitOrigin-RevId: 56d382078cfce7fa597d1da2bce531af2d060b47

src/openrouter/components/providerpreferences.py

@@ -8,7 +8,6 @@ from .preferredminthroughput import (
     PreferredMinThroughputTypedDict,
 )
 from .providername import ProviderName
-from .providersort import ProviderSort
 from .quantization import Quantization
 from openrouter.types import (
     BaseModel,
@@ -58,7 +57,7 @@ ProviderPreferencesIgnore = TypeAliasType(
 )
 
 
-SortEnum = Union[
+ProviderPreferencesSortEnum = Union[
     Literal[
         "price",
         "throughput",
@@ -68,13 +67,24 @@ SortEnum = Union[
 ]
 
 
-ProviderSortConfigEnum = Literal[
+ProviderPreferencesProviderSortConfigEnum = Literal[
     "price",
     "throughput",
     "latency",
 ]
 
 
+ProviderPreferencesBy = Union[
+    Literal[
+        "price",
+        "throughput",
+        "latency",
+    ],
+    UnrecognizedStr,
+]
+r"""The provider sorting strategy (price, throughput, latency)"""
+
+
 ProviderPreferencesPartition = Union[
     Literal[
         "model",
@@ -82,22 +92,28 @@ ProviderPreferencesPartition = Union[
     ],
     UnrecognizedStr,
 ]
+r"""Partitioning strategy for sorting: \"model\" (default) groups endpoints by model before sorting (fallback models remain fallbacks), \"none\" sorts all endpoints together regardless of model."""
 
 
 class ProviderPreferencesProviderSortConfigTypedDict(TypedDict):
-    by: NotRequired[Nullable[ProviderSort]]
+    by: NotRequired[Nullable[ProviderPreferencesBy]]
+    r"""The provider sorting strategy (price, throughput, latency)"""
     partition: NotRequired[Nullable[ProviderPreferencesPartition]]
+    r"""Partitioning strategy for sorting: \"model\" (default) groups endpoints by model before sorting (fallback models remain fallbacks), \"none\" sorts all endpoints together regardless of model."""
 
 
 class ProviderPreferencesProviderSortConfig(BaseModel):
     by: Annotated[
-        OptionalNullable[ProviderSort], PlainValidator(validate_open_enum(False))
+        OptionalNullable[ProviderPreferencesBy],
+        PlainValidator(validate_open_enum(False)),
     ] = UNSET
+    r"""The provider sorting strategy (price, throughput, latency)"""
 
     partition: Annotated[
         OptionalNullable[ProviderPreferencesPartition],
         PlainValidator(validate_open_enum(False)),
     ] = UNSET
+    r"""Partitioning strategy for sorting: \"model\" (default) groups endpoints by model before sorting (fallback models remain fallbacks), \"none\" sorts all endpoints together regardless of model."""
 
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
@@ -130,15 +146,20 @@ class ProviderPreferencesProviderSortConfig(BaseModel):
         return m
 
 
-ProviderSortConfigUnionTypedDict = TypeAliasType(
-    "ProviderSortConfigUnionTypedDict",
-    Union[ProviderPreferencesProviderSortConfigTypedDict, ProviderSortConfigEnum],
+ProviderPreferencesProviderSortConfigUnionTypedDict = TypeAliasType(
+    "ProviderPreferencesProviderSortConfigUnionTypedDict",
+    Union[
+        ProviderPreferencesProviderSortConfigTypedDict,
+        ProviderPreferencesProviderSortConfigEnum,
+    ],
 )
 
 
-ProviderSortConfigUnion = TypeAliasType(
-    "ProviderSortConfigUnion",
-    Union[ProviderPreferencesProviderSortConfig, ProviderSortConfigEnum],
+ProviderPreferencesProviderSortConfigUnion = TypeAliasType(
+    "ProviderPreferencesProviderSortConfigUnion",
+    Union[
+        ProviderPreferencesProviderSortConfig, ProviderPreferencesProviderSortConfigEnum
+    ],
 )
 
 
@@ -150,11 +171,16 @@ ProviderPreferencesProviderSort = Union[
     ],
     UnrecognizedStr,
 ]
+r"""The provider sorting strategy (price, throughput, latency)"""
 
 
 ProviderPreferencesSortUnionTypedDict = TypeAliasType(
     "ProviderPreferencesSortUnionTypedDict",
-    Union[ProviderPreferencesProviderSort, ProviderSortConfigUnionTypedDict, SortEnum],
+    Union[
+        ProviderPreferencesProviderSort,
+        ProviderPreferencesProviderSortConfigUnionTypedDict,
+        ProviderPreferencesSortEnum,
+    ],
 )
 r"""The sorting strategy to use for this request, if \"order\" is not specified. When set, no load balancing is performed."""
 
@@ -165,8 +191,10 @@ ProviderPreferencesSortUnion = TypeAliasType(
         Annotated[
             ProviderPreferencesProviderSort, PlainValidator(validate_open_enum(False))
         ],
-        ProviderSortConfigUnion,
-        Annotated[SortEnum, PlainValidator(validate_open_enum(False))],
+        ProviderPreferencesProviderSortConfigUnion,
+        Annotated[
+            ProviderPreferencesSortEnum, PlainValidator(validate_open_enum(False))
+        ],
     ],
 )
 r"""The sorting strategy to use for this request, if \"order\" is not specified. When set, no load balancing is performed."""