TanStack · github-actions · Jun 9, 2026
diff --git a/.changeset/fal-billable-units-usage.md b/.changeset/fal-billable-units-usage.md
diff --git a/.changeset/gemini-model-meta-refresh.md b/.changeset/gemini-model-meta-refresh.md
diff --git a/packages/ai-anthropic/CHANGELOG.md b/packages/ai-anthropic/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/ai-anthropic
 
+## 0.15.2
+
+### Patch Changes
+
+- Updated dependencies [[`22c9b42`](https://github.com/TanStack/ai/commit/22c9b42baec74914b720e440f29bd02be04eb164)]:
+  - @tanstack/ai@0.29.0
+
 ## 0.15.1
 
 ### Patch Changes

diff --git a/packages/ai-anthropic/package.json b/packages/ai-anthropic/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-anthropic",
-  "version": "0.15.1",
+  "version": "0.15.2",
   "description": "Anthropic Claude adapter for TanStack AI chat, tool calling, thinking, and structured outputs.",
   "author": "",
   "license": "MIT",

diff --git a/packages/ai-client/CHANGELOG.md b/packages/ai-client/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-client
 
+## 0.16.4
+
+### Patch Changes
+
+- Updated dependencies [[`22c9b42`](https://github.com/TanStack/ai/commit/22c9b42baec74914b720e440f29bd02be04eb164)]:
+  - @tanstack/ai-event-client@0.6.0
+  - @tanstack/ai@0.29.0
+
 ## 0.16.3
 
 ### Patch Changes

diff --git a/packages/ai-client/package.json b/packages/ai-client/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-client",
-  "version": "0.16.3",
+  "version": "0.16.4",
   "description": "Framework-agnostic headless client for TanStack AI chat, realtime sessions, streaming transports, and media generations.",
   "author": "",
   "license": "MIT",

diff --git a/packages/ai-code-mode-skills/CHANGELOG.md b/packages/ai-code-mode-skills/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-code-mode-skills
 
+## 0.2.6
+
+### Patch Changes
+
+- Updated dependencies [[`22c9b42`](https://github.com/TanStack/ai/commit/22c9b42baec74914b720e440f29bd02be04eb164)]:
+  - @tanstack/ai@0.29.0
+  - @tanstack/ai-code-mode@0.2.6
+
 ## 0.2.5
 
 ### Patch Changes

diff --git a/packages/ai-code-mode-skills/package.json b/packages/ai-code-mode-skills/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-code-mode-skills",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Persistent runtime skill library for TanStack AI Code Mode agents and sandboxed tool orchestration.",
   "author": "",
   "license": "MIT",

diff --git a/packages/ai-code-mode/CHANGELOG.md b/packages/ai-code-mode/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/ai-code-mode
 
+## 0.2.6
+
+### Patch Changes
+
+- Updated dependencies [[`22c9b42`](https://github.com/TanStack/ai/commit/22c9b42baec74914b720e440f29bd02be04eb164)]:
+  - @tanstack/ai@0.29.0
+
 ## 0.2.5
 
 ### Patch Changes

diff --git a/packages/ai-code-mode/package.json b/packages/ai-code-mode/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-code-mode",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Secure TypeScript Code Mode for TanStack AI agents to execute sandboxed tool orchestration programs.",
   "author": "",
   "license": "MIT",

diff --git a/packages/ai-devtools/CHANGELOG.md b/packages/ai-devtools/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-devtools-core
 
+## 0.4.9
+
+### Patch Changes
+
+- Updated dependencies [[`22c9b42`](https://github.com/TanStack/ai/commit/22c9b42baec74914b720e440f29bd02be04eb164)]:
+  - @tanstack/ai-event-client@0.6.0
+  - @tanstack/ai@0.29.0
+
 ## 0.4.8
 
 ### Patch Changes

diff --git a/packages/ai-devtools/package.json b/packages/ai-devtools/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-devtools-core",
-  "version": "0.4.8",
+  "version": "0.4.9",
   "description": "Core TanStack AI Devtools plugin for inspecting chat messages, tool calls, streams, and errors.",
   "author": "",
   "license": "MIT",

diff --git a/packages/ai-elevenlabs/CHANGELOG.md b/packages/ai-elevenlabs/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-elevenlabs
 
+## 0.2.21
+
+### Patch Changes
+
+- Updated dependencies [[`22c9b42`](https://github.com/TanStack/ai/commit/22c9b42baec74914b720e440f29bd02be04eb164)]:
+  - @tanstack/ai@0.29.0
+  - @tanstack/ai-client@0.16.4
+
 ## 0.2.20
 
 ### Patch Changes

diff --git a/packages/ai-elevenlabs/package.json b/packages/ai-elevenlabs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-elevenlabs",
-  "version": "0.2.20",
+  "version": "0.2.21",
   "description": "ElevenLabs adapter for TanStack AI realtime voice, text-to-speech, transcription, music, and sound effects.",
   "author": "",
   "license": "MIT",

diff --git a/packages/ai-event-client/CHANGELOG.md b/packages/ai-event-client/CHANGELOG.md
@@ -1,5 +1,19 @@
 # @tanstack/ai-event-client
 
+## 0.6.0
+
+### Minor Changes
+
+- [#723](https://github.com/TanStack/ai/pull/723) [`22c9b42`](https://github.com/TanStack/ai/commit/22c9b42baec74914b720e440f29bd02be04eb164) - Surface fal's billed units as `result.usage`. The fal adapters now read fal's `x-fal-billable-units` response header off the result fetch and expose the billed quantity (`usage.unitsBilled`) on the generation result, so consumers can compute exact media-generation cost without wrapping `fetch` themselves.
+  - `TokenUsage` gains an optional `unitsBilled` field for usage-based (non-token) billing, denominated in the provider's priced unit.
+  - `falImage`, `falAudio`, `falVideo`, `falSpeech`, and `falTranscription` populate `result.usage.unitsBilled` when fal reports it.
+  - `VideoUrlResult` gains an optional `usage` slot; `getVideoJobStatus` now emits the `video:usage` event and returns `usage` when the completed result reports billed units.
+
+### Patch Changes
+
+- Updated dependencies [[`22c9b42`](https://github.com/TanStack/ai/commit/22c9b42baec74914b720e440f29bd02be04eb164)]:
+  - @tanstack/ai@0.29.0
+
 ## 0.5.4
 
 ### Patch Changes

diff --git a/packages/ai-event-client/package.json b/packages/ai-event-client/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-event-client",
-  "version": "0.5.4",
+  "version": "0.6.0",
   "description": "Typed event client for TanStack AI devtools, observability, and streamed runtime events.",
   "author": "",
   "license": "MIT",

diff --git a/packages/ai-fal/CHANGELOG.md b/packages/ai-fal/CHANGELOG.md
@@ -1,5 +1,19 @@
 # @tanstack/ai-fal
 
+## 0.8.0
+
+### Minor Changes
+
+- [#723](https://github.com/TanStack/ai/pull/723) [`22c9b42`](https://github.com/TanStack/ai/commit/22c9b42baec74914b720e440f29bd02be04eb164) - Surface fal's billed units as `result.usage`. The fal adapters now read fal's `x-fal-billable-units` response header off the result fetch and expose the billed quantity (`usage.unitsBilled`) on the generation result, so consumers can compute exact media-generation cost without wrapping `fetch` themselves.
+  - `TokenUsage` gains an optional `unitsBilled` field for usage-based (non-token) billing, denominated in the provider's priced unit.
+  - `falImage`, `falAudio`, `falVideo`, `falSpeech`, and `falTranscription` populate `result.usage.unitsBilled` when fal reports it.
+  - `VideoUrlResult` gains an optional `usage` slot; `getVideoJobStatus` now emits the `video:usage` event and returns `usage` when the completed result reports billed units.
+
+### Patch Changes
+
+- Updated dependencies [[`22c9b42`](https://github.com/TanStack/ai/commit/22c9b42baec74914b720e440f29bd02be04eb164)]:
+  - @tanstack/ai@0.29.0
+
 ## 0.7.23
 
 ### Patch Changes

diff --git a/packages/ai-fal/package.json b/packages/ai-fal/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-fal",
-  "version": "0.7.23",
+  "version": "0.8.0",
   "description": "fal.ai adapter for TanStack AI image, video, audio, speech, and transcription generation.",
   "author": "",
   "license": "MIT",

diff --git a/packages/ai-gemini/CHANGELOG.md b/packages/ai-gemini/CHANGELOG.md
@@ -1,5 +1,31 @@
 # @tanstack/ai-gemini
 
+## 0.16.0
+
+### Minor Changes
+
+- [#714](https://github.com/TanStack/ai/pull/714) [`efa76c8`](https://github.com/TanStack/ai/commit/efa76c8cdac37f402a0b35d74538ed2ae477e45c) - Sync Gemini model metadata with Google's current published model list ([#620](https://github.com/TanStack/ai/issues/620), [#621](https://github.com/TanStack/ai/issues/621)).
+
+  **Added**
+  - `gemini-3.1-flash-lite` (stable GA) — joins the existing `gemini-3.1-flash-lite-preview` entry and qualifies for the native combined tools + `responseSchema` streaming path (`GEMINI_COMBINED_TOOLS_AND_SCHEMA_MODELS`).
+
+  **Removed (retired by Google — these ids now 404 against the Gemini API or are no longer published)**
+  - `gemini-3-pro-preview` (verified 404; superseded by `gemini-3.1-pro-preview`)
+  - `gemini-2.5-flash-preview-09-2025` (superseded by stable `gemini-2.5-flash`)
+  - `gemini-2.5-flash-lite-preview-09-2025` (superseded by stable `gemini-2.5-flash-lite`)
+  - `gemini-2.0-flash` and `gemini-2.0-flash-lite` (2.0 line retired from Google's published list)
+  - `gemini-2.0-flash-preview-image-generation` (image; superseded by `gemini-2.5-flash-image`)
+
+  **Fixed**
+  - `gemini-3.5-flash` was missing from `GeminiChatModelToolCapabilitiesByName`, leaving its provider-tool typing broken.
+
+  If you were passing a removed id to `geminiText()` / `geminiSummarize()`, switch to the listed successor (e.g. `gemini-2.0-flash` → `gemini-2.5-flash`).
+
+### Patch Changes
+
+- Updated dependencies [[`22c9b42`](https://github.com/TanStack/ai/commit/22c9b42baec74914b720e440f29bd02be04eb164)]:
+  - @tanstack/ai@0.29.0
+
 ## 0.15.1
 
 ### Patch Changes

diff --git a/packages/ai-gemini/package.json b/packages/ai-gemini/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-gemini",
-  "version": "0.15.1",
+  "version": "0.16.0",
   "description": "Google Gemini adapter for TanStack AI chat, images, speech, audio generation, and structured outputs.",
   "author": "",
   "license": "MIT",

diff --git a/packages/ai-grok/CHANGELOG.md b/packages/ai-grok/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-grok
 
+## 0.11.3
+
+### Patch Changes
+
+- Updated dependencies [[`22c9b42`](https://github.com/TanStack/ai/commit/22c9b42baec74914b720e440f29bd02be04eb164)]:
+  - @tanstack/ai@0.29.0
+  - @tanstack/openai-base@0.8.2
+
 ## 0.11.2
 
 ### Patch Changes

diff --git a/packages/ai-grok/package.json b/packages/ai-grok/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-grok",
-  "version": "0.11.2",
+  "version": "0.11.3",
   "description": "xAI Grok adapter for TanStack AI chat, image generation, realtime, and structured outputs.",
   "author": "",
   "license": "MIT",

diff --git a/packages/ai-groq/CHANGELOG.md b/packages/ai-groq/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-groq
 
+## 0.4.3
+
+### Patch Changes
+
+- Updated dependencies [[`22c9b42`](https://github.com/TanStack/ai/commit/22c9b42baec74914b720e440f29bd02be04eb164)]:
+  - @tanstack/ai@0.29.0
+  - @tanstack/openai-base@0.8.2
+
 ## 0.4.2
 
 ### Patch Changes

diff --git a/packages/ai-groq/package.json b/packages/ai-groq/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-groq",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "type": "module",
   "description": "Groq adapter for TanStack AI low-latency chat, tool calling, and structured outputs.",
   "author": "",

diff --git a/packages/ai-isolate-cloudflare/CHANGELOG.md b/packages/ai-isolate-cloudflare/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/ai-isolate-cloudflare
 
+## 0.2.22
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/ai-code-mode@0.2.6
+
 ## 0.2.21
 
 ### Patch Changes

diff --git a/packages/ai-isolate-cloudflare/package.json b/packages/ai-isolate-cloudflare/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-isolate-cloudflare",
-  "version": "0.2.21",
+  "version": "0.2.22",
   "description": "Cloudflare Workers sandbox driver for TanStack AI Code Mode TypeScript execution at the edge.",
   "author": "",
   "license": "MIT",

diff --git a/packages/ai-isolate-node/CHANGELOG.md b/packages/ai-isolate-node/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/ai-isolate-node
 
+## 0.1.31
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/ai-code-mode@0.2.6
+
 ## 0.1.30
 
 ### Patch Changes

diff --git a/packages/ai-isolate-node/package.json b/packages/ai-isolate-node/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-isolate-node",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "Node.js isolated-vm sandbox driver for TanStack AI Code Mode TypeScript execution.",
   "author": "",
   "license": "MIT",

diff --git a/packages/ai-isolate-quickjs/CHANGELOG.md b/packages/ai-isolate-quickjs/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/ai-isolate-quickjs
 
+## 0.1.31
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/ai-code-mode@0.2.6
+
 ## 0.1.30
 
 ### Patch Changes

diff --git a/packages/ai-isolate-quickjs/package.json b/packages/ai-isolate-quickjs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-isolate-quickjs",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "QuickJS WASM sandbox driver for TanStack AI Code Mode TypeScript execution across runtimes.",
   "author": "",
   "license": "MIT",

diff --git a/packages/ai-mcp/CHANGELOG.md b/packages/ai-mcp/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/ai-mcp
 
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [[`22c9b42`](https://github.com/TanStack/ai/commit/22c9b42baec74914b720e440f29bd02be04eb164)]:
+  - @tanstack/ai@0.29.0
+
 ## 0.1.0
 
 ### Minor Changes

diff --git a/packages/ai-mcp/package.json b/packages/ai-mcp/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Host-side Model Context Protocol client for TanStack AI: discover and run MCP server tools, resources, and prompts in any adapter's chat() loop, with generated end-to-end types.",
   "license": "MIT",
   "repository": {