release: 0.33.0

[stainless-app]

Automated Release PR

0.33.0 (2025-10-08)

Full Changelog: v0.32.1...v0.33.0

Features

• api: api update (68de836)

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

---

Note

Bumps to 0.33.0 with API/codegen introducing structured generated_metadata unions across chunk and vector store models, plus spec and changelog updates.

• Types (codegen):
  • Replace Dict-based generated_metadata with discriminated-union types (markdown, text, pdf, code, audio) across:
    • src/mixedbread/types/scored_*_input_chunk.py
    • src/mixedbread/types/stores/store_file.py
    • src/mixedbread/types/vector_stores/*vector_store_file.py
    • src/mixedbread/types/vector_store_*_response.py
  • Add supporting metadata models, PropertyInfo(discriminator="type"), and TYPE_CHECKING/FieldInfo handling.
• Release/Metadata:
  • Version bump 0.32.1 -> 0.33.0 in pyproject.toml, _version.py, and manifest.
  • Update OpenAPI spec URL/hash in .stats.yml.
  • Add CHANGELOG.md entry for 0.33.0 (API update).

^{Written by Cursor Bugbot for commit f095d04. This will update automatically on new commits. Configure here.}

[stainless-app]

🧪 Testing

To try out this version of the SDK, run:

pip install 'https://pkg.stainless.com/s/mixedbread-python/741043f6f885736d07240afc2af1fccf7ae3f0cc/mixedbread-0.32.1-py3-none-any.whl'

Expires: Fri, 07 Nov 2025 09:28:53 GMT

[cursor]

Bug: Pydantic Fails on None Discriminated Union

The GeneratedMetadata discriminated union includes None as a variant. When deserializing a None value, Pydantic attempts to access the 'type' discriminator field, leading to a runtime error. This pattern may also exist in other TypeAlias definitions.

 

[cursor]

Bug: Discriminator Ambiguity in Metadata Types

The GeneratedMetadata TypeAlias uses a discriminator on the type field, but its union variants define type as Optional[Literal[...]] = None. This ambiguity when type is None can lead to deserialization errors.

Additional Locations (1)

• src/mixedbread/types/vector_store_search_response.py#L215-L226

 

[stainless-app]

🤖 Release is at https://github.com/mixedbread-ai/mixedbread-python/releases/tag/v0.33.0 🌻