PEP 420 namespace support, widen otel upper bound

[Nelson-PROIA]

Summary

• Widen opentelemetry-semantic-conventions upper bound from <0.60 to <0.61 to allow mistralai and mistralai-workflows to coexist (fixes [BUG CLIENT]: opentelemetry-semantic-conventions upper bound <0.60 blocks compatibility with opentelemetry-api>=1.39.0 #341)
• Add "Additional packages" section to README documenting mistralai-* namespace packages

Validation

Built wheels from both repos and verified the PEP 420 namespace merge in a clean venv using the following script:

#!/usr/bin/env bash
set -euo pipefail

CLIENT_WHL="${1:?Usage: $0 <client.whl> <workflows.whl>}"
WORKFLOWS_WHL="${2:?Usage: $0 <client.whl> <workflows.whl>}"
VENV="/tmp/test-pep420-ns"
PYTHON="${PYTHON:-python3.12}"

cleanup() { rm -rf "$VENV"; }
trap cleanup EXIT

echo "=== Creating clean venv ($PYTHON) ==="
"$PYTHON" -m venv "$VENV"
source "$VENV/bin/activate"

echo ""
echo "=== Test 1: Client only ==="
pip install --quiet "$CLIENT_WHL"
python -c "from mistralai.client import Mistral; print('  client import: OK')"
python -c "
try:
    from mistralai.workflows import workflow
    print('  FAIL: workflows should not be importable')
    exit(1)
except ImportError:
    print('  workflows not importable (expected): OK')
"

echo ""
echo "=== Test 2: No __init__.py at namespace level ==="
python -c "
import pathlib, sysconfig
ns = pathlib.Path(sysconfig.get_path('purelib')) / 'mistralai' / '__init__.py'
if ns.exists():
    print('  FAIL: mistralai/__init__.py exists (breaks PEP 420)')
    exit(1)
else:
    print('  no mistralai/__init__.py: OK')
"

echo ""
echo "=== Test 3: Client + workflows ==="
pip install --quiet "$WORKFLOWS_WHL"
python -c "from mistralai.client import Mistral; print('  client import: OK')"
python -c "from mistralai.workflows import workflow; print('  workflows import: OK')"

echo ""
echo "=== Test 4: Namespace directory listing ==="
python -c "
import pathlib, sysconfig
ns = pathlib.Path(sysconfig.get_path('purelib')) / 'mistralai'
for p in sorted(ns.iterdir()):
    print(f'  {p.name}/')
"

echo ""
echo "=== All tests passed ==="

Known issue: CI examples failing

The run_example_scripts CI job fails on fine-tuning examples (async_jobs.py, jobs.py, dry_run_job.py) because no models are available for completion fine-tuning on the CI API key. This is a pre-existing issue unrelated to this PR.

Builds on #340.

[Nelson-PROIA]

CI fails because uv sync --all-extras resolves mistralai-workflows>=2.0.0 from PyPI. Published versions (<=2.0.0b3) pin opentelemetry-semantic-conventions<=0.58b0, conflicting with this repo's >=0.59b0,<0.60. Unblocked once the updated mistralai-workflows with compatible otel deps is published.

[louis-sanna-dev]

Very nice.

I'm blocking the merge since we need before merging:

• to update the workflow package to respect the target structure mistralai/workflows
• to solve those otel issues

[louis-sanna-dev]

@Nelson-PROIA apologies for contradictory review, but I think we should use pip in doc (😶‍🌫️) (like other big SDK do).

[HHK1]

@louis-sanna-dev

to update the workflow package to respect the target structure mistralai/workflows

Actually I don't think we should do this in this order. The main SDK (on which the workflow SDK depends) should first be updated no? Then, the workflow SDK can be updated and published with a new major version?

[louis-sanna-dev]

@louis-sanna-dev

to update the workflow package to respect the target structure mistralai/workflows

Actually I don't think we should do this in this order. The main SDK (on which the workflow SDK depends) should first be updated no? Then, the workflow SDK can be updated and published with a new major version?

@HHK1 yes your are correct.

I was incorrectly understanding how the whole the workflow SDK fitted with the rest.

[louis-sanna-dev]

@Nelson-PROIA looks good, let's just move back to pip in doc and merge.