mistral-sdk-patterns

# Mistral SDK Patterns ## Overview Production-ready patterns for the Mistral AI SDK. Covers singleton client, retry/backoff, structured output, streaming, function calling, batch embeddings, and async Python — all with proper error handling. SDK is ESM-only for TypeScript (`@mistralai/mistralai`), sync+async for Python (`mistralai`). ## Prerequisites - `@mistralai/mistralai` (TypeScript) or `mistralai` (Python) installed - `MISTRAL_API_KEY` environment variable set ## Instructions ### Step 1: Singleton Client with Configuration **TypeScript** ```typescript import { Mistral } from '@mistralai/mistralai'; let _client: Mistral | null = null; export function getMistralClient(): Mistral { if (!_client) { const apiKey = process.env.MISTRAL_API_KEY; if (!apiKey) throw new Error('MISTRAL_API_KEY not set'); _client = new Mistral({ apiKey, timeoutMs: 30_000, maxRetries: 3, }); } return _client; } // Reset for testing export function resetClient(): void { _client = null; } ``` **Python** ```python import os from mistralai import Mistral _client = None def get_client() -> Mistral: global _client if _client is None: api_key = os.environ.get("MISTRAL_API_KEY") if not api_key: raise RuntimeError("MISTRAL_API_KEY not set") _client = Mistral(api_key=api_key, timeout_ms=30_000, max_retries=3) return _client ``` ### Step 2: Structured Output with JSON Schema ```typescript import { z } from 'z...