js-genai

1.13.0 (2025-08-06)

Features

• Add image_size field for Gemini Developer API Imagen 4 generation (9841ecb)
• Add Lyria enum for music generation mode for vocalization (b05821f)
• allow methods in batch to return headers in sdk_http_response by default (55a2be4)
• enable responseId for Gemini Developer API (40e3a58)
• Support image recontext on Vertex (e417867)
• Support new enum types for UrlRetrievalStatus (88b47e6)

1.12.0 (2025-07-30)

Features

• allow methods in models to return headers in sdk_http_response by default. (efdcb8a)
• allow methods in tuning to return headers in sdk_http_response by default (f81c16a)

Bug Fixes

• Correctly populated the Rai filter reasons on Video Generation (316cdb0)

1.11.0 (2025-07-23)

Features

• Add image_size field for Vertex Imagen 4 generation (b6cc23e)
• enable function calling for Callable Tool besides McpClient in generateContent. (90565bd)
• Introduced Operations.get() which is a generic function to handle all Operation types. (a6f85c1)
• return headers for list method in all modules. (e8591a3)
• Updates to codegen instructions to improve performance for TypeScript (9c97ec6)

1.10.0 (2025-07-17)

Features

• Add addWatermark parameter to the edit image configuration. (16bca99)
• Adding codegen instructions to guide LLMs to generate code with the Google GenAI SDK (7f74175)
• Update hasMcpToolUsage to set the MCP tool usage when it is detected by calling mcpToTool (a70f9c4)

Bug Fixes

• live: enhance security by moving api key from query parameters to header (f183b7d)
• live: Rollback commit f183b7d, breaks live in web env (be24e86)

1.9.0 (2025-07-09)

Features

• Add new languages for Imagen 4 prompt language (65be769)

Bug Fixes

• add unref() for request timeouts (6b76c4b)

1.8.0 (2025-07-01)

Features

• Enable Vertex Multimodal Dataset as input to supervised fine-tuning. (055b435)
• Support Batches delete (6cd9174)
• Support different media input in Vertex Live API (305952e)

1.7.0 (2025-06-25)

Features

• Add compressionQuality enum for generate_videos (4325773)
• Add enhance_input_image and image_preservation_factor fields for upscale_image (13eedda)
• Batches support in TS (dd7355e)
• expose the responseJsonSchema in GenerateContentConfig (db54a5f)

Bug Fixes

• live: support ArrayBuffer in WebSocket messages (5a8aeac), closes #714

1.6.0 (2025-06-21)

Features

• allow users to access headers for generateContent method and generateContentStream (f5f0e02)
• enable json schema for controlled output and function declaration. (7d53d57)
• Include status code and export HTTP errors (bcabcb6)
• support extra_body in HttpOptions (1d48b6e)

Bug Fixes

• Fix build errors when the mcp package is not installed. (5b7e695)

1.5.1 (2025-06-13)

Bug Fixes

• Update MCP dependencies to be type-only (648019b)

1.5.0 (2025-06-11)

Features

• add a timeout parameter to CallableToolConfig (06f31fd)
• Add datastore_spec field for VertexAISearch (1b18a52)
• Add support for Veo frame interpolation and video extension (53f22e6)
• Make the MCP SDK an optional peer dependency. (2472fd3)
• RAG - Introducing context storing for Gemini Live API. (bdc2355)

Bug Fixes

• Prioritize credentials over implicit api key (from env) for node client using Vertex AI (d82aba2), closes #616

1.4.0 (2025-06-04)

Features

• Add enhance_prompt field for Gemini Developer API generate_videos (ea3cc8e)
• Enable url_context for Vertex (e377f58)
• js: Support GEMINI_API_KEY as environment variable for setting API key. (97850ad)

Bug Fixes

• defined Type becomes TYPE_UNSPECIFIED when obfuscation is enabled (1ddf4f5)
• Update live SDK sample to address choppy audio quality (319bcbb)
• use Enum's value instead of keys for obfuscation. (132bd04)

1.3.0 (2025-05-30)

Features

• Adding thought_signature field to the Part to store the signature for thoughts. (20815b2)
• include UNEXPECTED_TOOL_CALL enum value to FinishReason for Vertex AI APIs. (bd5a2bf)
• Support ephemeral auth tokens as API keys for live connections in TS. (507bfb5)
• Support ephemeral token creation in TS (425cfe6)

