●Change8

v2.4.2

Breaking Changes
📦 mistral-clientView on GitHub →
⚠ 2 breaking✨ 5 features🔧 16 symbols

Summary

This release introduces prompt caching support across chat, FIM, and agent endpoints, adds title fields to connector operations, and includes breaking changes to observability response structures and workflow execution requests.

⚠️ Breaking Changes

  • The response structure for observability methods (`search`, `fetch`, `fetch_similar_events`, `list_events`) has changed. The field `extra_fields` now uses a union type: `Map<extra_fields>.union(Map<string>)`. This may break deserialization if consumers expected a specific map type.
  • The request parameter `request.encoded_input` has been removed from `mistral.workflows.execute_workflow_registration()` and `mistral.workflows.execute_workflow()`. Consumers must update their calls to remove this parameter.

Migration Steps

  1. Remove usage of `request.encoded_input` when calling `mistral.workflows.execute_workflow_registration()` and `mistral.workflows.execute_workflow()`.
  2. Review deserialization logic for responses from `mistral.beta.observability.chat_completion_events.search()`, `mistral.beta.observability.chat_completion_events.fetch()`, `mistral.beta.observability.chat_completion_events.fetch_similar_events()`, and `mistral.beta.observability.campaigns.list_events()` due to the change in `extra_fields` structure to a union type.

✨ New Features

  • Added `request.prompt_cache_key` parameter to `mistral.chat.complete()`, `mistral.chat.stream()`, `mistral.fim.complete()`, `mistral.fim.stream()`, `mistral.agents.complete()`, and `mistral.agents.stream()` for prompt caching.
  • Added `title` field to request and response objects in `mistral.beta.connectors.update()`.
  • Added `title` field to response object in `mistral.beta.connectors.get()`.
  • Added `title` field to items in the response object for `mistral.beta.connectors.list()`.
  • Added `title` field to request and response objects in `mistral.beta.connectors.create()`.

Affected Symbols

mistral.beta.observability.chat_completion_events.searchmistral.beta.observability.chat_completion_events.fetchmistral.beta.observability.chat_completion_events.fetch_similar_eventsmistral.beta.observability.campaigns.list_eventsmistral.workflows.execute_workflow_registrationmistral.workflows.execute_workflowmistral.chat.completemistral.beta.connectors.updatemistral.beta.connectors.getmistral.chat.streammistral.fim.completemistral.fim.streammistral.agents.completemistral.agents.streammistral.beta.connectors.listmistral.beta.connectors.create