●Change8

v1.10.0

Breaking Changes
📦 mistral-clientView on GitHub →
⚠ 25 breaking✨ 11 features🔧 32 symbols

Summary

Mistral AI SDK v1.10.0 introduces several new features like metadata support and agent deletion, but mandates significant updates due to numerous breaking changes in API response structures and request parameters across various endpoints.

⚠️ Breaking Changes

  • `mistral.beta.libraries.create()`: The structure of `response.owner_id` has changed.
  • `mistral.beta.libraries.documents.get()`: The structure of the `response` object has changed.
  • `mistral.models.list()`: The error structure for status 422 has been removed.
  • `mistral.files.list()`: The structure of `response.total` has changed.
  • `mistral.beta.conversations.start()`: The structure of the `request` object has changed, and the structure of `response.outputs.[].[tool_execution_entry].name` has changed.
  • `mistral.beta.libraries.accesses.update_or_create()`: The structure of `response.share_with_uuid` has changed.
  • `mistral.beta.conversations.append()`: The structure of `request.inputs.[array].[].[tool_execution_entry].name` has changed, and the structure of `response.outputs.[].[tool_execution_entry].name` has changed.
  • `mistral.beta.libraries.accesses.list()`: The structure of `response.data.[].share_with_uuid` has changed.
  • `mistral.beta.conversations.restart()`: The structure of the `request` object has changed, and the structure of `response.outputs.[].[tool_execution_entry].name` has changed.
  • `mistral.beta.libraries.documents.update()`: The structure of the `response` object has changed.
  • `mistral.beta.libraries.documents.upload()`: The structure of the `response` object has changed.
  • `mistral.beta.libraries.documents.list()`: The structure of `response.data.[]` has changed.
  • `mistral.beta.libraries.update()`: The structure of `response.owner_id` has changed.
  • `mistral.beta.libraries.delete()`: The structure of `response.owner_id` has changed.
  • `mistral.beta.libraries.get()`: The structure of `response.owner_id` has changed.
  • `mistral.beta.conversations.get_history()`: The structure of `response.entries.[].[tool_execution_entry].name` has changed.
  • `mistral.beta.libraries.list()`: The structure of `response.data.[].owner_id` has changed.
  • `mistral.beta.agents.get()`: The structure of the `response` object has changed.
  • `mistral.beta.agents.list()`: The structure of the `request` and `response.[]` objects have changed.
  • `mistral.beta.agents.update_version()`: The structure of the `response` object has changed.
  • `mistral.beta.conversations.list()`: The structure of `response.[]` has changed.
  • `mistral.beta.conversations.get()`: The structure of the `response` object has changed.
  • `mistral.beta.agents.update()`: The structure of the `request` and `response` objects have changed.
  • `mistral.beta.agents.create()`: The structure of the `response` object has changed.
  • `mistral.ocr.process()`: The structure of the `request` and `response.pages.[]` objects have changed.

Migration Steps

  1. Review changes to `response.owner_id` in `mistral.beta.libraries.create()`, `mistral.beta.libraries.update()`, `mistral.beta.libraries.delete()`, `mistral.beta.libraries.get()`, and `mistral.beta.libraries.list()`.
  2. Update handling for `response` in `mistral.beta.libraries.documents.get()`, `mistral.beta.libraries.documents.update()`, and `mistral.beta.libraries.documents.upload()`.
  3. Remove handling for status 422 errors from `mistral.models.list()` responses.
  4. Update logic for `response.total` in `mistral.files.list()`.
  5. Review changes to request and response structures for conversation endpoints: `mistral.beta.conversations.start()`, `mistral.beta.conversations.append()`, `mistral.beta.conversations.restart()`, `mistral.beta.conversations.get_history()`, `mistral.beta.conversations.list()`, and `mistral.beta.conversations.get()`.
  6. Review changes to `response.share_with_uuid` in `mistral.beta.libraries.accesses.delete()`, `mistral.beta.libraries.accesses.update_or_create()`, and `mistral.beta.libraries.accesses.list()`.
  7. Review changes to `response.data.[]` in `mistral.beta.libraries.documents.list()`.
  8. Review changes to model capabilities in `mistral.models.list()` and `mistral.models.retrieve()`.
  9. Update agent related calls (`mistral.beta.agents.get()`, `mistral.beta.agents.list()`, `mistral.beta.agents.update_version()`, `mistral.beta.agents.update()`, `mistral.beta.agents.create()`) to accommodate request/response structure changes.
  10. Update OCR processing calls (`mistral.ocr.process()`) to reflect request/response changes.

✨ New Features

  • `mistral.files.list()`: Added `request.include_total` parameter.
  • Added `mistral.beta.agents.delete()` endpoint.
  • `mistral.agents.complete()`: Added `request.metadata` parameter.
  • `mistral.beta.agents.get()`: Added `request.agent_version` parameter.
  • Added `mistral.beta.conversations.delete()` endpoint.
  • `mistral.beta.conversations.list()`: Added `request.metadata` parameter.
  • `mistral.chat.complete()`: Added `request.metadata` parameter.
  • `mistral.fim.complete()`: Added `request.metadata` parameter.
  • `mistral.beta.agents.create()`: Added `request.metadata` parameter.
  • `mistral.beta.libraries.documents.update()`: Added `request.attributes` parameter.
  • `mistral.beta.libraries.documents.list()`: Added `request.filters_attributes` parameter.

🔧 Affected Symbols

mistral.beta.libraries.createmistral.beta.libraries.documents.getmistral.models.listmistral.files.listmistral.beta.conversations.startmistral.beta.libraries.accesses.deletemistral.beta.libraries.accesses.update_or_createmistral.beta.conversations.appendmistral.beta.libraries.accesses.listmistral.beta.conversations.restartmistral.beta.libraries.documents.updatemistral.beta.libraries.documents.uploadmistral.beta.libraries.documents.listmistral.beta.libraries.updatemistral.beta.libraries.deletemistral.beta.libraries.getmistral.beta.conversations.get_historymistral.beta.libraries.listmistral.models.retrievemistral.agents.completemistral.beta.agents.getmistral.beta.agents.listmistral.beta.agents.update_versionmistral.beta.agents.deletemistral.beta.conversations.listmistral.beta.conversations.getmistral.beta.agents.updatemistral.beta.conversations.deletemistral.chat.completemistral.fim.completemistral.beta.agents.createmistral.ocr.process