Add __init__.py bridge that discovers and loads the installed mistral-workflows

package, enabling

Author: Andrea Onofrei

.genignore

@@ -4,3 +4,4 @@ examples/*
 src/mistral/extra/*
 pylintrc
 scripts/prepare_readme.py
+./workflows

.speakeasy/gen.lock

@@ -5,8 +5,8 @@ management:
   docVersion: 1.0.0
   speakeasyVersion: 1.606.10
   generationVersion: 2.687.13
-  releaseVersion: 1.10.0
-  configChecksum: 1446aab5f184e7184590fe5756b556a8
+  releaseVersion: 1.10.8
+  configChecksum: c98f5eef0bfbde89016fa6fba58a5534
   repoURL: https://github.com/mistralai/client-python.git
   installationURL: https://github.com/mistralai/client-python.git
   published: true
@@ -474,9 +474,7 @@ generatedFiles:
   - docs/sdks/models/README.md
   - docs/sdks/ocr/README.md
   - docs/sdks/transcriptions/README.md
-  - poetry.toml
   - py.typed
-  - scripts/prepare_readme.py
   - scripts/publish.sh
   - src/mistralai/__init__.py
   - src/mistralai/_hooks/__init__.py
@@ -1531,4 +1529,3 @@ examples:
           application/json: {}
 examplesVersion: 1.0.2
 generatedTests: {}
-releaseNotes: "## SDK Changes Detected:\n* `mistral.beta.libraries.create()`:  `response.owner_id` **Changed** **Breaking** :warning:\n* `mistral.beta.libraries.documents.get()`:  `response` **Changed** **Breaking** :warning:\n* `mistral.models.list()`: \n  *  `response.data.[].[base].capabilities` **Changed**\n  *  `error.status[422]` **Removed** **Breaking** :warning:\n* `mistral.files.list()`: \n  *  `request.include_total` **Added**\n  *  `response.total` **Changed** **Breaking** :warning:\n* `mistral.beta.conversations.start()`: \n  *  `request` **Changed** **Breaking** :warning:\n  *  `response.outputs.[].[tool_execution_entry].name` **Changed** **Breaking** :warning:\n* `mistral.beta.libraries.accesses.delete()`: \n  *  `request.org_id` **Changed**\n  *  `response.share_with_uuid` **Changed** **Breaking** :warning:\n* `mistral.beta.libraries.accesses.update_or_create()`: \n  *  `request.org_id` **Changed**\n  *  `response.share_with_uuid` **Changed** **Breaking** :warning:\n* `mistral.beta.conversations.append()`: \n  *  `request.inputs.[array].[].[tool_execution_entry].name` **Changed** **Breaking** :warning:\n  *  `response.outputs.[].[tool_execution_entry].name` **Changed** **Breaking** :warning:\n* `mistral.beta.libraries.accesses.list()`:  `response.data.[].share_with_uuid` **Changed** **Breaking** :warning:\n* `mistral.beta.conversations.restart()`: \n  *  `request` **Changed** **Breaking** :warning:\n  *  `response.outputs.[].[tool_execution_entry].name` **Changed** **Breaking** :warning:\n* `mistral.beta.libraries.documents.update()`: \n  *  `request.attributes` **Added**\n  *  `response` **Changed** **Breaking** :warning:\n* `mistral.beta.libraries.documents.upload()`:  `response` **Changed** **Breaking** :warning:\n* `mistral.beta.libraries.documents.list()`: \n  *  `request.filters_attributes` **Added**\n  *  `response.data.[]` **Changed** **Breaking** :warning:\n* `mistral.beta.libraries.update()`:  `response.owner_id` **Changed** **Breaking** :warning:\n* `mistral.beta.libraries.delete()`:  `response.owner_id` **Changed** **Breaking** :warning:\n* `mistral.beta.libraries.get()`:  `response.owner_id` **Changed** **Breaking** :warning:\n* `mistral.beta.conversations.get_history()`:  `response.entries.[].[tool_execution_entry].name` **Changed** **Breaking** :warning:\n* `mistral.beta.libraries.list()`:  `response.data.[].owner_id` **Changed** **Breaking** :warning:\n* `mistral.models.retrieve()`:  `response.[base].capabilities` **Changed**\n* `mistral.agents.complete()`:  `request.metadata` **Added**\n* `mistral.beta.agents.get()`: \n  *  `request.agent_version` **Added**\n  *  `response` **Changed**\n* `mistral.beta.agents.list()`: \n  *  `request` **Changed**\n  *  `response.[]` **Changed**\n* `mistral.beta.agents.update_version()`:  `response` **Changed**\n* `mistral.beta.agents.delete()`: **Added**\n* `mistral.beta.conversations.list()`: \n  *  `request.metadata` **Added**\n  *  `response.[]` **Changed**\n* `mistral.beta.conversations.get()`:  `response` **Changed**\n* `mistral.beta.agents.update()`: \n  *  `request` **Changed**\n  *  `response` **Changed**\n* `mistral.beta.conversations.delete()`: **Added**\n* `mistral.chat.complete()`:  `request.metadata` **Added**\n* `mistral.fim.complete()`:  `request.metadata` **Added**\n* `mistral.beta.agents.create()`: \n  *  `request.metadata` **Added**\n  *  `response` **Changed**\n* `mistral.ocr.process()`: \n  *  `request` **Changed**\n  *  `response.pages.[]` **Changed**\n"

.speakeasy/gen.yaml

@@ -21,11 +21,13 @@ generation:
     generateNewTests: false
     skipResponseBodyAssertions: false
 python:
-  version: 1.10.0
+  version: 1.10.8
   additionalDependencies:
     dev:
       pytest: ^8.2.2
       pytest-asyncio: ^0.23.7
+    main:
+      mistral-workflows: ^1.2.2
   allowedRedefinedBuiltins:
     - id
     - object

.speakeasy/workflow.lock

@@ -18,7 +18,6 @@ sources:
         sourceBlobDigest: sha256:f0caa06fb9bcadc35b097aa5ff69bb5020937652df311722b5e44a282bd95d6d
         tags:
             - latest
-            - speakeasy-sdk-regen-1765914268
 targets:
     mistralai-azure-sdk:
         source: mistral-azure-source
@@ -40,7 +39,7 @@ targets:
         sourceRevisionDigest: sha256:cb63bd997cefe7b3b36e91a475df57cb779bf79f183340e0713d8ffb16a2dabc
         sourceBlobDigest: sha256:f0caa06fb9bcadc35b097aa5ff69bb5020937652df311722b5e44a282bd95d6d
         codeSamplesNamespace: mistral-openapi-code-samples
-        codeSamplesRevisionDigest: sha256:b1eacff97275a14ab0c2143e07bdfa4f4bd58f5370b2f106bcc6ada92b754d08
+        codeSamplesRevisionDigest: sha256:f1f5f6d78a0c0e0bd0ef062537a279938ebd4706be0c3745b8d3460c975f2565
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: 1.606.10

README.md

@@ -58,7 +58,15 @@ Mistral AI API: Our Chat Completion and Embeddings APIs specification. Create yo
 >
 > Once a Python version reaches its [official end of life date](https://devguide.python.org/versions/), a 3-month grace period is provided for users to upgrade. Following this grace period, the minimum python version supported in the SDK will be updated.
 
-The SDK can be installed with either *pip* or *uv* package managers.
+The SDK can be installed with *uv*, *pip*, or *poetry* package managers.
+
+### uv
+
+*uv* is a fast Python package installer and resolver, designed as a drop-in replacement for pip and pip-tools. It's recommended for its speed and modern Python tooling capabilities.
+
+```bash
+uv add mistralai
+```
 
 ### PIP
 
@@ -68,12 +76,12 @@ The SDK can be installed with either *pip* or *uv* package managers.
 pip install mistralai
 ```
 
-### UV
+### Poetry
 
-*UV* is an extremely fast Python package and project manager. You can use it to add the SDK to your project:
+*Poetry* is a modern tool that simplifies dependency management and package publishing by using a single `pyproject.toml` file to handle project metadata and dependencies.
 
 ```bash
-uv add mistralai
+poetry add mistralai
 ```
 
 ### Shell and script usage with `uv`
@@ -89,7 +97,7 @@ It's also possible to write a standalone Python script without needing to set up
 ```python
 #!/usr/bin/env -S uv run --script
 # /// script
-# requires-python = ">=3.10"
+# requires-python = ">=3.9"
 # dependencies = [
 #     "mistralai",
 # ]

scripts/publish.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
-export UV_PUBLISH_TOKEN=${PYPI_TOKEN}
 
-uv run python scripts/prepare_readme.py -- uv build
-uv publish
+uv run python scripts/prepare_readme.py
+
+uv build
+uv publish --token $PYPI_TOKEN

src/mistralai/_version.py

@@ -3,10 +3,10 @@
 import importlib.metadata
 
 __title__: str = "mistralai"
-__version__: str = "1.10.0"
+__version__: str = "1.10.8"
 __openapi_doc_version__: str = "1.0.0"
 __gen_version__: str = "2.687.13"
-__user_agent__: str = "speakeasy-sdk/python 1.10.0 2.687.13 1.0.0 mistralai"
+__user_agent__: str = "speakeasy-sdk/python 1.10.8 2.687.13 1.0.0 mistralai"
 
 try:
     if __package__ is not None:

src/mistralai/workflows/__init__.py

@@ -0,0 +1,33 @@
+import importlib.util
+import os
+import sys
+from types import ModuleType
+
+# Find and import the installed mistral-workflows package
+bridge_path = os.path.abspath(__file__)
+sys.modules.pop(__name__, None)  # Remove bridge to avoid recursion
+
+try:
+    # Search for the installed package (skip this bridge file)
+    for path in sys.path:
+        if not path:
+            continue
+        target = os.path.join(path, "mistralai", "workflows", "__init__.py")
+        if os.path.exists(target) and os.path.abspath(target) != bridge_path:
+            spec = importlib.util.spec_from_file_location("mistralai.workflows", target)
+            if spec and spec.loader:
+                workflows: ModuleType = importlib.util.module_from_spec(spec)
+                sys.modules["mistralai.workflows"] = workflows
+                spec.loader.exec_module(workflows)
+                globals().update(
+                    {name: getattr(workflows, name) for name in workflows.__all__}
+                )
+                break
+    else:
+        raise ImportError(
+            "mistral-workflows not installed. Run: pip install mistral-workflows"
+        )
+finally:
+    current_module = sys.modules.get("mistralai.workflows") or sys.modules.get(__name__)
+    if current_module is not None:
+        sys.modules[__name__] = current_module