release: 0.25.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.24.0"
+  ".": "0.25.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 48
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/mixedbread%2Fmixedbread-7f00f72937a82d3184ef21bc91c848984d4c3bacf910a671ac2c5736025d862c.yml
-openapi_spec_hash: 5c59e45eebcbb99551e308b194ec6243
-config_hash: ac27678c24558b71ee39b3db54fa12da
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/mixedbread%2Fmixedbread-4983c57f5143aaeadfbb4af35595570e613035ae500ff1597fdf600cc2a48959.yml
+openapi_spec_hash: ecc0a6cfe61c3c959d034d094f36befe
+config_hash: d98614cc5eec7ec8807fcc86c1799d62

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.25.0 (2025-08-11)
+
+Full Changelog: [v0.24.0...v0.25.0](https://github.com/mixedbread-ai/mixedbread-python/compare/v0.24.0...v0.25.0)
+
+### Features
+
+* **api:** api update ([0fe5e39](https://github.com/mixedbread-ai/mixedbread-python/commit/0fe5e399cfd281bd969d1b7a7e4cf82b0f7640ca))
+* **api:** update via SDK Studio ([b509fd0](https://github.com/mixedbread-ai/mixedbread-python/commit/b509fd02421db24df2ca65f4016deb7e6752f1c7))
+
 ## 0.24.0 (2025-08-11)
 
 Full Changelog: [v0.23.0...v0.24.0](https://github.com/mixedbread-ai/mixedbread-python/compare/v0.23.0...v0.24.0)

api.md

@@ -1,7 +1,7 @@
 # Shared Types
 
 ```python
-from mixedbread.types import SearchFilterCondition, Usage
+from mixedbread.types import SearchFilter, SearchFilterCondition, Usage
 ```
 
 # Mixedbread

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mixedbread"
-version = "0.24.0"
+version = "0.25.0"
 description = "The official Python library for the Mixedbread API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/mixedbread/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "mixedbread"
-__version__ = "0.24.0"  # x-release-please-version
+__version__ = "0.25.0"  # x-release-please-version

src/mixedbread/types/__init__.py

@@ -2,7 +2,9 @@
 
 from __future__ import annotations
 
-from .shared import Usage as Usage, SearchFilterCondition as SearchFilterCondition
+from . import shared
+from .. import _compat
+from .shared import Usage as Usage, SearchFilter as SearchFilter, SearchFilterCondition as SearchFilterCondition
 from .api_key import APIKey as APIKey
 from .embedding import Embedding as Embedding
 from .data_source import DataSource as DataSource
@@ -56,3 +58,12 @@
 from .vector_store_question_answering_response import (
     VectorStoreQuestionAnsweringResponse as VectorStoreQuestionAnsweringResponse,
 )
+
+# Rebuild cyclical models only after all modules are imported.
+# This ensures that, when building the deferred (due to cyclical references) model schema,
+# Pydantic can resolve the necessary references.
+# See: https://github.com/pydantic/pydantic/issues/11250 for more context.
+if _compat.PYDANTIC_V2:
+    shared.search_filter.SearchFilter.model_rebuild(_parent_namespace_depth=0)
+else:
+    shared.search_filter.SearchFilter.update_forward_refs()  # type: ignore

src/mixedbread/types/shared/__init__.py

@@ -1,4 +1,5 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 from .usage import Usage as Usage
+from .search_filter import SearchFilter as SearchFilter
 from .search_filter_condition import SearchFilterCondition as SearchFilterCondition

src/mixedbread/types/shared/search_filter.py

@@ -0,0 +1,38 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List, Union, Optional
+from typing_extensions import TypeAlias, TypeAliasType
+
+from ..._compat import PYDANTIC_V2
+from ..._models import BaseModel
+from .search_filter_condition import SearchFilterCondition
+
+__all__ = ["SearchFilter", "All", "Any", "NoneType"]
+
+if TYPE_CHECKING or PYDANTIC_V2:
+    All = TypeAliasType("All", Union["SearchFilter", SearchFilterCondition])
+else:
+    All: TypeAlias = Union["SearchFilter", SearchFilterCondition]
+
+if TYPE_CHECKING or PYDANTIC_V2:
+    Any = TypeAliasType("Any", Union["SearchFilter", SearchFilterCondition])
+else:
+    Any: TypeAlias = Union["SearchFilter", SearchFilterCondition]
+
+if TYPE_CHECKING or PYDANTIC_V2:
+    NoneType = TypeAliasType("NoneType", Union["SearchFilter", SearchFilterCondition])
+else:
+    NoneType: TypeAlias = Union["SearchFilter", SearchFilterCondition]
+
+
+class SearchFilter(BaseModel):
+    all: Optional[List[All]] = None
+    """List of conditions or filters to be ANDed together"""
+
+    any: Optional[List[Any]] = None
+    """List of conditions or filters to be ORed together"""
+
+    none: Optional[List[NoneType]] = None
+    """List of conditions or filters to be NOTed"""

src/mixedbread/types/shared_params/__init__.py

@@ -1,3 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from .search_filter import SearchFilter as SearchFilter
 from .search_filter_condition import SearchFilterCondition as SearchFilterCondition

src/mixedbread/types/shared_params/search_filter.py

@@ -0,0 +1,37 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Union, Iterable, Optional
+from typing_extensions import TypeAlias, TypedDict, TypeAliasType
+
+from ..._compat import PYDANTIC_V2
+from .search_filter_condition import SearchFilterCondition
+
+__all__ = ["SearchFilter", "All", "Any", "NoneType"]
+
+if TYPE_CHECKING or PYDANTIC_V2:
+    All = TypeAliasType("All", Union["SearchFilter", SearchFilterCondition])
+else:
+    All: TypeAlias = Union["SearchFilter", SearchFilterCondition]
+
+if TYPE_CHECKING or PYDANTIC_V2:
+    Any = TypeAliasType("Any", Union["SearchFilter", SearchFilterCondition])
+else:
+    Any: TypeAlias = Union["SearchFilter", SearchFilterCondition]
+
+if TYPE_CHECKING or PYDANTIC_V2:
+    NoneType = TypeAliasType("NoneType", Union["SearchFilter", SearchFilterCondition])
+else:
+    NoneType: TypeAlias = Union["SearchFilter", SearchFilterCondition]
+
+
+class SearchFilter(TypedDict, total=False):
+    all: Optional[Iterable[All]]
+    """List of conditions or filters to be ANDed together"""
+
+    any: Optional[Iterable[Any]]
+    """List of conditions or filters to be ORed together"""
+
+    none: Optional[Iterable[NoneType]]
+    """List of conditions or filters to be NOTed"""

src/mixedbread/types/vector_store_question_answering_params.py

@@ -8,20 +8,7 @@
 from .shared_params.search_filter_condition import SearchFilterCondition
 from .vector_store_chunk_search_options_param import VectorStoreChunkSearchOptionsParam
 
-__all__ = [
-    "VectorStoreQuestionAnsweringParams",
-    "Filters",
-    "FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1",
-    "FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1All",
-    "FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1Any",
-    "FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1None",
-    "FiltersUnionMember2",
-    "FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1",
-    "FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1All",
-    "FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1Any",
-    "FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1None",
-    "QaOptions",
-]
+__all__ = ["VectorStoreQuestionAnsweringParams", "Filters", "FiltersUnionMember2", "QaOptions"]
 
 
 class VectorStoreQuestionAnsweringParams(TypedDict, total=False):
@@ -55,49 +42,9 @@ class VectorStoreQuestionAnsweringParams(TypedDict, total=False):
     """Question answering configuration options"""
 
 
-FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1All: TypeAlias = Union[SearchFilterCondition, object]
+FiltersUnionMember2: TypeAlias = Union["SearchFilter", SearchFilterCondition]
 
-FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1Any: TypeAlias = Union[SearchFilterCondition, object]
-
-FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1None: TypeAlias = Union[SearchFilterCondition, object]
-
-
-class FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1(TypedDict, total=False):
-    all: Optional[Iterable[FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1All]]
-    """List of conditions or filters to be ANDed together"""
-
-    any: Optional[Iterable[FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1Any]]
-    """List of conditions or filters to be ORed together"""
-
-    none: Optional[Iterable[FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1None]]
-    """List of conditions or filters to be NOTed"""
-
-
-FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1All: TypeAlias = Union[SearchFilterCondition, object]
-
-FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1Any: TypeAlias = Union[SearchFilterCondition, object]
-
-FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1None: TypeAlias = Union[SearchFilterCondition, object]
-
-
-class FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1(TypedDict, total=False):
-    all: Optional[Iterable[FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1All]]
-    """List of conditions or filters to be ANDed together"""
-
-    any: Optional[Iterable[FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1Any]]
-    """List of conditions or filters to be ORed together"""
-
-    none: Optional[Iterable[FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1None]]
-    """List of conditions or filters to be NOTed"""
-
-
-FiltersUnionMember2: TypeAlias = Union[
-    FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1, SearchFilterCondition
-]
-
-Filters: TypeAlias = Union[
-    FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1, SearchFilterCondition, Iterable[FiltersUnionMember2]
-]
+Filters: TypeAlias = Union["SearchFilter", SearchFilterCondition, Iterable[FiltersUnionMember2]]
 
 
 class QaOptions(TypedDict, total=False):
@@ -106,3 +53,6 @@ class QaOptions(TypedDict, total=False):
 
     multimodal: bool
     """Whether to use multimodal context"""
+
+
+from .shared_params.search_filter import SearchFilter

src/mixedbread/types/vector_store_search_params.py

@@ -8,19 +8,7 @@
 from .shared_params.search_filter_condition import SearchFilterCondition
 from .vector_store_chunk_search_options_param import VectorStoreChunkSearchOptionsParam
 
-__all__ = [
-    "VectorStoreSearchParams",
-    "Filters",
-    "FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1",
-    "FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1All",
-    "FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1Any",
-    "FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1None",
-    "FiltersUnionMember2",
-    "FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1",
-    "FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1All",
-    "FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1Any",
-    "FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1None",
-]
+__all__ = ["VectorStoreSearchParams", "Filters", "FiltersUnionMember2"]
 
 
 class VectorStoreSearchParams(TypedDict, total=False):
@@ -45,46 +33,8 @@ class VectorStoreSearchParams(TypedDict, total=False):
     """Search configuration options"""
 
 
-FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1All: TypeAlias = Union[SearchFilterCondition, object]
+FiltersUnionMember2: TypeAlias = Union["SearchFilter", SearchFilterCondition]
 
-FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1Any: TypeAlias = Union[SearchFilterCondition, object]
+Filters: TypeAlias = Union["SearchFilter", SearchFilterCondition, Iterable[FiltersUnionMember2]]
 
-FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1None: TypeAlias = Union[SearchFilterCondition, object]
-
-
-class FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1(TypedDict, total=False):
-    all: Optional[Iterable[FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1All]]
-    """List of conditions or filters to be ANDed together"""
-
-    any: Optional[Iterable[FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1Any]]
-    """List of conditions or filters to be ORed together"""
-
-    none: Optional[Iterable[FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1None]]
-    """List of conditions or filters to be NOTed"""
-
-
-FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1All: TypeAlias = Union[SearchFilterCondition, object]
-
-FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1Any: TypeAlias = Union[SearchFilterCondition, object]
-
-FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1None: TypeAlias = Union[SearchFilterCondition, object]
-
-
-class FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1(TypedDict, total=False):
-    all: Optional[Iterable[FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1All]]
-    """List of conditions or filters to be ANDed together"""
-
-    any: Optional[Iterable[FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1Any]]
-    """List of conditions or filters to be ORed together"""
-
-    none: Optional[Iterable[FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1None]]
-    """List of conditions or filters to be NOTed"""
-
-
-FiltersUnionMember2: TypeAlias = Union[
-    FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1, SearchFilterCondition
-]
-
-Filters: TypeAlias = Union[
-    FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1, SearchFilterCondition, Iterable[FiltersUnionMember2]
-]
+from .shared_params.search_filter import SearchFilter

src/mixedbread/types/vector_stores/file_search_params.py

@@ -8,21 +8,7 @@
 from .rerank_config_param import RerankConfigParam
 from ..shared_params.search_filter_condition import SearchFilterCondition
 
-__all__ = [
-    "FileSearchParams",
-    "Filters",
-    "FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1",
-    "FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1All",
-    "FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1Any",
-    "FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1None",
-    "FiltersUnionMember2",
-    "FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1",
-    "FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1All",
-    "FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1Any",
-    "FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1None",
-    "SearchOptions",
-    "SearchOptionsRerank",
-]
+__all__ = ["FileSearchParams", "Filters", "FiltersUnionMember2", "SearchOptions", "SearchOptionsRerank"]
 
 
 class FileSearchParams(TypedDict, total=False):
@@ -47,49 +33,9 @@ class FileSearchParams(TypedDict, total=False):
     """Search configuration options"""
 
 
-FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1All: TypeAlias = Union[SearchFilterCondition, object]
+FiltersUnionMember2: TypeAlias = Union["SearchFilter", SearchFilterCondition]
 
-FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1Any: TypeAlias = Union[SearchFilterCondition, object]
-
-FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1None: TypeAlias = Union[SearchFilterCondition, object]
-
-
-class FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1(TypedDict, total=False):
-    all: Optional[Iterable[FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1All]]
-    """List of conditions or filters to be ANDed together"""
-
-    any: Optional[Iterable[FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1Any]]
-    """List of conditions or filters to be ORed together"""
-
-    none: Optional[Iterable[FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1None]]
-    """List of conditions or filters to be NOTed"""
-
-
-FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1All: TypeAlias = Union[SearchFilterCondition, object]
-
-FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1Any: TypeAlias = Union[SearchFilterCondition, object]
-
-FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1None: TypeAlias = Union[SearchFilterCondition, object]
-
-
-class FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1(TypedDict, total=False):
-    all: Optional[Iterable[FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1All]]
-    """List of conditions or filters to be ANDed together"""
-
-    any: Optional[Iterable[FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1Any]]
-    """List of conditions or filters to be ORed together"""
-
-    none: Optional[Iterable[FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1None]]
-    """List of conditions or filters to be NOTed"""
-
-
-FiltersUnionMember2: TypeAlias = Union[
-    FiltersUnionMember2MxbaiOmniCoreVectorStoreModelsSearchFilter1, SearchFilterCondition
-]
-
-Filters: TypeAlias = Union[
-    FiltersMxbaiOmniCoreVectorStoreModelsSearchFilter1, SearchFilterCondition, Iterable[FiltersUnionMember2]
-]
+Filters: TypeAlias = Union["SearchFilter", SearchFilterCondition, Iterable[FiltersUnionMember2]]
 
 SearchOptionsRerank: TypeAlias = Union[bool, RerankConfigParam]
 
@@ -115,3 +61,6 @@ class SearchOptions(TypedDict, total=False):
 
     apply_search_rules: bool
     """Whether to apply search rules"""
+
+
+from ..shared_params.search_filter import SearchFilter