googleai_dart 3.6.0

googleai_dart: ^3.6.0 copied to clipboard

Updated Interactions API with new content types (file search call, image config) and improved model fields. Also fixed interactions streaming by moving the stream flag from a query parameter to the request body, matching the official Python SDK behavior.

• FEAT: Update interactions API models (#107). (21677923)
• FIX: Move stream flag to request body for interactions streaming (#111). (c8e8f133)

Updated to the latest Google AI API spec with new model types (grounding metadata, model info, and image models) and added Gemini Embedding 2 support.

• FEAT: Add Gemini Embedding 2 support (#95). (b7276ae8)
• FEAT: Update spec and implement new model types (#93). (b898d414)
• FIX: Rename Image class and ModelStage enum value to match spec (#96). (ea3fc432)

This release adds inline streaming error detection for improved reliability when handling streamed responses.

• FEAT: Detect inline streaming errors (#91). (9f0eaf37)
• DOCS: Improve READMEs with badges, sponsor section, and vertex_ai deprecation (#90). (5741f2f3)

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 for more flexible client initialization.

• FEAT: Add baseUrl and defaultHeaders to withApiKey constructors (#57). (f0dd0caa)

Added withApiKey convenience constructor for simplified client initialization.

• FEAT: Add withApiKey convenience constructors (#56). (b06e3df3)
• 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)

Added thoughtSignature support for FunctionCallPart and ThoughtPart, pre-release Gemini 3.1 migration and documentation fixes, and various architecture alignments.

• FEAT: Pre-release Gemini 3.1 migration and doc fixes (#47). (8fcfbd84)
• FEAT: Add thoughtSignature support to FunctionCallPart and ThoughtPart (#39). (cd2f5bdc)
• FIX: Fix linter issues. (ad1e1f94)
• REFACTOR: Align client package architecture across SDK packages (#37). (cf741ee1)
• REFACTOR: Align API surface across all SDK packages (#36). (ed969cc7)
• REFACTOR: Extract streaming helpers to StreamingResource mixin (#2). (0b6f0ed9)
• DOCS: Add image generation documentation and example (#25). (21602051)
• DOCS: Add comprehensive examples (#14). (b3bade72)
• DOCS: Refactors repository URLs to new location. (76835268)

Note: This release has breaking changes.

• FEAT: add convenience helpers for improved DX (#924). (634b4f97)
• FEAT: Update default models to Gemini 3 family (#922). (62bca9da)
• FEAT: Auto-populate batch.model from method parameter (#921). (abfeded8)
• BREAKING FEAT: replace List

• FEAT: Add Gemini Live API (WebSocket) support (#920). (4beb01dd)
• FEAT: Add missing model properties from OpenAPI spec (#916). (fc0e2f8a)
• DOCS: Add documentation for grounding tools (#917). (b5a529fe)

Note: This release has breaking changes.

• BREAKING FEAT: Remove deprecated schema fields (#848). (e6d07ec4)
• BREAKING FEAT: Remove deprecated Chunks and query APIs (#847). (9cae76d5)
• BREAKING FEAT: Remove deprecated RagStores resource (#846). (1ab553f1)
• FEAT: Add InteractionsResource and client integration (#905). (af6b13ea)
• FEAT: Add Interactions API tool types (#904). (2258cfa1)
• FEAT: Add Interactions API events and deltas (#903). (826d3f64)
• FEAT: Add Interactions API content types (#902). (b8c61743)
• FEAT: Add Interactions API core models (#901). (65f5db17)
• FEAT: Update existing models with new properties (#856). (dd3893e0)
• FEAT: Add RetrievalConfig to ToolConfig (#855). (5e11aa70)
• FEAT: Add MediaResolution to Part (#854). (df76f8c5)
• FEAT: Add GoogleMaps tool (#853). (54814614)
• FEAT: Add McpServers tool (#852). (97970687)
• FEAT: Add FileSearch tool (#851). (a00895b1)
• FEAT: Add grounding models (#850). (bb1a6228)
• FEAT: Add FileSearchStores resource (#849). (acb63d72)
• FEAT: Add ThinkingConfig support to GenerationConfig (#817). (36de62a9)
• FIX: Complete alignment with target implementation (#884). (60476e8d)
• DOCS: Add Interactions API docs and example (#897). (f4a04677)

• FEAT: Make googleai_dart fully WASM compatible (#808). (07e597f3)
• REFACTOR: Fix pub format warnings (#809). (640cdefb)

Note: This release has breaking changes.

TL;DR: Complete reimplementation with a new architecture, minimal dependencies, unified resource-based API, and full Gemini API coverage. Includes new Files, Batches, Caching, Corpora/RAG, RAG Stores, Dynamic Content, Permissions, Tuned Models, and Prediction (Veo) support.

What's new #

• Unified client for both:
  • Google AI Gemini Developer API
  • Vertex AI Gemini API
• Complete API coverage: 78 endpoints.
  • Files API: upload, list, get, delete, download.
  • Generated Files API: list, get, getOperation (video outputs).
  • Cached Contents: full CRUD.
  • Batch operations: batchGenerateContent, batchEmbedContents, asyncBatchEmbedContent with LRO polling.
  • Corpora & RAG: corpus CRUD (Google AI); documents/chunks/query, metadata filters, batch chunk ops (Vertex AI only).
  • RAG Stores: documents list/create/get/delete/query + operations.
  • Dynamic Content: generate/stream content with dynamic model IDs.
  • Permissions: create/list/get/update/delete/transferOwnership for eligible resources.
  • Tuned Models: list, get, listOperations, generation APIs.
  • Prediction (Veo): predict, predictLongRunning, operation polling, RAI filtering.
• Architecture:
  • Interceptor chain (Auth → Logging → Error).
  • Authentication: API key, Bearer token, custom OAuth via AuthProvider.
  • Retry with exponential backoff + jitter.
  • Abortable requests via abortTrigger (streaming and non-streaming).
  • SSE streaming parser.
  • Central GoogleAIConfig (timeouts, retry policy, log level, baseUrl).
• Testing:
  • 560+ tests covering all endpoints, error branches, streaming/abort flows.

Breaking Changes #

• Resource-based API: Methods reorganized under strongly-typed resources:
  • client.models.* (generation, streaming, embeddings, tokens, prediction)
  • client.tunedModels.*
  • client.files.*, client.generatedFiles.*
  • client.cachedContents.*
  • client.batches.*
  • client.corpora.*
  • client.ragStores.*
• Parameter rename: modelId → model.
• Configuration: New GoogleAIConfig with AuthProvider pattern (API key / bearer / custom OAuth).
• Exceptions: Replaced ad-hoc errors with a typed hierarchy:
  • ApiException, ValidationException, RateLimitException, TimeoutException, AbortedException.
• Dependencies: Removed fetch_client; now minimal (http, logging).

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

• 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: Upgrade api clients generator version (#610). (0c8750e8)

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

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

• REFACTOR: Minor changes (#407). (fa4b5c37)

• FEAT: Support generateContent for tuned model in googleai_dart client (#358). (b4641a09)
• FEAT: Support output dimensionality in Google AI Embeddings (#373). (6dcb27d8)
• FEAT: Support updating API key in Google AI client (#357). (b9b808e7)
• FIX: Have the == implementation use Object instead of dynamic (#334). (89f7b0b9)

• FEAT: Add streaming support to googleai_dart client (#299). (2cbd538a)
• FEAT: Update meta and test dependencies (#331). (912370ee)
• DOCS: Update pubspecs. (d23ed89a)

• DOCS: Update CHANGELOG.md. (d0d46534)

• 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 Google AI API (#267). (99083cd2)

• Bootstrap project.