TanStack · AlemTuzlak · May 11, 2026 · May 11, 2026
diff --git a/.changeset/fix-gemini-thought-signature-part-level.md b/.changeset/fix-gemini-thought-signature-part-level.md
diff --git a/examples/ts-svelte-chat/CHANGELOG.md b/examples/ts-svelte-chat/CHANGELOG.md
@@ -1,5 +1,18 @@
 # ts-svelte-chat
 
+## 0.1.41
+
+### Patch Changes
+
+- Updated dependencies [[`87f305c`](https://github.com/TanStack/ai/commit/87f305c9961d608fd7bea93a5100698a98aed11d)]:
+  - @tanstack/ai-gemini@0.10.3
+  - @tanstack/ai@0.16.0
+  - @tanstack/ai-anthropic@0.8.6
+  - @tanstack/ai-client@0.9.1
+  - @tanstack/ai-ollama@0.6.13
+  - @tanstack/ai-openai@0.8.5
+  - @tanstack/ai-svelte@0.7.2
+
 ## 0.1.40
 
 ### Patch Changes

diff --git a/examples/ts-svelte-chat/package.json b/examples/ts-svelte-chat/package.json
@@ -1,7 +1,7 @@
 {
   "name": "ts-svelte-chat",
   "private": true,
-  "version": "0.1.40",
+  "version": "0.1.41",
   "type": "module",
   "scripts": {
     "dev": "vite dev --port 3000",

diff --git a/examples/ts-vue-chat/CHANGELOG.md b/examples/ts-vue-chat/CHANGELOG.md
@@ -1,5 +1,19 @@
 # ts-vue-chat
 
+## 0.1.41
+
+### Patch Changes
+
+- Updated dependencies [[`87f305c`](https://github.com/TanStack/ai/commit/87f305c9961d608fd7bea93a5100698a98aed11d)]:
+  - @tanstack/ai-gemini@0.10.3
+  - @tanstack/ai@0.16.0
+  - @tanstack/ai-anthropic@0.8.6
+  - @tanstack/ai-client@0.9.1
+  - @tanstack/ai-ollama@0.6.13
+  - @tanstack/ai-openai@0.8.5
+  - @tanstack/ai-vue@0.7.2
+  - @tanstack/ai-vue-ui@0.1.33
+
 ## 0.1.40
 
 ### Patch Changes

diff --git a/examples/ts-vue-chat/package.json b/examples/ts-vue-chat/package.json
@@ -1,6 +1,6 @@
 {
   "name": "ts-vue-chat",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "private": true,
   "type": "module",
   "scripts": {

diff --git a/examples/vanilla-chat/CHANGELOG.md b/examples/vanilla-chat/CHANGELOG.md
@@ -1,5 +1,12 @@
 # vanilla-chat
 
+## 0.0.37
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/ai-client@0.9.1
+
 ## 0.0.36
 
 ### Patch Changes

diff --git a/examples/vanilla-chat/package.json b/examples/vanilla-chat/package.json
@@ -2,7 +2,7 @@
   "name": "vanilla-chat",
   "private": true,
   "type": "module",
-  "version": "0.0.36",
+  "version": "0.0.37",
   "scripts": {
     "start": "vite --port 3001",
     "dev": "vite --port 3001",

diff --git a/packages/typescript/ai-anthropic/CHANGELOG.md b/packages/typescript/ai-anthropic/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/ai-anthropic
 
+## 0.8.6
+
+### Patch Changes
+
+- Updated dependencies [[`87f305c`](https://github.com/TanStack/ai/commit/87f305c9961d608fd7bea93a5100698a98aed11d)]:
+  - @tanstack/ai@0.16.0
+
 ## 0.8.5
 
 ### Patch Changes

diff --git a/packages/typescript/ai-anthropic/package.json b/packages/typescript/ai-anthropic/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-anthropic",
-  "version": "0.8.5",
+  "version": "0.8.6",
   "description": "Anthropic Claude adapter for TanStack AI",
   "author": "",
   "license": "MIT",

diff --git a/packages/typescript/ai-client/CHANGELOG.md b/packages/typescript/ai-client/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-client
 
+## 0.9.1
+
+### Patch Changes
+
+- Updated dependencies [[`87f305c`](https://github.com/TanStack/ai/commit/87f305c9961d608fd7bea93a5100698a98aed11d)]:
+  - @tanstack/ai@0.16.0
+  - @tanstack/ai-event-client@0.3.0
+
 ## 0.9.0
 
 ### Minor Changes

diff --git a/packages/typescript/ai-client/package.json b/packages/typescript/ai-client/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-client",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Framework-agnostic headless client for TanStack AI",
   "author": "",
   "license": "MIT",

diff --git a/packages/typescript/ai-code-mode-skills/CHANGELOG.md b/packages/typescript/ai-code-mode-skills/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-code-mode-skills
 
+## 0.1.10
+
+### Patch Changes
+
+- Updated dependencies [[`87f305c`](https://github.com/TanStack/ai/commit/87f305c9961d608fd7bea93a5100698a98aed11d)]:
+  - @tanstack/ai@0.16.0
+  - @tanstack/ai-code-mode@0.1.10
+
 ## 0.1.9
 
 ### Patch Changes

diff --git a/packages/typescript/ai-code-mode-skills/package.json b/packages/typescript/ai-code-mode-skills/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-code-mode-skills",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Persistent skill library for TanStack AI Code Mode - LLM-created reusable code snippets",
   "author": "",
   "license": "MIT",

diff --git a/packages/typescript/ai-code-mode/CHANGELOG.md b/packages/typescript/ai-code-mode/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/ai-code-mode
 
+## 0.1.10
+
+### Patch Changes
+
+- Updated dependencies [[`87f305c`](https://github.com/TanStack/ai/commit/87f305c9961d608fd7bea93a5100698a98aed11d)]:
+  - @tanstack/ai@0.16.0
+
 ## 0.1.9
 
 ### Patch Changes

diff --git a/packages/typescript/ai-code-mode/models-eval/CHANGELOG.md b/packages/typescript/ai-code-mode/models-eval/CHANGELOG.md
@@ -1,5 +1,20 @@
 # @tanstack/ai-code-mode-models-eval
 
+## 0.0.15
+
+### Patch Changes
+
+- Updated dependencies [[`87f305c`](https://github.com/TanStack/ai/commit/87f305c9961d608fd7bea93a5100698a98aed11d)]:
+  - @tanstack/ai-gemini@0.10.3
+  - @tanstack/ai@0.16.0
+  - @tanstack/ai-anthropic@0.8.6
+  - @tanstack/ai-code-mode@0.1.10
+  - @tanstack/ai-grok@0.7.3
+  - @tanstack/ai-groq@0.1.11
+  - @tanstack/ai-ollama@0.6.13
+  - @tanstack/ai-openai@0.8.5
+  - @tanstack/ai-isolate-node@0.1.10
+
 ## 0.0.14
 
 ### Patch Changes

diff --git a/packages/typescript/ai-code-mode/models-eval/package.json b/packages/typescript/ai-code-mode/models-eval/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-code-mode-models-eval",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "private": true,
   "type": "module",
   "description": "Dev benchmark: local/cloud models vs code-mode database-demo gold (not published)",

diff --git a/packages/typescript/ai-code-mode/package.json b/packages/typescript/ai-code-mode/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-code-mode",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Code Mode for TanStack AI - LLM-driven code execution in secure sandboxes",
   "author": "",
   "license": "MIT",

diff --git a/packages/typescript/ai-devtools/CHANGELOG.md b/packages/typescript/ai-devtools/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-devtools-core
 
+## 0.3.27
+
+### Patch Changes
+
+- Updated dependencies [[`87f305c`](https://github.com/TanStack/ai/commit/87f305c9961d608fd7bea93a5100698a98aed11d)]:
+  - @tanstack/ai@0.16.0
+  - @tanstack/ai-event-client@0.3.0
+
 ## 0.3.26
 
 ### Patch Changes

diff --git a/packages/typescript/ai-devtools/package.json b/packages/typescript/ai-devtools/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-devtools-core",
-  "version": "0.3.26",
+  "version": "0.3.27",
   "description": "Core TanStack AI Devtools",
   "author": "",
   "license": "MIT",

diff --git a/packages/typescript/ai-elevenlabs/CHANGELOG.md b/packages/typescript/ai-elevenlabs/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-elevenlabs
 
+## 0.2.3
+
+### Patch Changes
+
+- Updated dependencies [[`87f305c`](https://github.com/TanStack/ai/commit/87f305c9961d608fd7bea93a5100698a98aed11d)]:
+  - @tanstack/ai@0.16.0
+  - @tanstack/ai-client@0.9.1
+
 ## 0.2.2
 
 ### Patch Changes

diff --git a/packages/typescript/ai-elevenlabs/package.json b/packages/typescript/ai-elevenlabs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-elevenlabs",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "ElevenLabs adapter for TanStack AI realtime voice",
   "author": "",
   "license": "MIT",

diff --git a/packages/typescript/ai-event-client/CHANGELOG.md b/packages/typescript/ai-event-client/CHANGELOG.md
@@ -1,5 +1,33 @@
 # @tanstack/ai-event-client
 
+## 0.3.0
+
+### Minor Changes
+
+- fix(ai-gemini): read/write thoughtSignature at Part level + thread typed metadata through tool-call lifecycle ([#459](https://github.com/TanStack/ai/pull/459))
+
+  Two fixes shipped together because the adapter fix is only effective once the framework also preserves provider metadata across the tool-call round-trip.
+
+  **Adapter (Gemini):** Gemini emits `thoughtSignature` as a Part-level sibling of `functionCall` (per the `@google/genai` `Part` type definition), not nested inside `functionCall`. The `FunctionCall` type has never had a `thoughtSignature` property. The adapter was reading from `functionCall.thoughtSignature` (does not exist in SDK types) and writing it back nested inside `functionCall`, causing Gemini 3.x to reject subsequent tool-call turns with `400 INVALID_ARGUMENT: "Function call is missing a thought_signature"`.
+  - **Read side:** reads `part.thoughtSignature` directly using the SDK's typed `Part` interface
+  - **Write side:** emits `thoughtSignature` as a Part-level sibling of `functionCall`
+
+  **Framework (typed tool-call metadata):**
+  - `ToolCall.providerMetadata: Record<string, unknown>` is now `ToolCall<TMetadata>.metadata?: TMetadata`, mirroring the existing typed-metadata pattern on content parts (`ImagePart<TMetadata>`, `AudioPart<TMetadata>`, etc.).
+  - `ToolCallPart` gains a typed `metadata?: TMetadata` field (also generic).
+  - `ToolCallStartEvent.providerMetadata` becomes `metadata` (kept as `Record<string, unknown>` because the AGUIEvent discriminated union does not survive a generic on the event type; adapters cast to their typed shape when emitting).
+  - `BaseTextAdapter` and `TextAdapter` gain a sixth generic `TToolCallMetadata` (default `unknown`), exposed via `~types.toolCallMetadata` for inference at call sites.
+  - `InternalToolCallState` gains a `metadata?: Record<string, unknown>` field captured at `TOOL_CALL_START` and threaded through `updateToolCallPart`, `buildAssistantMessages`, `modelMessageToUIMessage`, and `completeToolCall`, fixing a previously-silent drop of provider metadata across the client-side UIMessage pipeline (closes the gap surfaced in #403/#404).
+
+  **Gemini concrete impl:** new `GeminiToolCallMetadata { thoughtSignature?: string }` exported from `@tanstack/ai-gemini`. The adapter declares its `TToolCallMetadata` as this type, so consumers see `toolCall.metadata?.thoughtSignature` typed end-to-end.
+
+  **Breaking:** consumers reading `toolCall.providerMetadata` or `toolCallStartEvent.providerMetadata` should rename to `metadata`.
+
+### Patch Changes
+
+- Updated dependencies [[`87f305c`](https://github.com/TanStack/ai/commit/87f305c9961d608fd7bea93a5100698a98aed11d)]:
+  - @tanstack/ai@0.16.0
+
 ## 0.2.9
 
 ### Patch Changes

diff --git a/packages/typescript/ai-event-client/package.json b/packages/typescript/ai-event-client/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-event-client",
-  "version": "0.2.9",
+  "version": "0.3.0",
   "description": "Event client for TanStack AI devtools integration",
   "author": "",
   "license": "MIT",

diff --git a/packages/typescript/ai-fal/CHANGELOG.md b/packages/typescript/ai-fal/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/ai-fal
 
+## 0.7.3
+
+### Patch Changes
+
+- Updated dependencies [[`87f305c`](https://github.com/TanStack/ai/commit/87f305c9961d608fd7bea93a5100698a98aed11d)]:
+  - @tanstack/ai@0.16.0
+
 ## 0.7.2
 
 ### Patch Changes

diff --git a/packages/typescript/ai-fal/package.json b/packages/typescript/ai-fal/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-fal",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "fal.ai adapter for TanStack AI",
   "author": "",
   "license": "MIT",

diff --git a/packages/typescript/ai-gemini/CHANGELOG.md b/packages/typescript/ai-gemini/CHANGELOG.md
@@ -1,5 +1,31 @@
 # @tanstack/ai-gemini
 
+## 0.10.3
+
+### Patch Changes
+
+- fix(ai-gemini): read/write thoughtSignature at Part level + thread typed metadata through tool-call lifecycle ([#459](https://github.com/TanStack/ai/pull/459))
+
+  Two fixes shipped together because the adapter fix is only effective once the framework also preserves provider metadata across the tool-call round-trip.
+
+  **Adapter (Gemini):** Gemini emits `thoughtSignature` as a Part-level sibling of `functionCall` (per the `@google/genai` `Part` type definition), not nested inside `functionCall`. The `FunctionCall` type has never had a `thoughtSignature` property. The adapter was reading from `functionCall.thoughtSignature` (does not exist in SDK types) and writing it back nested inside `functionCall`, causing Gemini 3.x to reject subsequent tool-call turns with `400 INVALID_ARGUMENT: "Function call is missing a thought_signature"`.
+  - **Read side:** reads `part.thoughtSignature` directly using the SDK's typed `Part` interface
+  - **Write side:** emits `thoughtSignature` as a Part-level sibling of `functionCall`
+
+  **Framework (typed tool-call metadata):**
+  - `ToolCall.providerMetadata: Record<string, unknown>` is now `ToolCall<TMetadata>.metadata?: TMetadata`, mirroring the existing typed-metadata pattern on content parts (`ImagePart<TMetadata>`, `AudioPart<TMetadata>`, etc.).
+  - `ToolCallPart` gains a typed `metadata?: TMetadata` field (also generic).
+  - `ToolCallStartEvent.providerMetadata` becomes `metadata` (kept as `Record<string, unknown>` because the AGUIEvent discriminated union does not survive a generic on the event type; adapters cast to their typed shape when emitting).
+  - `BaseTextAdapter` and `TextAdapter` gain a sixth generic `TToolCallMetadata` (default `unknown`), exposed via `~types.toolCallMetadata` for inference at call sites.
+  - `InternalToolCallState` gains a `metadata?: Record<string, unknown>` field captured at `TOOL_CALL_START` and threaded through `updateToolCallPart`, `buildAssistantMessages`, `modelMessageToUIMessage`, and `completeToolCall`, fixing a previously-silent drop of provider metadata across the client-side UIMessage pipeline (closes the gap surfaced in #403/#404).
+
+  **Gemini concrete impl:** new `GeminiToolCallMetadata { thoughtSignature?: string }` exported from `@tanstack/ai-gemini`. The adapter declares its `TToolCallMetadata` as this type, so consumers see `toolCall.metadata?.thoughtSignature` typed end-to-end.
+
+  **Breaking:** consumers reading `toolCall.providerMetadata` or `toolCallStartEvent.providerMetadata` should rename to `metadata`.
+
+- Updated dependencies [[`87f305c`](https://github.com/TanStack/ai/commit/87f305c9961d608fd7bea93a5100698a98aed11d)]:
+  - @tanstack/ai@0.16.0
+
 ## 0.10.2
 
 ### Patch Changes

diff --git a/packages/typescript/ai-gemini/package.json b/packages/typescript/ai-gemini/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-gemini",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "Google Gemini adapter for TanStack AI",
   "author": "",
   "license": "MIT",

diff --git a/packages/typescript/ai-grok/CHANGELOG.md b/packages/typescript/ai-grok/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-grok
 
+## 0.7.3
+
+### Patch Changes
+
+- Updated dependencies [[`87f305c`](https://github.com/TanStack/ai/commit/87f305c9961d608fd7bea93a5100698a98aed11d)]:
+  - @tanstack/ai@0.16.0
+  - @tanstack/openai-base@0.2.1
+
 ## 0.7.2
 
 ### Patch Changes

diff --git a/packages/typescript/ai-grok/package.json b/packages/typescript/ai-grok/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-grok",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "Grok (xAI) adapter for TanStack AI",
   "author": "",
   "license": "MIT",