js-genai

0.13.0 (2025-05-07)

Features

• Add text and data accessors to LiveServerMessage (a3c4201)
• Add Tool.enterprise_web_search field (29b097d)
• Add a models.list function to list available models. (477d9ec)
• Add Files.download method. (8f44c99)
• Add support for Grounding with Google Maps (41f0cc2)
• enable input transcription for Gemini API. (767c5d5)
• Support global location (fixes #502) (ff906fb)

Bug Fixes

• add retry logic for missing X-Goog-Upload-Status header for js (8cf039e)

0.12.0 (2025-04-30)

Features

• add support for live grounding metadata (f5ed429)

0.11.0 (2025-04-30)

Features

• add models.delete and models.update to manage tuned models (0766718)
• Added support for Tuning operations (d5a035f)
• make min_property, max_property, min_length, max_length, example, patter fields available for Schema class when calling Gemini API (5f91ee7)

Bug Fixes

• Apply converters to list items when the API value isn't an array (249769f)
• chats: Properly handle streaming errors to not throw an error that couldn't be caught, which might result in crash in web. Fixes #487 (0b62e15)
• CI: Fix docs generation for release event (899969e)
• Clean the CHANGELOG to remove the changes not included in the bundle. (89b1d66)
• do not raise error for default field in Schema for Gemini API calls (6f72396)
• Don't transform lists twice (249769f)

0.10.0 (2025-04-23)

Features

• add additional realtime input fields (2150416)
• Add helper function GenerateContentResponse.data to return concatenation of all inline data parts. (97b59a2)
• Allow users to set AbortSignal inside per request config to cancel http request (c44f48d)
• support default field in Schema when users call Gemini API (2e61cce)
• Support setting the default base URL in clients via setDefaultBaseUrls() (df978b8)
• Use ws:// for websockets established over http base URLs. (774505b)

Bug Fixes

• Return actual error text from streaming response (808e0b5), closes #346
• Update _api_client to parse and throw errors during processing stream responses (fixes #461) (1932f1d)

0.9.0 (2025-04-17)

⚠ BREAKING CHANGES

• Simplified the types allowed on the generateContent contents parameter.

Features

• add a helper module to process zod objecsts. (fad2789)
• add support for model_selection_config to GenerateContentConfig (37a9cae)
• Expose transcription configurations for audio in TS, and move generationConfig to the top level LiveConnectConfig (d3a841d)
• Simplified the types allowed on the generateContent contents parameter. (324d158)
• Support audio transcription in Vertex Live API (8d11c04)
• Support RealtimeInputConfig, and language_code in SpeechConfig in python (004ff6a)
• Update VertexRagStore (043d06c)

Bug Fixes

• CI: Fix stable docs generation with release event (89c61b9)

0.8.0 (2025-04-09)

Features

• Add domain to Web GroundingChunk (dc56670)
• Add generationComplete notification to LiveServerContent (4d9811b)
• add session resumption to live module (b5c6975)
• add session resumption. (fff2b66)
• Add thinking_budget to ThinkingConfig for Gemini Thinking Models (76e0e18)
• Add traffic type to GenerateContentResponseUsageMetadata (d84156e)
• Add types for configurable speech detection (fc861bc)
• Add types to support continuous sessions with a sliding window (0fd8256)
• Add UsageMetadata to LiveServerMessage (67b34f7)
• expose generation_complete, input/output_transcription & input/output_audio_transcription to SDK for Vertex Live API (1e8be50)
• merge GenerationConfig into LiveConnectConfig (d25d77d)
• Populate X-Server-Timeout header when a request timeout is set. (6f00495)
• support media resolution (9ebd58b)
• Support models.get() for getting model information (fc62381)
• Update Live converters to pass along configurable speech detection parameters (8301fa2)
• Update Live converters to pass along params to support continuous sessions with a sliding window (3814d92)

Bug Fixes

• Use authentication headers as provided by google-auth-library (94b11a1)

0.7.0 (2025-03-27)

⚠ BREAKING CHANGES

• Change File.sizeBytes from number type to string type

Features

• Add experimental generate_video support (0fa1f05)
• add MediaModalities for ModalityTokenCount (9869098)

Bug Fixes

• Change File.sizeBytes from number type to string type (184c7db)
• Update tLiveClienttToolResponse() to accept FunctionResponse[] (4cab8bf)

0.6.1 (2025-03-25)

Features

• Add engine to VertexAISearch (69dfbaf)
• allow title property to be sent to Gemini API. Gemini API now supports the title property, so it's ok to pass this onto both Vertex and Gemini API. (c5855a3)
• implement files.delete for JS client SDK. (4ac44de)
• Save prompt safety attributes in dedicated field for generate_images (1a774fa)

Bug Fixes

• schema transformer logic fix. (6311f60)

0.6.0 (2025-03-20)

⚠ BREAKING CHANGES

• Unexport Content converter functions

Features

• add IMAGE_SAFTY enum value to FinishReason (81ae907)

Code Refactoring

• Separate converter functions to dedicated _{module}_converters.ts file for readability (bb9ba98)

0.5.0 (2025-03-20)

⚠ BREAKING CHANGES

• Make "turnComplete:true" the default.

Features

• Add sendClientContent, sendRealtimeInput, sendToolResponse to live session (e7ec3c0)
• Make "turnComplete:true" the default. (5f77e3e)
• Support Google Cloud Express for Vertex AI (e15c7f3)
• support new UsageMetadata fields (fe000ed)
• Support Vertex AI on browser runtimes (e15c7f3)
• Upgrade the SDK launch stage to preview. (da38b6d)

0.4.0 (2025-03-14)

⚠ BREAKING CHANGES

• remove the createPartFromVideoMetadata usability function.

Features

• enable union type for Schema when calling Gemini API. (180983c)
• Provide a better error message when trying to use VertexAI in browsers. (1ab1402)
• Support returned safety attributes for generate_images (a0e0fcf)
• throw exception when given method is not supported in Gemini API or Vertex AI (96ccb6f)

Bug Fixes

• remove the createPartFromVideoMetadata usability function. (d660a7f)