Bug Fixes

• Rename LiveEphemeralParameters to LiveConnectConstraints. (86e9652)

1.2.0 (2025-05-28)

⚠ BREAKING CHANGES TO EXPERIMENTAL FEATURES

• Remove unsupported Lyria enum for music generation mode

Features

• Add generate_audio field for private testing of video generation (37e14c5)

Documentation

• fix README typo (04259ad)

Miscellaneous Chores

• Remove unsupported Lyria enum for music generation mode (0b935cd)

1.1.0 (2025-05-26)

Features

• Add CommonJS modules (f40c47c)
• support new fields in FileData, GenerationConfig, GroundingChunkRetrievedContext, RetrievalConfig, Schema, TuningJob, VertexAISearch, (cd04548)

1.0.1 (2025-05-22)

[!NOTE] This version drops support for end-of-life Node.js v18.

Bug Fixes

• After an error on sendMessage, all subsequent calls fail with the same error (778abcc)
• Fixed sendMessage subsequent calls test to follow the arrange-act-assert pattern (778abcc)
• Unbreak direct requires from node. (023efd5)

1.0.0 (2025-05-19)

⚠ BREAKING CHANGES

• Fix Lyria method name for JS, update parameters type

Features

• Support ephemeral token creation in Python (8e12730)
• Support using ephemeral token in Live session connection in Python (8e12730)

Bug Fixes

• allow McpClient to be passed in with AFC disabled. (b13f1f8)
• Blob handling in realtime music (f760755)
• Prevent MCP label from being appended multiple times if they already exist (c59ffe7)

Documentation

• No longer preview. (5e137d4)

Miscellaneous Chores

• Fix Lyria method name for JS, update parameters type (99dba6e)

0.15.0 (2025-05-19)

Features

• add time range filter to Google Search Tool (a938111)
• Add basic support for async function calling. (8e2f357)
• Add CallableToolConfig to specify behavior for FunctionDeclarations (c4148d0)
• add configurations for afc. (ce7855b)
• add live proactivity_audio and enable_affective_dialog (20e3892)
• Add Lyria Realtime music generation support for JS (aefcaa5)
• Add Lyria Realtime Music Types (99255d8)
• Add MCP telemetry usage to TS SDK. (09a83e9)
• add multi-speaker voice config (6fe6074)
• Add support for lat/long in search. (4cd79f6)
• Add support for MCP in TS SDK. (921a4be)
• add support for propertyOrdering field. (a77822b)
• Add Video FPS, and enable start/end_offset for MLDev (19f20e9)
• Enable AFC on Generate content stream (ff2ce35)
• export the createJsonSchemaValidator methods to be available for other library. (b3359a1)
• List all mcp tools to max and mcpToTool taking a spread. (44cd9c9)
• MCP: Add a new interface for automatic function calling (dc49ffc)
• MCP: Add mcpToTool to pass MCP clients for automatic function calling (825f385)
• Remove MCP Tool and MCP Client from ToolUnion (d35e16d)
• support customer-managed encryption key in cached content (3e7437a)
• Support Url Context Retrieval tool (aaaf9a9)

Bug Fixes

• Add an ES module for node environments. (ff4bbd1)
• Add default headers to model calls when MCP is enabled (9442eea)
• Allow contents with no-text thoughts in chat history (4112d1c)
• chats: Enforce internal management of chat history (abe592f)
• chats: Relax the constraint on chat turns (68115a8)
• make the system-test build. (dd7154c)
• move test-server-sdk from dependencies to devDependencies (233a909)
• Move test-server-sdk to devDependencies (#574) (b64deeb)
• Run tests against Node 24 (28a56ac)
• Skip MCP tool call when function name not present in the tool (9f3d360)

0.14.1 (2025-05-15)

Bug Fixes

• Move test-server-sdk to devDependencies (#574) (5913e59)

0.14.0 (2025-05-13)

Features

• Add Imagen edit_image support in JS SDK (6c99936)
• Add Imagen upscale_image support for JS (6fe1a68)
• add support for audio, video, text and session resumption in java. (e5542c6)
• support display_name for Blob class when calling Vertex AI (fc35f51)
• Support tuning checkpoints (6bd9c9e)

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)