mistral-upgrade-migration

# Mistral AI Upgrade & Migration ## Current State !`npm list @mistralai/mistralai 2>/dev/null || echo 'not installed'` !`pip show mistralai 2>/dev/null | grep -E "^(Name|Version)" || echo 'not installed'` ## Overview Guide for upgrading the Mistral AI SDK between major versions. The TypeScript SDK (`@mistralai/mistralai`) moved from CommonJS to ESM-only in v1.x, with significant API surface changes. This skill covers version detection, breaking change migration, automated code transforms, and rollback. ## Prerequisites - Current Mistral AI SDK installed - Git for version control - Test suite available ## Instructions ### Step 1: Check Versions ```bash set -euo pipefail # Current version npm list @mistralai/mistralai 2>/dev/null # Latest available npm view @mistralai/mistralai version # All versions npm view @mistralai/mistralai versions --json | jq '.[-5:]' # Python pip show mistralai 2>/dev/null | grep Version ``` ### Step 2: Known Breaking Changes (v0.x to v1.x) | Change | v0.x (old) | v1.x (current) | |--------|-----------|----------------| | Module format | CommonJS + ESM | **ESM only** | | Import | `import MistralClient from '...'` | `import { Mistral } from '...'` | | Constructor | `new MistralClient(apiKey)` | `new Mistral({ apiKey })` | | Chat method | `client.chat(params)` | `client.chat.complete(params)` | | Streaming | `client.chatStream(params)` | `client.chat.stream(params)` | | Stream events | `for await (const chunk of stream)` | `for await (const ev...