mistralai_dart 1.2.1

mistralai_dart: ^1.2.1 copied to clipboard

Internal improvements to build tooling and package publishing configuration.

• REFACTOR: Migrate API skills to the shared api-toolkit CLI (#74). (923cc83e)
• CHORE: Add .pubignore to exclude .agents/ and specs/ from publishing (#78). (0ff199bf)

Added baseUrl and defaultHeaders parameters to withApiKey constructors and unified equality helpers across packages.

• FEAT: Add baseUrl and defaultHeaders to withApiKey constructors (#57). (f0dd0caa)
• REFACTOR: Unify equality_helpers.dart across packages (#67). (ec2897f8)

Added withApiKey convenience constructor and replaced Object? stop with a type-safe StopSequence sealed class for improved API safety.

• FEAT: Add withApiKey convenience constructors (#56). (b06e3df3)
• REFACTOR: Replace Object? stop with StopSequence sealed class (#53). (b6313f54)
• CHORE: Bump googleapis from 15.0.0 to 16.0.0 and Dart SDK to 3.9.0 (#52). (eae130b7)
• CI: Add GitHub Actions test workflow (#50). (6c5f079a)

Note: This release has breaking changes.

TL;DR: Complete reimplementation with a new architecture, minimal dependencies, resource-based API, and improved developer experience. Hand-crafted models (no code generation), interceptor-driven architecture, comprehensive error handling, and full Mistral AI API coverage including stable and beta endpoints.

What's new #

• Resource-based API organization:
  • client.chat — Chat completions (streaming, tool calling, multimodal, JSON mode)
  • client.embeddings — Text embeddings for semantic search and clustering
  • client.models — Model listing and retrieval
  • client.fim — Fill-in-the-Middle code completions (Codestral)
  • client.files — File upload and management
  • client.fineTuning — Fine-tuning jobs and model management
  • client.batch — Asynchronous large-scale batch processing
  • client.moderations — Content moderation for safety
  • client.classifications — Text classification (spam, topic, sentiment)
  • client.ocr — OCR for documents and images
  • client.audio — Speech-to-text transcription with streaming
  • client.agents — Pre-configured AI assistants (beta)
  • client.conversations — Stateful multi-turn conversations (beta)
  • client.libraries — Document storage and retrieval for RAG (beta)
• Architecture:
  • Interceptor chain (Auth → Logging → Error → Transport with Retry wrapper).
  • Authentication: API key or custom via AuthProvider interface.
  • Retry with exponential backoff + jitter (only for idempotent methods on 429, 5xx, timeouts).
  • Abortable requests via abortTrigger parameter.
  • SSE streaming parser for real-time responses with [DONE] marker handling.
  • Central MistralConfig (timeouts, retry policy, log level, baseUrl, auth).
• Hand-crafted models:
  • No code generation dependencies (no freezed, json_serializable).
  • Minimal runtime dependencies (http, logging only).
  • Immutable models with copyWith using sentinel pattern for nullable fields.
  • Full type safety with sealed exception hierarchy.
  • Sealed classes for polymorphic types (ChatMessage, ContentPart, ToolChoice, ResponseFormat, Tool, OcrDocument).
• Improved DX:
  • Named constructors for common patterns (e.g., ChatMessage.user(), ChatMessage.system(), Tool.function(), Tool.webSearch()).
  • Explicit streaming methods (createStream() vs create()).
  • Extension methods for convenient response access (response.text, response.toolCalls, response.hasToolCalls).
  • Rich logging with field redaction for sensitive data.
  • Pagination utilities (Paginator) and job polling helpers (FineTuningJobPoller, BatchJobPoller).
• Full API coverage:
  • Chat completions with tool calling, multimodal inputs, and JSON schema validation.
  • Fill-in-the-Middle (FIM) code completions with streaming.
  • Text embeddings with dimension control and quantization options.
  • File management (upload, download, signed URLs).
  • Fine-tuning with hyperparameter control and W&B integration.
  • Batch processing for large-scale async operations.
  • Content moderation and text classification.
  • OCR for PDFs and images with markdown output.
  • Audio transcription with word-level timestamps.
  • Agents with built-in tools (web search, code interpreter, image generation).
  • Stateful conversations with context management.
  • Document libraries for RAG workflows.

See MIGRATION.md for step-by-step examples and mapping tables.

Commits #

• BREAKING FEAT: Complete v1.0.0 reimplementation (#8). (e18581e5)
• FEAT: Update README and add classification/moderation examples (#15). (88b2064c)
• FIX: Pre-release documentation and code fixes (#44). (93c78871)
• REFACTOR: Align client package architecture across SDK packages (#37). (cf741ee1)
• REFACTOR: Align API surface across all SDK packages (#36). (ed969cc7)
• DOCS: Refactors repository URLs to new location. (76835268)

• FIX: Fix streaming tool calls deserialization error (#913) (#914). (ec4d20bf)

• FEAT: Align Chat API with latest Mistral spec (#887). (b5a12301)
• FEAT: Align embeddings API with latest Mistral spec (#886). (769edc49)

• REFACTOR: Fix pub format warnings (#809). (640cdefb)

Note: This release has breaking changes.

• FIX: Add missing usage field to ChatCompletionStreamResponse in mistralai_dart (#795). (4da75561)
• FIX: Handle optional space after colon in SSE parser in mistralai_dart (#791). (cefb1d2f)
• FEAT: Upgrade to http v1.5.0 (#785). (f7c87790)
• BREAKING BUILD: Require Dart >=3.8.0 (#792). (b887f5c6)

• FEAT: Migrate to Freezed v3 (#773). (f87c8c03)

• BUILD: Update dependencies (#751). (250a3c6)

• FEAT: Update dependencies (requires Dart 3.6.0) (#709). (9e3467f7)
• REFACTOR: Remove fetch_client dependency in favor of http v1.3.0 (#659). (0e0a685c)
• FIX: Fix linter issues (#656). (88a79c65)

• REFACTOR: Add new lint rules and fix issues (#621). (60b10e00)
• REFACTOR: Upgrade api clients generator version (#610). (0c8750e8)

• REFACTOR: Migrate conditional imports to js_interop (#453). (a6a78cfe)

• FIX: Fix deserialization of sealed classes (#435). (7b9cf223)

• FIX: Have the == implementation use Object instead of dynamic (#334). (89f7b0b9)

• FEAT: Update meta and test dependencies (#331). (912370ee)
• DOCS: Update pubspecs. (d23ed89a)

• DOCS: Update CHANGELOG.md. (d0d46534)

• REFACTOR: Update safe_mode and max temperature in Mistral chat (#300). (1a4ccd1e)

• REFACTOR: Make all LLM options fields nullable and add copyWith (#284). (57eceb9b)

• Update a dependency to the latest release.

• FIX: Fetch web requests with big payloads dropping connection (#273). (425889dc)

• FEAT: Implement Dart client for Mistral AI API (#261). (f4954c59)

• Bootstrap project.