From 4145af096cf2b1572ab75d83e468f1d3187a864b Mon Sep 17 00:00:00 2001
From: Flo <me@florianpellet.com>
Date: Fri, 22 May 2026 11:48:44 +0200
Subject: [PATCH 01/10] chore: enforce pnpm 11 (#617)

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 3a71835b7..5cf213f23 100644
--- a/package.json
+++ b/package.json
@@ -8,7 +8,7 @@
   "packageManager": "pnpm@11.1.1",
   "type": "module",
   "engines": {
-    "pnpm": ">=10.17.0"
+    "pnpm": ">=11.0.0"
   },
   "scripts": {
     "clean": "pnpm --filter \"./packages/**\" run clean",

From ad2eecce8f6cc737b996f0ed2acca61ef4a54d4d Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Fri, 22 May 2026 11:49:30 +0200
Subject: [PATCH 02/10] chore: sync model metadata from OpenRouter (#623)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
---
 .changeset/sync-models.md                     |   5 +
 .../ai-openrouter/src/model-meta.ts           | 116 ++++++++------
 scripts/.sync-models-last-run                 |   2 +-
 scripts/openrouter.models.json                | 143 ++++++++++--------
 4 files changed, 149 insertions(+), 117 deletions(-)
 create mode 100644 .changeset/sync-models.md

diff --git a/.changeset/sync-models.md b/.changeset/sync-models.md
new file mode 100644
index 000000000..63eef764c
--- /dev/null
+++ b/.changeset/sync-models.md
@@ -0,0 +1,5 @@
+---
+'@tanstack/ai-openrouter': patch
+---
+
+Update model metadata from OpenRouter API
diff --git a/packages/typescript/ai-openrouter/src/model-meta.ts b/packages/typescript/ai-openrouter/src/model-meta.ts
index 55e1ac47c..bc273258a 100644
--- a/packages/typescript/ai-openrouter/src/model-meta.ts
+++ b/packages/typescript/ai-openrouter/src/model-meta.ts
@@ -1122,28 +1122,6 @@ const ARCEE_AI_SPOTLIGHT = {
     image: 0,
   },
 } as const
-const ARCEE_AI_TRINITY_LARGE_PREVIEW = {
-  id: 'arcee-ai/trinity-large-preview',
-  name: 'Arcee AI: Trinity Large Preview',
-  supports: {
-    input: ['text'],
-    output: ['text'],
-    supports: ['maxCompletionTokens', 'responseFormat', 'temperature', 'topP'],
-  },
-  context_window: 131000,
-  pricing: {
-    text: {
-      input: {
-        normal: 0.15,
-        cached: 0,
-      },
-      output: {
-        normal: 0.45,
-      },
-    },
-    image: 0,
-  },
-} as const
 const ARCEE_AI_TRINITY_LARGE_THINKING = {
   id: 'arcee-ai/trinity-large-thinking',
   name: 'Arcee AI: Trinity Large Thinking',
@@ -9509,7 +9487,7 @@ const QWEN_QWEN3_5_122B_A10B = {
     ],
   },
   context_window: 262144,
-  max_output_tokens: 65536,
+  max_output_tokens: 262144,
   pricing: {
     text: {
       input: {
@@ -9789,11 +9767,11 @@ const QWEN_QWEN3_6_27B = {
     ],
   },
   context_window: 262144,
-  max_output_tokens: 81920,
+  max_output_tokens: 262144,
   pricing: {
     text: {
       input: {
-        normal: 0.32,
+        normal: 0.3,
         cached: 0,
       },
       output: {
@@ -9826,11 +9804,12 @@ const QWEN_QWEN3_6_35B_A3B = {
     ],
   },
   context_window: 262144,
+  max_output_tokens: 262144,
   pricing: {
     text: {
       input: {
-        normal: 0.149,
-        cached: 0,
+        normal: 0.15,
+        cached: 0.05,
       },
       output: {
         normal: 1,
@@ -9861,11 +9840,11 @@ const QWEN_QWEN3_6_FLASH = {
   pricing: {
     text: {
       input: {
-        normal: 0.1875,
-        cached: 0.234375,
+        normal: 0.12375,
+        cached: 0.1545,
       },
       output: {
-        normal: 1.125,
+        normal: 0.7425,
       },
     },
     image: 0,
@@ -9927,11 +9906,45 @@ const QWEN_QWEN3_6_PLUS = {
   pricing: {
     text: {
       input: {
-        normal: 0.325,
-        cached: 0.40625,
+        normal: 0.1794,
+        cached: 0.2236,
+      },
+      output: {
+        normal: 1.07315,
+      },
+    },
+    image: 0,
+  },
+} as const
+const QWEN_QWEN3_7_MAX = {
+  id: 'qwen/qwen3.7-max',
+  name: 'Qwen: Qwen3.7 Max',
+  supports: {
+    input: ['text'],
+    output: ['text'],
+    supports: [
+      'logprobs',
+      'maxCompletionTokens',
+      'presencePenalty',
+      'reasoning',
+      'responseFormat',
+      'seed',
+      'temperature',
+      'toolChoice',
+      'topLogprobs',
+      'topP',
+    ],
+  },
+  context_window: 1000000,
+  max_output_tokens: 65536,
+  pricing: {
+    text: {
+      input: {
+        normal: 2.5,
+        cached: 3.125,
       },
       output: {
-        normal: 1.95,
+        normal: 7.5,
       },
     },
     image: 0,
@@ -11251,16 +11264,15 @@ const Z_AI_GLM_5_1 = {
       'topP',
     ],
   },
-  context_window: 202800,
-  max_output_tokens: 202800,
+  context_window: 202752,
   pricing: {
     text: {
       input: {
-        normal: 0,
-        cached: 0,
+        normal: 0.98,
+        cached: 0.182,
       },
       output: {
-        normal: 0,
+        normal: 3.08,
       },
     },
     image: 0,
@@ -11663,11 +11675,6 @@ export type OpenRouterModelOptionsByName = {
       | 'temperature'
       | 'topP'
     >
-  [ARCEE_AI_TRINITY_LARGE_PREVIEW.id]: OpenRouterCommonOptions &
-    Pick<
-      OpenRouterBaseOptions,
-      'maxCompletionTokens' | 'responseFormat' | 'temperature' | 'topP'
-    >
   [ARCEE_AI_TRINITY_LARGE_THINKING.id]: OpenRouterCommonOptions &
     Pick<
       OpenRouterBaseOptions,
@@ -15045,6 +15052,20 @@ export type OpenRouterModelOptionsByName = {
       | 'toolChoice'
       | 'topP'
     >
+  [QWEN_QWEN3_7_MAX.id]: OpenRouterCommonOptions &
+    Pick<
+      OpenRouterBaseOptions,
+      | 'logprobs'
+      | 'maxCompletionTokens'
+      | 'presencePenalty'
+      | 'reasoning'
+      | 'responseFormat'
+      | 'seed'
+      | 'temperature'
+      | 'toolChoice'
+      | 'topLogprobs'
+      | 'topP'
+    >
   [REKAAI_REKA_EDGE.id]: OpenRouterCommonOptions &
     Pick<
       OpenRouterBaseOptions,
@@ -15634,7 +15655,6 @@ export type OpenRouterModelInputModalitiesByName = {
   [ARCEE_AI_CODER_LARGE.id]: ReadonlyArray<'text'>
   [ARCEE_AI_MAESTRO_REASONING.id]: ReadonlyArray<'text'>
   [ARCEE_AI_SPOTLIGHT.id]: ReadonlyArray<'image' | 'text'>
-  [ARCEE_AI_TRINITY_LARGE_PREVIEW.id]: ReadonlyArray<'text'>
   [ARCEE_AI_TRINITY_LARGE_THINKING.id]: ReadonlyArray<'text'>
   [ARCEE_AI_TRINITY_LARGE_THINKING_FREE.id]: ReadonlyArray<'text'>
   [ARCEE_AI_TRINITY_MINI.id]: ReadonlyArray<'text'>
@@ -15954,6 +15974,7 @@ export type OpenRouterModelInputModalitiesByName = {
   [QWEN_QWEN3_6_FLASH.id]: ReadonlyArray<'text' | 'image' | 'video'>
   [QWEN_QWEN3_6_MAX_PREVIEW.id]: ReadonlyArray<'text'>
   [QWEN_QWEN3_6_PLUS.id]: ReadonlyArray<'text' | 'image' | 'video'>
+  [QWEN_QWEN3_7_MAX.id]: ReadonlyArray<'text'>
   [REKAAI_REKA_EDGE.id]: ReadonlyArray<'image' | 'text' | 'video'>
   [REKAAI_REKA_FLASH_3.id]: ReadonlyArray<'text'>
   [RELACE_RELACE_APPLY_3.id]: ReadonlyArray<'text'>
@@ -16040,7 +16061,6 @@ export const OPENROUTER_CHAT_MODELS = [
   ARCEE_AI_CODER_LARGE.id,
   ARCEE_AI_MAESTRO_REASONING.id,
   ARCEE_AI_SPOTLIGHT.id,
-  ARCEE_AI_TRINITY_LARGE_PREVIEW.id,
   ARCEE_AI_TRINITY_LARGE_THINKING.id,
   ARCEE_AI_TRINITY_LARGE_THINKING_FREE.id,
   ARCEE_AI_TRINITY_MINI.id,
@@ -16312,6 +16332,7 @@ export const OPENROUTER_CHAT_MODELS = [
   QWEN_QWEN3_6_FLASH.id,
   QWEN_QWEN3_6_MAX_PREVIEW.id,
   QWEN_QWEN3_6_PLUS.id,
+  QWEN_QWEN3_7_MAX.id,
   REKAAI_REKA_EDGE.id,
   REKAAI_REKA_FLASH_3.id,
   RELACE_RELACE_APPLY_3.id,
@@ -16358,10 +16379,7 @@ export const OPENROUTER_CHAT_MODELS = [
 ] as const
 
 export type OpenRouterChatModelToolCapabilitiesByName = {
-  [K in (typeof OPENROUTER_CHAT_MODELS)[number]]: readonly [
-    'web_search',
-    'web_fetch',
-  ]
+  [K in (typeof OPENROUTER_CHAT_MODELS)[number]]: readonly ['web_search']
 }
 
 export const OPENROUTER_IMAGE_MODELS = [
diff --git a/scripts/.sync-models-last-run b/scripts/.sync-models-last-run
index 667c322d9..1f83e39bc 100644
--- a/scripts/.sync-models-last-run
+++ b/scripts/.sync-models-last-run
@@ -1 +1 @@
-1779353499
+1779439521
diff --git a/scripts/openrouter.models.json b/scripts/openrouter.models.json
index 4cbc7a457..9cd7a646e 100644
--- a/scripts/openrouter.models.json
+++ b/scripts/openrouter.models.json
@@ -1918,55 +1918,6 @@
       "details": "/api/v1/models/arcee-ai/spotlight/endpoints"
     }
   },
-  {
-    "id": "arcee-ai/trinity-large-preview",
-    "canonical_slug": "arcee-ai/trinity-large-preview",
-    "hugging_face_id": "arcee-ai/Trinity-Large-Preview",
-    "name": "Arcee AI: Trinity Large Preview",
-    "created": 1769552670,
-    "description": "Trinity-Large-Preview is a frontier-scale open-weight language model from Arcee, built as a 400B-parameter sparse Mixture-of-Experts with 13B active parameters per token using 4-of-256 expert routing. It excels in creative writing,...",
-    "context_length": 131000,
-    "architecture": {
-      "modality": "text->text",
-      "input_modalities": ["text"],
-      "output_modalities": ["text"],
-      "tokenizer": "Other",
-      "instruct_type": null
-    },
-    "pricing": {
-      "prompt": "0.00000015",
-      "completion": "0.00000045"
-    },
-    "top_provider": {
-      "context_length": 131000,
-      "max_completion_tokens": null,
-      "is_moderated": false
-    },
-    "per_request_limits": null,
-    "supported_parameters": [
-      "max_tokens",
-      "response_format",
-      "structured_outputs",
-      "temperature",
-      "tools",
-      "top_k",
-      "top_p"
-    ],
-    "default_parameters": {
-      "temperature": 0.8,
-      "top_p": 0.8,
-      "top_k": null,
-      "frequency_penalty": null,
-      "presence_penalty": null,
-      "repetition_penalty": null
-    },
-    "supported_voices": null,
-    "knowledge_cutoff": null,
-    "expiration_date": "2026-05-21",
-    "links": {
-      "details": "/api/v1/models/arcee-ai/trinity-large-preview/endpoints"
-    }
-  },
   {
     "id": "arcee-ai/trinity-large-thinking",
     "canonical_slug": "arcee-ai/trinity-large-thinking",
@@ -2499,7 +2450,7 @@
     },
     "supported_voices": null,
     "knowledge_cutoff": null,
-    "expiration_date": null,
+    "expiration_date": "2026-05-28",
     "links": {
       "details": "/api/v1/models/baidu/qianfan-ocr-fast-20260420/endpoints"
     }
@@ -15170,7 +15121,7 @@
     },
     "top_provider": {
       "context_length": 262144,
-      "max_completion_tokens": 65536,
+      "max_completion_tokens": 262144,
       "is_moderated": false
     },
     "per_request_limits": null,
@@ -15618,12 +15569,12 @@
       "instruct_type": null
     },
     "pricing": {
-      "prompt": "0.00000032",
+      "prompt": "0.0000003",
       "completion": "0.0000032"
     },
     "top_provider": {
       "context_length": 262144,
-      "max_completion_tokens": 81920,
+      "max_completion_tokens": 262144,
       "is_moderated": false
     },
     "per_request_limits": null,
@@ -15679,12 +15630,13 @@
       "instruct_type": null
     },
     "pricing": {
-      "prompt": "0.000000149",
-      "completion": "0.000001"
+      "prompt": "0.00000015",
+      "completion": "0.000001",
+      "input_cache_read": "0.00000005"
     },
     "top_provider": {
       "context_length": 262144,
-      "max_completion_tokens": null,
+      "max_completion_tokens": 262144,
       "is_moderated": false
     },
     "per_request_limits": null,
@@ -15737,9 +15689,9 @@
       "instruct_type": null
     },
     "pricing": {
-      "prompt": "0.0000001875",
-      "completion": "0.000001125",
-      "input_cache_write": "0.000000234375"
+      "prompt": "0.00000012375",
+      "completion": "0.0000007425",
+      "input_cache_write": "0.0000001545"
     },
     "top_provider": {
       "context_length": 1000000,
@@ -15833,9 +15785,9 @@
       "instruct_type": null
     },
     "pricing": {
-      "prompt": "0.000000325",
-      "completion": "0.00000195",
-      "input_cache_write": "0.00000040625"
+      "prompt": "0.0000001794",
+      "completion": "0.00000107315",
+      "input_cache_write": "0.0000002236"
     },
     "top_provider": {
       "context_length": 1000000,
@@ -15871,6 +15823,62 @@
       "details": "/api/v1/models/qwen/qwen3.6-plus-04-02/endpoints"
     }
   },
+  {
+    "id": "qwen/qwen3.7-max",
+    "canonical_slug": "qwen/qwen3.7-max-20260520",
+    "hugging_face_id": null,
+    "name": "Qwen: Qwen3.7 Max",
+    "created": 1779376861,
+    "description": "Qwen3.7-Max is the flagship model in Alibaba's Qwen3.7 series. It supports text input and output and is designed for agent-centric workloads, with particular strengths in coding, office and productivity tasks,...",
+    "context_length": 1000000,
+    "architecture": {
+      "modality": "text->text",
+      "input_modalities": ["text"],
+      "output_modalities": ["text"],
+      "tokenizer": "Qwen",
+      "instruct_type": null
+    },
+    "pricing": {
+      "prompt": "0.0000025",
+      "completion": "0.0000075",
+      "input_cache_write": "0.000003125"
+    },
+    "top_provider": {
+      "context_length": 1000000,
+      "max_completion_tokens": 65536,
+      "is_moderated": false
+    },
+    "per_request_limits": null,
+    "supported_parameters": [
+      "include_reasoning",
+      "logprobs",
+      "max_tokens",
+      "presence_penalty",
+      "reasoning",
+      "response_format",
+      "seed",
+      "structured_outputs",
+      "temperature",
+      "tool_choice",
+      "tools",
+      "top_logprobs",
+      "top_p"
+    ],
+    "default_parameters": {
+      "temperature": null,
+      "top_p": null,
+      "top_k": null,
+      "frequency_penalty": null,
+      "presence_penalty": null,
+      "repetition_penalty": null
+    },
+    "supported_voices": null,
+    "knowledge_cutoff": null,
+    "expiration_date": null,
+    "links": {
+      "details": "/api/v1/models/qwen/qwen3.7-max-20260520/endpoints"
+    }
+  },
   {
     "id": "rekaai/reka-edge",
     "canonical_slug": "rekaai/reka-edge-2603",
@@ -17945,7 +17953,7 @@
     "name": "Z.ai: GLM 5.1",
     "created": 1775578025,
     "description": "GLM-5.1 delivers a major leap in coding capability, with particularly significant gains in handling long-horizon tasks. Unlike previous models built around minute-level interactions, GLM-5.1 can work independently and continuously on...",
-    "context_length": 202800,
+    "context_length": 202752,
     "architecture": {
       "modality": "text->text",
       "input_modalities": ["text"],
@@ -17954,12 +17962,13 @@
       "instruct_type": null
     },
     "pricing": {
-      "prompt": "0",
-      "completion": "0"
+      "prompt": "0.00000098",
+      "completion": "0.00000308",
+      "input_cache_read": "0.000000182"
     },
     "top_provider": {
-      "context_length": 202800,
-      "max_completion_tokens": 202800,
+      "context_length": 202752,
+      "max_completion_tokens": null,
       "is_moderated": false
     },
     "per_request_limits": null,

From fec6162f1fee05a9dc31c4fac3a8ac1976f8731f Mon Sep 17 00:00:00 2001
From: Alem Tuzlak <t.zlak@hotmail.com>
Date: Fri, 22 May 2026 12:43:16 +0200
Subject: [PATCH 03/10] feat(ai-openai): add gpt-image-2 to image model meta
 (#625)

* feat(ai-openai): add gpt-image-2 to image model meta

Adds `gpt-image-2` to OPENAI_IMAGE_MODELS so it can be used through
openaiImage adapters. Reuses the gpt-image-1 provider-options/size
shape (quality, background, output_format, output_compression,
moderation, partial_images; sizes 1024x1024 / 1536x1024 / 1024x1536
/ auto) and extends size + prompt-length validators. Also updates
the media-generation skill and image-generation doc page to list
the new model.

* fix(ai-openrouter): restore web_fetch in tool capabilities map

The model-metadata sync in #623 regenerated
`OpenRouterChatModelToolCapabilitiesByName` with `['web_search']` only,
which made `webFetchTool()` (added in #611) unassignable to any
OpenRouter text adapter and broke the per-model type-safety test.

Add `'web_fetch'` back so the existing tests compile.
---
 .changeset/openai-gpt-image-2.md              | 22 ++++++++++++++++++
 .../openrouter-web-fetch-tool-capability.md   |  5 ++++
 docs/media/image-generation.md                |  6 +++--
 .../ai-openai/src/adapters/image.ts           |  2 +-
 .../src/image/image-provider-options.ts       | 11 ++++++---
 .../typescript/ai-openai/src/model-meta.ts    | 23 +++++++++++++++++++
 .../ai-openrouter/src/model-meta.ts           |  5 +++-
 .../skills/ai-core/media-generation/SKILL.md  |  2 +-
 8 files changed, 68 insertions(+), 8 deletions(-)
 create mode 100644 .changeset/openai-gpt-image-2.md
 create mode 100644 .changeset/openrouter-web-fetch-tool-capability.md

diff --git a/.changeset/openai-gpt-image-2.md b/.changeset/openai-gpt-image-2.md
new file mode 100644
index 000000000..bc987807e
--- /dev/null
+++ b/.changeset/openai-gpt-image-2.md
@@ -0,0 +1,22 @@
+---
+'@tanstack/ai-openai': minor
+---
+
+Add `gpt-image-2` to the OpenAI image model list. The new model is exposed
+through the same tree-shakeable `openaiImage` adapter as `gpt-image-1` and
+shares its provider options (`quality`, `background`, `output_format`,
+`output_compression`, `moderation`, `partial_images`) and size set
+(`1024x1024`, `1536x1024`, `1024x1536`, `auto`).
+
+```ts
+import { openaiImage } from '@tanstack/ai-openai/adapters'
+import { generate } from '@tanstack/ai'
+
+const adapter = openaiImage({ apiKey: process.env.OPENAI_API_KEY! })
+
+const result = await generate({
+  adapter,
+  model: 'gpt-image-2',
+  prompt: 'A watercolor fox in a snowy forest',
+})
+```
diff --git a/.changeset/openrouter-web-fetch-tool-capability.md b/.changeset/openrouter-web-fetch-tool-capability.md
new file mode 100644
index 000000000..5054fe92d
--- /dev/null
+++ b/.changeset/openrouter-web-fetch-tool-capability.md
@@ -0,0 +1,5 @@
+---
+'@tanstack/ai-openrouter': patch
+---
+
+Restore `web_fetch` in `OpenRouterChatModelToolCapabilitiesByName` so `webFetchTool()` is assignable to OpenRouter text adapters again. The recent model-metadata sync (#623) regenerated this map with `web_search` only, breaking the per-model type-safety tests added in #611.
diff --git a/docs/media/image-generation.md b/docs/media/image-generation.md
index 6c3c6e115..1fb23499f 100644
--- a/docs/media/image-generation.md
+++ b/docs/media/image-generation.md
@@ -90,6 +90,7 @@ All image adapters support these common options:
 
 | Model | Supported Sizes |
 |-------|----------------|
+| `gpt-image-2` | `1024x1024`, `1536x1024`, `1024x1536`, `auto` |
 | `gpt-image-1` | `1024x1024`, `1536x1024`, `1024x1536`, `auto` |
 | `gpt-image-1-mini` | `1024x1024`, `1536x1024`, `1024x1536`, `auto` |
 | `dall-e-3` | `1024x1024`, `1792x1024`, `1024x1792` |
@@ -138,11 +139,11 @@ const result = await generateImage({
 
 OpenAI models support model-specific Model Options:
 
-#### GPT-Image-1 / GPT-Image-1-Mini
+#### GPT-Image-2 / GPT-Image-1 / GPT-Image-1-Mini
 
 ```typescript
 const result = await generateImage({
-  adapter: openaiImage('gpt-image-1'),
+  adapter: openaiImage('gpt-image-2'),
   prompt: 'A cat wearing a hat',
   modelOptions: {
     quality: 'high', // 'high' | 'medium' | 'low' | 'auto'
@@ -223,6 +224,7 @@ interface GeneratedImage {
 
 | Model | Images per Request |
 |-------|-------------------|
+| `gpt-image-2` | 1-10 |
 | `gpt-image-1` | 1-10 |
 | `gpt-image-1-mini` | 1-10 |
 | `dall-e-3` | 1 |
diff --git a/packages/typescript/ai-openai/src/adapters/image.ts b/packages/typescript/ai-openai/src/adapters/image.ts
index 1380c7a26..bc4826305 100644
--- a/packages/typescript/ai-openai/src/adapters/image.ts
+++ b/packages/typescript/ai-openai/src/adapters/image.ts
@@ -31,7 +31,7 @@ export interface OpenAIImageConfig extends OpenAIClientConfig {}
  * OpenAI Image Generation Adapter
  *
  * Tree-shakeable adapter for OpenAI image generation functionality.
- * Supports gpt-image-1, gpt-image-1-mini, dall-e-3, and dall-e-2 models.
+ * Supports gpt-image-2, gpt-image-1, gpt-image-1-mini, dall-e-3, and dall-e-2 models.
  *
  * Features:
  * - Model-specific type-safe provider options
diff --git a/packages/typescript/ai-openai/src/image/image-provider-options.ts b/packages/typescript/ai-openai/src/image/image-provider-options.ts
index a16281cfd..d6e221ec3 100644
--- a/packages/typescript/ai-openai/src/image/image-provider-options.ts
+++ b/packages/typescript/ai-openai/src/image/image-provider-options.ts
@@ -181,6 +181,7 @@ export type OpenAIImageProviderOptions =
  * Used by the core AI types to narrow providerOptions based on the selected model.
  */
 export type OpenAIImageModelProviderOptionsByName = {
+  'gpt-image-2': GptImage1ProviderOptions
   'gpt-image-1': GptImage1ProviderOptions
   'gpt-image-1-mini': GptImage1MiniProviderOptions
   'dall-e-3': DallE3ProviderOptions
@@ -191,6 +192,7 @@ export type OpenAIImageModelProviderOptionsByName = {
  * Type-only map from model name to its supported sizes.
  */
 export type OpenAIImageModelSizeByName = {
+  'gpt-image-2': GptImageSize
   'gpt-image-1': GptImageSize
   'gpt-image-1-mini': GptImageSize
   'dall-e-3': DallE3Size
@@ -217,6 +219,7 @@ export function validateImageSize(
   if (!size || size === 'auto') return
 
   const validSizes: Record<string, Array<string>> = {
+    'gpt-image-2': ['1024x1024', '1536x1024', '1024x1536', 'auto'],
     'gpt-image-1': ['1024x1024', '1536x1024', '1024x1536', 'auto'],
     'gpt-image-1-mini': ['1024x1024', '1536x1024', '1024x1536', 'auto'],
     'dall-e-3': ['1024x1024', '1792x1024', '1024x1792'],
@@ -263,7 +266,7 @@ export function validateNumberOfImages(
 
 export const validateBackground = (options: ImageValidationOptions) => {
   if (options.background) {
-    const supportedModels = ['gpt-image-1', 'gpt-image-1-mini']
+    const supportedModels = ['gpt-image-2', 'gpt-image-1', 'gpt-image-1-mini']
     if (!supportedModels.includes(options.model)) {
       throw new Error(
         `The model ${options.model} does not support background option.`,
@@ -277,11 +280,13 @@ export const validatePrompt = (options: ImageValidationOptions) => {
     throw new Error('Prompt cannot be empty.')
   }
   if (
-    (options.model === 'gpt-image-1' || options.model === 'gpt-image-1-mini') &&
+    (options.model === 'gpt-image-2' ||
+      options.model === 'gpt-image-1' ||
+      options.model === 'gpt-image-1-mini') &&
     options.prompt.length > 32000
   ) {
     throw new Error(
-      'For gpt-image-1/gpt-image-1-mini, prompt length must be less than or equal to 32000 characters.',
+      'For gpt-image-2/gpt-image-1/gpt-image-1-mini, prompt length must be less than or equal to 32000 characters.',
     )
   }
   if (options.model === 'dall-e-2' && options.prompt.length > 1000) {
diff --git a/packages/typescript/ai-openai/src/model-meta.ts b/packages/typescript/ai-openai/src/model-meta.ts
index 1d6d0a06d..4ed863083 100644
--- a/packages/typescript/ai-openai/src/model-meta.ts
+++ b/packages/typescript/ai-openai/src/model-meta.ts
@@ -572,6 +572,28 @@ const GPT_IMAGE_1_MINI = {
   OpenAIBaseOptions & OpenAIStreamingOptions & OpenAIMetadataOptions
 >
 
+const GPT_IMAGE_2 = {
+  name: 'gpt-image-2',
+  knowledge_cutoff: '2026-04-21',
+  pricing: {
+    input: {
+      normal: 5,
+      cached: 1.25,
+    },
+    output: {
+      normal: 30,
+    },
+  },
+  supports: {
+    input: ['text', 'image'],
+    output: ['image'],
+    endpoints: ['image-generation', 'image-edit'],
+    features: [],
+  },
+} as const satisfies ModelMeta<
+  OpenAIBaseOptions & OpenAIStreamingOptions & OpenAIMetadataOptions
+>
+
 const O3_DEEP_RESEARCH = {
   name: 'o3-deep-research',
   context_window: 200_000,
@@ -2217,6 +2239,7 @@ export type OpenAIChatModel = (typeof OPENAI_CHAT_MODELS)[number]
 
 // Image generation models (based on endpoints: "image-generation" or "image-edit")
 export const OPENAI_IMAGE_MODELS = [
+  GPT_IMAGE_2.name,
   GPT_IMAGE_1.name,
   GPT_IMAGE_1_MINI.name,
   DALL_E_3.name,
diff --git a/packages/typescript/ai-openrouter/src/model-meta.ts b/packages/typescript/ai-openrouter/src/model-meta.ts
index bc273258a..cec4ced80 100644
--- a/packages/typescript/ai-openrouter/src/model-meta.ts
+++ b/packages/typescript/ai-openrouter/src/model-meta.ts
@@ -16379,7 +16379,10 @@ export const OPENROUTER_CHAT_MODELS = [
 ] as const
 
 export type OpenRouterChatModelToolCapabilitiesByName = {
-  [K in (typeof OPENROUTER_CHAT_MODELS)[number]]: readonly ['web_search']
+  [K in (typeof OPENROUTER_CHAT_MODELS)[number]]: readonly [
+    'web_search',
+    'web_fetch',
+  ]
 }
 
 export const OPENROUTER_IMAGE_MODELS = [
diff --git a/packages/typescript/ai/skills/ai-core/media-generation/SKILL.md b/packages/typescript/ai/skills/ai-core/media-generation/SKILL.md
index ffb4b6d86..a3f4b0fbe 100644
--- a/packages/typescript/ai/skills/ai-core/media-generation/SKILL.md
+++ b/packages/typescript/ai/skills/ai-core/media-generation/SKILL.md
@@ -149,7 +149,7 @@ function ImageGenerator() {
 ### 1. Image Generation
 
 Supported adapters: `openaiImage` (dall-e-2, dall-e-3, gpt-image-1,
-gpt-image-1-mini) and `geminiImage` (gemini-3.1-flash-image-preview,
+gpt-image-1-mini, gpt-image-2) and `geminiImage` (gemini-3.1-flash-image-preview,
 imagen-4.0-generate-001, etc.).
 
 ```typescript

From 148553bca4b4d4e0ad052fa7a0c8058b7725fb01 Mon Sep 17 00:00:00 2001
From: Alem Tuzlak <t.zlak@hotmail.com>
Date: Fri, 22 May 2026 13:40:09 +0200
Subject: [PATCH 04/10] docs: refresh README and package metadata (#626)

* docs: refresh README discoverability

* docs: address README review feedback
---
 .changeset/openrouter-web-fetch-tool-types.md |   5 +
 .changeset/refresh-readme-package-metadata.md |  35 ++
 README.md                                     | 329 ++++++++++++-----
 package.json                                  |   2 +-
 packages/typescript/ai-anthropic/package.json |  12 +-
 packages/typescript/ai-client/README.md       | 329 ++++++++++++-----
 packages/typescript/ai-client/package.json    |  14 +-
 .../ai-code-mode-skills/package.json          |   9 +-
 packages/typescript/ai-code-mode/package.json |   7 +-
 packages/typescript/ai-devtools/README.md     | 329 ++++++++++++-----
 packages/typescript/ai-devtools/package.json  |  12 +-
 .../typescript/ai-elevenlabs/package.json     |  16 +-
 .../typescript/ai-event-client/package.json   |  15 +-
 packages/typescript/ai-fal/package.json       |  10 +-
 packages/typescript/ai-gemini/README.md       | 329 ++++++++++++-----
 packages/typescript/ai-gemini/package.json    |  14 +-
 packages/typescript/ai-grok/package.json      |  13 +-
 packages/typescript/ai-groq/package.json      |  13 +-
 .../ai-isolate-cloudflare/package.json        |   8 +-
 .../typescript/ai-isolate-node/package.json   |   8 +-
 .../ai-isolate-quickjs/package.json           |   9 +-
 packages/typescript/ai-ollama/README.md       | 329 ++++++++++++-----
 packages/typescript/ai-ollama/package.json    |  12 +-
 packages/typescript/ai-openai/README.md       | 329 ++++++++++++-----
 packages/typescript/ai-openai/package.json    |  16 +-
 packages/typescript/ai-openrouter/README.md   | 327 +++++++++++++----
 .../typescript/ai-openrouter/package.json     |  13 +-
 packages/typescript/ai-preact/README.md       | 333 +++++++++++++-----
 packages/typescript/ai-preact/package.json    |   9 +-
 packages/typescript/ai-react-ui/README.md     | 329 ++++++++++++-----
 packages/typescript/ai-react-ui/package.json  |  10 +-
 packages/typescript/ai-react/README.md        | 329 ++++++++++++-----
 packages/typescript/ai-react/package.json     |  12 +-
 packages/typescript/ai-solid-ui/README.md     | 326 +++++++++++++----
 packages/typescript/ai-solid-ui/package.json  |  10 +-
 packages/typescript/ai-solid/package.json     |  12 +-
 packages/typescript/ai-svelte/package.json    |  13 +-
 packages/typescript/ai-utils/package.json     |  10 +-
 packages/typescript/ai-vue-ui/README.md       | 326 +++++++++++++----
 packages/typescript/ai-vue-ui/package.json    |  10 +-
 packages/typescript/ai-vue/README.md          | 326 +++++++++++++----
 packages/typescript/ai-vue/package.json       |  14 +-
 packages/typescript/ai/README.md              | 329 ++++++++++++-----
 packages/typescript/ai/package.json           |  14 +-
 packages/typescript/openai-base/package.json  |  12 +-
 .../typescript/preact-ai-devtools/README.md   | 329 ++++++++++++-----
 .../preact-ai-devtools/package.json           |  16 +-
 .../typescript/react-ai-devtools/README.md    | 329 ++++++++++++-----
 .../typescript/react-ai-devtools/package.json |  16 +-
 .../typescript/solid-ai-devtools/README.md    | 329 ++++++++++++-----
 .../typescript/solid-ai-devtools/package.json |  13 +-
 scripts/copy-readme.js                        |  28 ++
 52 files changed, 4640 insertions(+), 1388 deletions(-)
 create mode 100644 .changeset/openrouter-web-fetch-tool-types.md
 create mode 100644 .changeset/refresh-readme-package-metadata.md
 create mode 100644 scripts/copy-readme.js

diff --git a/.changeset/openrouter-web-fetch-tool-types.md b/.changeset/openrouter-web-fetch-tool-types.md
new file mode 100644
index 000000000..066b2faa9
--- /dev/null
+++ b/.changeset/openrouter-web-fetch-tool-types.md
@@ -0,0 +1,5 @@
+---
+'@tanstack/ai-openrouter': patch
+---
+
+Fix OpenRouter provider tool type metadata to include `webFetchTool`.
diff --git a/.changeset/refresh-readme-package-metadata.md b/.changeset/refresh-readme-package-metadata.md
new file mode 100644
index 000000000..2564ffd9d
--- /dev/null
+++ b/.changeset/refresh-readme-package-metadata.md
@@ -0,0 +1,35 @@
+---
+'@tanstack/ai': patch
+'@tanstack/ai-anthropic': patch
+'@tanstack/ai-client': patch
+'@tanstack/ai-code-mode': patch
+'@tanstack/ai-code-mode-skills': patch
+'@tanstack/ai-devtools-core': patch
+'@tanstack/ai-elevenlabs': patch
+'@tanstack/ai-event-client': patch
+'@tanstack/ai-fal': patch
+'@tanstack/ai-gemini': patch
+'@tanstack/ai-grok': patch
+'@tanstack/ai-groq': patch
+'@tanstack/ai-isolate-cloudflare': patch
+'@tanstack/ai-isolate-node': patch
+'@tanstack/ai-isolate-quickjs': patch
+'@tanstack/ai-ollama': patch
+'@tanstack/ai-openai': patch
+'@tanstack/ai-openrouter': patch
+'@tanstack/ai-preact': patch
+'@tanstack/ai-react': patch
+'@tanstack/ai-react-ui': patch
+'@tanstack/ai-solid': patch
+'@tanstack/ai-solid-ui': patch
+'@tanstack/ai-svelte': patch
+'@tanstack/ai-utils': patch
+'@tanstack/ai-vue': patch
+'@tanstack/ai-vue-ui': patch
+'@tanstack/openai-base': patch
+'@tanstack/preact-ai-devtools': patch
+'@tanstack/react-ai-devtools': patch
+'@tanstack/solid-ai-devtools': patch
+---
+
+Refresh package README content and npm metadata for better discoverability.
diff --git a/README.md b/README.md
index 26e3db048..1c98040b8 100644
--- a/README.md
+++ b/README.md
@@ -1,93 +1,253 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+Install the core package and the provider/framework packages your app uses:
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- **Tree-shakeable adapters** - Import only what you need for smaller bundles
-- **Multimodal content support** - Send images, audio, video, and documents
-- **Image generation** - Generate images with OpenAI DALL-E/GPT-Image and Gemini Imagen
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Isomorphic type-safe tools with server/client execution
-- **Enhanced integration with TanStack Start** - Share implementations between AI tools and server functions
-- **Observability events** - Structured, typed events for text, tools, image, speech, transcription, and video ([docs](./docs/guides/observability.md))
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
 
-### <a href="https://tanstack.com/ai">Read the docs →</a>
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
 
-## Tree-Shakeable Adapters
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
 
-Import only the functionality you need for smaller bundle sizes:
+## Streaming Chat
 
 ```typescript
-// Only chat functionality - no summarization code bundled
-import { openaiText } from '@tanstack/ai-openai/adapters'
-import { generate } from '@tanstack/ai'
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
 
-const textAdapter = openaiText()
+export async function POST(request: Request) {
+  const body = await request.json()
 
-const result = generate({
-  adapter: textAdapter,
-  model: 'gpt-4o',
-  messages: [{ role: 'user', content: [{ type: 'text', content: 'Hello!' }] }],
-})
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-for await (const chunk of result) {
-  console.log(chunk)
+  return toServerSentEventsResponse(stream)
 }
 ```
 
-Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicText`, `geminiText`, `ollamaText`, and more.
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
+
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-         <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
@@ -96,7 +256,7 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-           <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
           <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
@@ -106,28 +266,39 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/package.json b/package.json
index 5cf213f23..e39c1e485 100644
--- a/package.json
+++ b/package.json
@@ -39,7 +39,7 @@
     "generate:models:fetch": "tsx scripts/fetch-openrouter-models.ts",
     "regenerate:models": "tsx scripts/convert-openrouter-models.ts",
     "sync-docs-config": "node scripts/sync-docs-config.ts",
-    "copy:readme": "cp README.md packages/typescript/ai/README.md && cp README.md packages/typescript/ai-devtools/README.md && cp README.md packages/typescript/preact-ai-devtools/README.md && cp README.md packages/typescript/ai-client/README.md && cp README.md packages/typescript/ai-gemini/README.md && cp README.md packages/typescript/ai-ollama/README.md && cp README.md packages/typescript/ai-openai/README.md && cp README.md packages/typescript/ai-react/README.md && cp README.md packages/typescript/ai-react-ui/README.md && cp README.md packages/typescript/react-ai-devtools/README.md && cp README.md packages/typescript/solid-ai-devtools/README.md",
+    "copy:readme": "node scripts/copy-readme.js",
     "changeset": "changeset",
     "changeset:publish": "changeset publish",
     "changeset:version": "changeset version && pnpm install --no-frozen-lockfile && pnpm format"
diff --git a/packages/typescript/ai-anthropic/package.json b/packages/typescript/ai-anthropic/package.json
index e4297e318..47ba1e6a8 100644
--- a/packages/typescript/ai-anthropic/package.json
+++ b/packages/typescript/ai-anthropic/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-anthropic",
   "version": "0.10.2",
-  "description": "Anthropic Claude adapter for TanStack AI",
+  "description": "Anthropic Claude adapter for TanStack AI chat, tool calling, thinking, and structured outputs.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -11,10 +11,16 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
     "anthropic",
     "claude",
-    "tanstack",
-    "adapter"
+    "adapter",
+    "chat",
+    "tool-calling",
+    "structured-outputs",
+    "thinking"
   ],
   "type": "module",
   "module": "./dist/esm/index.js",
diff --git a/packages/typescript/ai-client/README.md b/packages/typescript/ai-client/README.md
index 26e3db048..1c98040b8 100644
--- a/packages/typescript/ai-client/README.md
+++ b/packages/typescript/ai-client/README.md
@@ -1,93 +1,253 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+Install the core package and the provider/framework packages your app uses:
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- **Tree-shakeable adapters** - Import only what you need for smaller bundles
-- **Multimodal content support** - Send images, audio, video, and documents
-- **Image generation** - Generate images with OpenAI DALL-E/GPT-Image and Gemini Imagen
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Isomorphic type-safe tools with server/client execution
-- **Enhanced integration with TanStack Start** - Share implementations between AI tools and server functions
-- **Observability events** - Structured, typed events for text, tools, image, speech, transcription, and video ([docs](./docs/guides/observability.md))
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
 
-### <a href="https://tanstack.com/ai">Read the docs →</a>
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
 
-## Tree-Shakeable Adapters
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
 
-Import only the functionality you need for smaller bundle sizes:
+## Streaming Chat
 
 ```typescript
-// Only chat functionality - no summarization code bundled
-import { openaiText } from '@tanstack/ai-openai/adapters'
-import { generate } from '@tanstack/ai'
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
 
-const textAdapter = openaiText()
+export async function POST(request: Request) {
+  const body = await request.json()
 
-const result = generate({
-  adapter: textAdapter,
-  model: 'gpt-4o',
-  messages: [{ role: 'user', content: [{ type: 'text', content: 'Hello!' }] }],
-})
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-for await (const chunk of result) {
-  console.log(chunk)
+  return toServerSentEventsResponse(stream)
 }
 ```
 
-Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicText`, `geminiText`, `ollamaText`, and more.
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
+
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-         <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
@@ -96,7 +256,7 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-           <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
           <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
@@ -106,28 +266,39 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/ai-client/package.json b/packages/typescript/ai-client/package.json
index 5eb06b31a..a98d98adf 100644
--- a/packages/typescript/ai-client/package.json
+++ b/packages/typescript/ai-client/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-client",
   "version": "0.11.5",
-  "description": "Framework-agnostic headless client for TanStack AI",
+  "description": "Framework-agnostic headless client for TanStack AI chat, realtime sessions, streaming transports, and media generations.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -11,11 +11,17 @@
   },
   "keywords": [
     "ai",
-    "client",
-    "headless",
+    "ai-sdk",
+    "typescript",
     "tanstack",
+    "headless",
+    "client",
     "chat",
-    "streaming"
+    "streaming",
+    "realtime",
+    "generative-ai",
+    "tool-calling",
+    "structured-outputs"
   ],
   "type": "module",
   "module": "./dist/esm/index.js",
diff --git a/packages/typescript/ai-code-mode-skills/package.json b/packages/typescript/ai-code-mode-skills/package.json
index 25df468d4..25991aab1 100644
--- a/packages/typescript/ai-code-mode-skills/package.json
+++ b/packages/typescript/ai-code-mode-skills/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-code-mode-skills",
   "version": "0.1.18",
-  "description": "Persistent skill library for TanStack AI Code Mode - LLM-created reusable code snippets",
+  "description": "Persistent runtime skill library for TanStack AI Code Mode agents and sandboxed tool orchestration.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -50,11 +50,16 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
     "tanstack",
     "code-mode",
     "skills",
+    "agents",
     "llm",
-    "sandbox"
+    "sandbox",
+    "tool-calling",
+    "tanstack-intent"
   ],
   "dependencies": {
     "@tanstack/ai": "workspace:*",
diff --git a/packages/typescript/ai-code-mode/package.json b/packages/typescript/ai-code-mode/package.json
index c81d26b69..212fe1ac1 100644
--- a/packages/typescript/ai-code-mode/package.json
+++ b/packages/typescript/ai-code-mode/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-code-mode",
   "version": "0.1.18",
-  "description": "Code Mode for TanStack AI - LLM-driven code execution in secure sandboxes",
+  "description": "Secure TypeScript Code Mode for TanStack AI agents to execute sandboxed tool orchestration programs.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -39,11 +39,16 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
     "tanstack",
     "code-mode",
+    "agents",
     "llm",
+    "tool-calling",
     "sandbox",
     "isolate",
+    "code-execution",
     "tanstack-intent"
   ],
   "dependencies": {
diff --git a/packages/typescript/ai-devtools/README.md b/packages/typescript/ai-devtools/README.md
index 26e3db048..1c98040b8 100644
--- a/packages/typescript/ai-devtools/README.md
+++ b/packages/typescript/ai-devtools/README.md
@@ -1,93 +1,253 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+Install the core package and the provider/framework packages your app uses:
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- **Tree-shakeable adapters** - Import only what you need for smaller bundles
-- **Multimodal content support** - Send images, audio, video, and documents
-- **Image generation** - Generate images with OpenAI DALL-E/GPT-Image and Gemini Imagen
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Isomorphic type-safe tools with server/client execution
-- **Enhanced integration with TanStack Start** - Share implementations between AI tools and server functions
-- **Observability events** - Structured, typed events for text, tools, image, speech, transcription, and video ([docs](./docs/guides/observability.md))
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
 
-### <a href="https://tanstack.com/ai">Read the docs →</a>
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
 
-## Tree-Shakeable Adapters
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
 
-Import only the functionality you need for smaller bundle sizes:
+## Streaming Chat
 
 ```typescript
-// Only chat functionality - no summarization code bundled
-import { openaiText } from '@tanstack/ai-openai/adapters'
-import { generate } from '@tanstack/ai'
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
 
-const textAdapter = openaiText()
+export async function POST(request: Request) {
+  const body = await request.json()
 
-const result = generate({
-  adapter: textAdapter,
-  model: 'gpt-4o',
-  messages: [{ role: 'user', content: [{ type: 'text', content: 'Hello!' }] }],
-})
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-for await (const chunk of result) {
-  console.log(chunk)
+  return toServerSentEventsResponse(stream)
 }
 ```
 
-Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicText`, `geminiText`, `ollamaText`, and more.
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
+
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-         <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
@@ -96,7 +256,7 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-           <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
           <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
@@ -106,28 +266,39 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/ai-devtools/package.json b/packages/typescript/ai-devtools/package.json
index 57b77a2c6..fb43d31a2 100644
--- a/packages/typescript/ai-devtools/package.json
+++ b/packages/typescript/ai-devtools/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-devtools-core",
   "version": "0.3.35",
-  "description": "Core TanStack AI Devtools",
+  "description": "Core TanStack AI Devtools plugin for inspecting chat messages, tool calls, streams, and errors.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -71,11 +71,15 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
     "tanstack",
-    "sdk",
-    "llm",
+    "devtools",
+    "debugging",
+    "observability",
     "chat",
-    "embeddings"
+    "tool-calling",
+    "streaming"
   ],
   "dependencies": {
     "@tanstack/ai": "workspace:*",
diff --git a/packages/typescript/ai-elevenlabs/package.json b/packages/typescript/ai-elevenlabs/package.json
index 2a269a4a3..4354f2211 100644
--- a/packages/typescript/ai-elevenlabs/package.json
+++ b/packages/typescript/ai-elevenlabs/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-elevenlabs",
   "version": "0.2.9",
-  "description": "ElevenLabs adapter for TanStack AI realtime voice",
+  "description": "ElevenLabs adapter for TanStack AI realtime voice, text-to-speech, transcription, music, and sound effects.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -11,18 +11,20 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
     "elevenlabs",
+    "adapter",
     "voice",
     "realtime",
-    "tanstack",
-    "adapter",
-    "tts",
     "text-to-speech",
+    "tts",
+    "transcription",
+    "speech-to-text",
     "audio-generation",
     "music",
-    "sound-effects",
-    "transcription",
-    "speech-to-text"
+    "sound-effects"
   ],
   "type": "module",
   "module": "./dist/esm/index.js",
diff --git a/packages/typescript/ai-event-client/package.json b/packages/typescript/ai-event-client/package.json
index 9ff1e7281..845246096 100644
--- a/packages/typescript/ai-event-client/package.json
+++ b/packages/typescript/ai-event-client/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-event-client",
   "version": "0.3.8",
-  "description": "Event client for TanStack AI devtools integration",
+  "description": "Typed event client for TanStack AI devtools, observability, and streamed runtime events.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -41,5 +41,16 @@
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.14"
-  }
+  },
+  "keywords": [
+    "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
+    "events",
+    "devtools",
+    "observability",
+    "streaming",
+    "chat"
+  ]
 }
diff --git a/packages/typescript/ai-fal/package.json b/packages/typescript/ai-fal/package.json
index 8a6751341..361170847 100644
--- a/packages/typescript/ai-fal/package.json
+++ b/packages/typescript/ai-fal/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-fal",
   "version": "0.7.11",
-  "description": "fal.ai adapter for TanStack AI",
+  "description": "fal.ai adapter for TanStack AI image, video, audio, speech, and transcription generation.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -34,8 +34,11 @@
   },
   "keywords": [
     "ai",
-    "fal",
+    "ai-sdk",
+    "typescript",
     "tanstack",
+    "fal",
+    "fal-ai",
     "adapter",
     "image-generation",
     "video-generation",
@@ -43,7 +46,8 @@
     "text-to-speech",
     "speech-to-text",
     "tts",
-    "transcription"
+    "transcription",
+    "media-generation"
   ],
   "dependencies": {
     "@fal-ai/client": "^1.10.1",
diff --git a/packages/typescript/ai-gemini/README.md b/packages/typescript/ai-gemini/README.md
index 26e3db048..1c98040b8 100644
--- a/packages/typescript/ai-gemini/README.md
+++ b/packages/typescript/ai-gemini/README.md
@@ -1,93 +1,253 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+Install the core package and the provider/framework packages your app uses:
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- **Tree-shakeable adapters** - Import only what you need for smaller bundles
-- **Multimodal content support** - Send images, audio, video, and documents
-- **Image generation** - Generate images with OpenAI DALL-E/GPT-Image and Gemini Imagen
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Isomorphic type-safe tools with server/client execution
-- **Enhanced integration with TanStack Start** - Share implementations between AI tools and server functions
-- **Observability events** - Structured, typed events for text, tools, image, speech, transcription, and video ([docs](./docs/guides/observability.md))
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
 
-### <a href="https://tanstack.com/ai">Read the docs →</a>
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
 
-## Tree-Shakeable Adapters
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
 
-Import only the functionality you need for smaller bundle sizes:
+## Streaming Chat
 
 ```typescript
-// Only chat functionality - no summarization code bundled
-import { openaiText } from '@tanstack/ai-openai/adapters'
-import { generate } from '@tanstack/ai'
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
 
-const textAdapter = openaiText()
+export async function POST(request: Request) {
+  const body = await request.json()
 
-const result = generate({
-  adapter: textAdapter,
-  model: 'gpt-4o',
-  messages: [{ role: 'user', content: [{ type: 'text', content: 'Hello!' }] }],
-})
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-for await (const chunk of result) {
-  console.log(chunk)
+  return toServerSentEventsResponse(stream)
 }
 ```
 
-Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicText`, `geminiText`, `ollamaText`, and more.
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
+
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-         <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
@@ -96,7 +256,7 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-           <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
           <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
@@ -106,28 +266,39 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/ai-gemini/package.json b/packages/typescript/ai-gemini/package.json
index e0c407e35..272e2f13f 100644
--- a/packages/typescript/ai-gemini/package.json
+++ b/packages/typescript/ai-gemini/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-gemini",
   "version": "0.10.9",
-  "description": "Google Gemini adapter for TanStack AI",
+  "description": "Google Gemini adapter for TanStack AI chat, images, speech, audio generation, and structured outputs.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -38,10 +38,18 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
     "gemini",
     "google",
-    "tanstack",
-    "adapter"
+    "adapter",
+    "chat",
+    "tool-calling",
+    "structured-outputs",
+    "image-generation",
+    "audio-generation",
+    "text-to-speech"
   ],
   "dependencies": {
     "@google/genai": "^1.43.0",
diff --git a/packages/typescript/ai-grok/package.json b/packages/typescript/ai-grok/package.json
index c2941fef7..9c7cf8eda 100644
--- a/packages/typescript/ai-grok/package.json
+++ b/packages/typescript/ai-grok/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-grok",
   "version": "0.8.6",
-  "description": "Grok (xAI) adapter for TanStack AI",
+  "description": "xAI Grok adapter for TanStack AI chat, image generation, realtime, and structured outputs.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -38,10 +38,17 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
     "grok",
     "xai",
-    "tanstack",
-    "adapter"
+    "adapter",
+    "chat",
+    "tool-calling",
+    "structured-outputs",
+    "image-generation",
+    "realtime"
   ],
   "dependencies": {
     "@tanstack/ai-utils": "workspace:*",
diff --git a/packages/typescript/ai-groq/package.json b/packages/typescript/ai-groq/package.json
index 3004a5448..383b2b38b 100644
--- a/packages/typescript/ai-groq/package.json
+++ b/packages/typescript/ai-groq/package.json
@@ -2,7 +2,7 @@
   "name": "@tanstack/ai-groq",
   "version": "0.2.5",
   "type": "module",
-  "description": "Groq adapter for TanStack AI",
+  "description": "Groq adapter for TanStack AI low-latency chat, tool calling, and structured outputs.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -38,9 +38,16 @@
   },
   "keywords": [
     "ai",
-    "groq",
+    "ai-sdk",
+    "typescript",
     "tanstack",
-    "adapter"
+    "groq",
+    "adapter",
+    "llm",
+    "chat",
+    "low-latency",
+    "tool-calling",
+    "structured-outputs"
   ],
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.14",
diff --git a/packages/typescript/ai-isolate-cloudflare/package.json b/packages/typescript/ai-isolate-cloudflare/package.json
index 4a9989055..b5b2892b9 100644
--- a/packages/typescript/ai-isolate-cloudflare/package.json
+++ b/packages/typescript/ai-isolate-cloudflare/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-isolate-cloudflare",
   "version": "0.2.9",
-  "description": "Cloudflare Workers driver for TanStack AI Code Mode - execute code on the edge",
+  "description": "Cloudflare Workers sandbox driver for TanStack AI Code Mode TypeScript execution at the edge.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -46,12 +46,16 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
     "tanstack",
     "code-mode",
     "cloudflare",
     "workers",
     "edge",
-    "isolate"
+    "isolate",
+    "sandbox",
+    "code-execution"
   ],
   "dependencies": {
     "@tanstack/ai-code-mode": "workspace:*"
diff --git a/packages/typescript/ai-isolate-node/package.json b/packages/typescript/ai-isolate-node/package.json
index 7533cc134..7016ee822 100644
--- a/packages/typescript/ai-isolate-node/package.json
+++ b/packages/typescript/ai-isolate-node/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-isolate-node",
   "version": "0.1.18",
-  "description": "Node.js isolated-vm driver for TanStack AI Code Mode",
+  "description": "Node.js isolated-vm sandbox driver for TanStack AI Code Mode TypeScript execution.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -38,11 +38,15 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
     "tanstack",
     "code-mode",
+    "nodejs",
+    "isolated-vm",
     "isolate",
     "sandbox",
-    "isolated-vm"
+    "code-execution"
   ],
   "dependencies": {
     "isolated-vm": "^6.0.2"
diff --git a/packages/typescript/ai-isolate-quickjs/package.json b/packages/typescript/ai-isolate-quickjs/package.json
index 16481effb..3526fe6ea 100644
--- a/packages/typescript/ai-isolate-quickjs/package.json
+++ b/packages/typescript/ai-isolate-quickjs/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-isolate-quickjs",
   "version": "0.1.18",
-  "description": "QuickJS WASM driver for TanStack AI Code Mode - runs everywhere",
+  "description": "QuickJS WASM sandbox driver for TanStack AI Code Mode TypeScript execution across runtimes.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -35,12 +35,15 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
     "tanstack",
     "code-mode",
+    "quickjs",
+    "wasm",
     "isolate",
     "sandbox",
-    "quickjs",
-    "wasm"
+    "code-execution"
   ],
   "dependencies": {
     "quickjs-emscripten": "^0.31.0"
diff --git a/packages/typescript/ai-ollama/README.md b/packages/typescript/ai-ollama/README.md
index 26e3db048..1c98040b8 100644
--- a/packages/typescript/ai-ollama/README.md
+++ b/packages/typescript/ai-ollama/README.md
@@ -1,93 +1,253 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+Install the core package and the provider/framework packages your app uses:
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- **Tree-shakeable adapters** - Import only what you need for smaller bundles
-- **Multimodal content support** - Send images, audio, video, and documents
-- **Image generation** - Generate images with OpenAI DALL-E/GPT-Image and Gemini Imagen
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Isomorphic type-safe tools with server/client execution
-- **Enhanced integration with TanStack Start** - Share implementations between AI tools and server functions
-- **Observability events** - Structured, typed events for text, tools, image, speech, transcription, and video ([docs](./docs/guides/observability.md))
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
 
-### <a href="https://tanstack.com/ai">Read the docs →</a>
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
 
-## Tree-Shakeable Adapters
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
 
-Import only the functionality you need for smaller bundle sizes:
+## Streaming Chat
 
 ```typescript
-// Only chat functionality - no summarization code bundled
-import { openaiText } from '@tanstack/ai-openai/adapters'
-import { generate } from '@tanstack/ai'
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
 
-const textAdapter = openaiText()
+export async function POST(request: Request) {
+  const body = await request.json()
 
-const result = generate({
-  adapter: textAdapter,
-  model: 'gpt-4o',
-  messages: [{ role: 'user', content: [{ type: 'text', content: 'Hello!' }] }],
-})
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-for await (const chunk of result) {
-  console.log(chunk)
+  return toServerSentEventsResponse(stream)
 }
 ```
 
-Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicText`, `geminiText`, `ollamaText`, and more.
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
+
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-         <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
@@ -96,7 +256,7 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-           <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
           <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
@@ -106,28 +266,39 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/ai-ollama/package.json b/packages/typescript/ai-ollama/package.json
index f94e8adeb..8fbfa53de 100644
--- a/packages/typescript/ai-ollama/package.json
+++ b/packages/typescript/ai-ollama/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-ollama",
   "version": "0.6.20",
-  "description": "Ollama adapter for TanStack AI",
+  "description": "Ollama adapter for TanStack AI local LLM chat, tool calling, and structured outputs.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -34,11 +34,17 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
     "ollama",
+    "local-llm",
     "llama",
     "mistral",
-    "tanstack",
-    "adapter"
+    "adapter",
+    "chat",
+    "tool-calling",
+    "structured-outputs"
   ],
   "dependencies": {
     "@tanstack/ai-utils": "workspace:*",
diff --git a/packages/typescript/ai-openai/README.md b/packages/typescript/ai-openai/README.md
index 26e3db048..1c98040b8 100644
--- a/packages/typescript/ai-openai/README.md
+++ b/packages/typescript/ai-openai/README.md
@@ -1,93 +1,253 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+Install the core package and the provider/framework packages your app uses:
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- **Tree-shakeable adapters** - Import only what you need for smaller bundles
-- **Multimodal content support** - Send images, audio, video, and documents
-- **Image generation** - Generate images with OpenAI DALL-E/GPT-Image and Gemini Imagen
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Isomorphic type-safe tools with server/client execution
-- **Enhanced integration with TanStack Start** - Share implementations between AI tools and server functions
-- **Observability events** - Structured, typed events for text, tools, image, speech, transcription, and video ([docs](./docs/guides/observability.md))
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
 
-### <a href="https://tanstack.com/ai">Read the docs →</a>
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
 
-## Tree-Shakeable Adapters
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
 
-Import only the functionality you need for smaller bundle sizes:
+## Streaming Chat
 
 ```typescript
-// Only chat functionality - no summarization code bundled
-import { openaiText } from '@tanstack/ai-openai/adapters'
-import { generate } from '@tanstack/ai'
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
 
-const textAdapter = openaiText()
+export async function POST(request: Request) {
+  const body = await request.json()
 
-const result = generate({
-  adapter: textAdapter,
-  model: 'gpt-4o',
-  messages: [{ role: 'user', content: [{ type: 'text', content: 'Hello!' }] }],
-})
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-for await (const chunk of result) {
-  console.log(chunk)
+  return toServerSentEventsResponse(stream)
 }
 ```
 
-Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicText`, `geminiText`, `ollamaText`, and more.
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
+
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-         <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
@@ -96,7 +256,7 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-           <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
           <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
@@ -106,28 +266,39 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/ai-openai/package.json b/packages/typescript/ai-openai/package.json
index a71a52fc9..fa4b520cb 100644
--- a/packages/typescript/ai-openai/package.json
+++ b/packages/typescript/ai-openai/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-openai",
   "version": "0.9.6",
-  "description": "OpenAI adapter for TanStack AI",
+  "description": "OpenAI adapter for TanStack AI chat, tools, images, video, speech, transcription, realtime, and structured outputs.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -38,10 +38,20 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
     "openai",
     "gpt",
-    "tanstack",
-    "adapter"
+    "adapter",
+    "chat",
+    "tool-calling",
+    "structured-outputs",
+    "image-generation",
+    "video-generation",
+    "text-to-speech",
+    "transcription",
+    "realtime"
   ],
   "dependencies": {
     "@tanstack/ai-utils": "workspace:*",
diff --git a/packages/typescript/ai-openrouter/README.md b/packages/typescript/ai-openrouter/README.md
index 3bb562720..1c98040b8 100644
--- a/packages/typescript/ai-openrouter/README.md
+++ b/packages/typescript/ai-openrouter/README.md
@@ -1,92 +1,254 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
+
+Install the core package and the provider/framework packages your app uses:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
+
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
+
+## Streaming Chat
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+```typescript
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+
+export async function POST(request: Request) {
+  const body = await request.json()
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- **Multimodal content support** - Send images, audio, video, and documents
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Isomorphic type-safe tools with server/client execution
-- **Enhanced integration with TanStack Start** - Share implementations between AI tools and server functions
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-### <a href="https://tanstack.com/ai">Read the docs →</b></a>
+  return toServerSentEventsResponse(stream)
+}
+```
 
-## Bonus: TanStack Start Integration
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
 
-TanStack AI works with **any** framework (Next.js, Express, Remix, etc.).
+## Type-Safe Tools
 
-**With TanStack Start**, you get a bonus: share implementations between AI tools and server functions with `createServerFnTool`:
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
 
 ```typescript
-import { createServerFnTool } from '@tanstack/ai-react'
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
 
-// Define once, get AI tool AND server function (TanStack Start only)
-const getProducts = createServerFnTool({
+const getProducts = toolDefinition({
   name: 'getProducts',
+  description: 'Search the product catalog',
   inputSchema: z.object({ query: z.string() }),
-  execute: async ({ query }) => db.products.search(query),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
 })
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
 
-// Use in AI chat
-chat({ tools: [getProducts.server] })
+Use `outputSchema` when you need typed objects instead of freeform text:
 
-// Call directly from components (no API endpoint needed!)
-const products = await getProducts.serverFn({ query: 'laptop' })
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
 ```
 
-No duplicate logic, full type safety, automatic validation. The `serverFn` feature requires TanStack Start. See [docs](https://tanstack.com/ai) for details.
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" height="40" />
-          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
       </a>
@@ -94,9 +256,9 @@ No duplicate logic, full type safety, automatic validation. The `serverFn` featu
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" />
-          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" height="60" />
-          <img src="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" height="60" alt="Cloudflare" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
+          <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
       </a>
     </td>
@@ -104,28 +266,39 @@ No duplicate logic, full type safety, automatic validation. The `serverFn` featu
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/ai-openrouter/package.json b/packages/typescript/ai-openrouter/package.json
index e99c845ef..16c74001a 100644
--- a/packages/typescript/ai-openrouter/package.json
+++ b/packages/typescript/ai-openrouter/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-openrouter",
   "version": "0.9.6",
-  "description": "OpenRouter adapter for TanStack AI",
+  "description": "TanStack AI adapter for OpenRouter chat, provider tools, structured outputs, and access to hundreds of LLMs.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -38,9 +38,18 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
+    "llm",
+    "generative-ai",
     "openrouter",
     "tanstack",
-    "adapter"
+    "adapter",
+    "chat",
+    "streaming",
+    "tool-calling",
+    "structured-outputs",
+    "model-router"
   ],
   "dependencies": {
     "@openrouter/sdk": "0.12.35",
diff --git a/packages/typescript/ai-preact/README.md b/packages/typescript/ai-preact/README.md
index 85e9db54e..1c98040b8 100644
--- a/packages/typescript/ai-preact/README.md
+++ b/packages/typescript/ai-preact/README.md
@@ -1,92 +1,254 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+Install the core package and the provider/framework packages your app uses:
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- **Tree-shakeable adapters** - Import only what you need for smaller bundles
-- **Multimodal content support** - Send images, audio, video, and documents
-- **Image generation** - Generate images with OpenAI DALL-E/GPT-Image and Gemini Imagen
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Isomorphic type-safe tools with server/client execution
-- **Enhanced integration with TanStack Start** - Share implementations between AI tools and server functions
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
 
-### <a href="https://tanstack.com/ai">Read the docs →</b></a>
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
 
-## Tree-Shakeable Adapters
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
 
-Import only the functionality you need for smaller bundle sizes:
+## Streaming Chat
 
 ```typescript
-// Only chat functionality - no summarization code bundled
-import { openaiText } from '@tanstack/ai-openai/adapters'
-import { generate } from '@tanstack/ai'
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
 
-const textAdapter = openaiText()
+export async function POST(request: Request) {
+  const body = await request.json()
 
-const result = generate({
-  adapter: textAdapter,
-  model: 'gpt-4o',
-  messages: [{ role: 'user', content: [{ type: 'text', content: 'Hello!' }] }],
-})
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-for await (const chunk of result) {
-  console.log(chunk)
+  return toServerSentEventsResponse(stream)
 }
 ```
 
-Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicText`, `geminiText`, `ollamaText`, and more.
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
+
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" height="40" />
-          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
       </a>
@@ -94,9 +256,9 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" />
-          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" height="60" />
-          <img src="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" height="60" alt="Cloudflare" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
+          <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
       </a>
     </td>
@@ -104,28 +266,39 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/ai-preact/package.json b/packages/typescript/ai-preact/package.json
index 4fd96e74d..57c6e7e97 100644
--- a/packages/typescript/ai-preact/package.json
+++ b/packages/typescript/ai-preact/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-preact",
   "version": "0.6.30",
-  "description": "Preact hooks for TanStack AI",
+  "description": "Preact hooks for TanStack AI streaming chat and typed messages.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -34,11 +34,14 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
     "preact",
     "hooks",
-    "tanstack",
     "chat",
-    "streaming"
+    "streaming",
+    "tool-calling"
   ],
   "dependencies": {
     "@tanstack/ai-client": "workspace:*"
diff --git a/packages/typescript/ai-react-ui/README.md b/packages/typescript/ai-react-ui/README.md
index 26e3db048..1c98040b8 100644
--- a/packages/typescript/ai-react-ui/README.md
+++ b/packages/typescript/ai-react-ui/README.md
@@ -1,93 +1,253 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+Install the core package and the provider/framework packages your app uses:
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- **Tree-shakeable adapters** - Import only what you need for smaller bundles
-- **Multimodal content support** - Send images, audio, video, and documents
-- **Image generation** - Generate images with OpenAI DALL-E/GPT-Image and Gemini Imagen
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Isomorphic type-safe tools with server/client execution
-- **Enhanced integration with TanStack Start** - Share implementations between AI tools and server functions
-- **Observability events** - Structured, typed events for text, tools, image, speech, transcription, and video ([docs](./docs/guides/observability.md))
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
 
-### <a href="https://tanstack.com/ai">Read the docs →</a>
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
 
-## Tree-Shakeable Adapters
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
 
-Import only the functionality you need for smaller bundle sizes:
+## Streaming Chat
 
 ```typescript
-// Only chat functionality - no summarization code bundled
-import { openaiText } from '@tanstack/ai-openai/adapters'
-import { generate } from '@tanstack/ai'
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
 
-const textAdapter = openaiText()
+export async function POST(request: Request) {
+  const body = await request.json()
 
-const result = generate({
-  adapter: textAdapter,
-  model: 'gpt-4o',
-  messages: [{ role: 'user', content: [{ type: 'text', content: 'Hello!' }] }],
-})
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-for await (const chunk of result) {
-  console.log(chunk)
+  return toServerSentEventsResponse(stream)
 }
 ```
 
-Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicText`, `geminiText`, `ollamaText`, and more.
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
+
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-         <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
@@ -96,7 +256,7 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-           <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
           <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
@@ -106,28 +266,39 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/ai-react-ui/package.json b/packages/typescript/ai-react-ui/package.json
index cec3f327a..40cde12ff 100644
--- a/packages/typescript/ai-react-ui/package.json
+++ b/packages/typescript/ai-react-ui/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-react-ui",
   "version": "0.8.0",
-  "description": "Headless React components for building AI chat interfaces",
+  "description": "Headless React components for building TanStack AI chat interfaces with streamed message parts.",
   "module": "./dist/esm/index.js",
   "types": "./dist/esm/index.d.ts",
   "type": "module",
@@ -29,13 +29,17 @@
     "test:types": "tsc"
   },
   "keywords": [
-    "tanstack",
     "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
     "react",
     "chat",
     "ui",
     "headless",
-    "components"
+    "components",
+    "streaming",
+    "generative-ai"
   ],
   "dependencies": {
     "react-markdown": "^10.1.0",
diff --git a/packages/typescript/ai-react/README.md b/packages/typescript/ai-react/README.md
index 26e3db048..1c98040b8 100644
--- a/packages/typescript/ai-react/README.md
+++ b/packages/typescript/ai-react/README.md
@@ -1,93 +1,253 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+Install the core package and the provider/framework packages your app uses:
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- **Tree-shakeable adapters** - Import only what you need for smaller bundles
-- **Multimodal content support** - Send images, audio, video, and documents
-- **Image generation** - Generate images with OpenAI DALL-E/GPT-Image and Gemini Imagen
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Isomorphic type-safe tools with server/client execution
-- **Enhanced integration with TanStack Start** - Share implementations between AI tools and server functions
-- **Observability events** - Structured, typed events for text, tools, image, speech, transcription, and video ([docs](./docs/guides/observability.md))
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
 
-### <a href="https://tanstack.com/ai">Read the docs →</a>
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
 
-## Tree-Shakeable Adapters
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
 
-Import only the functionality you need for smaller bundle sizes:
+## Streaming Chat
 
 ```typescript
-// Only chat functionality - no summarization code bundled
-import { openaiText } from '@tanstack/ai-openai/adapters'
-import { generate } from '@tanstack/ai'
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
 
-const textAdapter = openaiText()
+export async function POST(request: Request) {
+  const body = await request.json()
 
-const result = generate({
-  adapter: textAdapter,
-  model: 'gpt-4o',
-  messages: [{ role: 'user', content: [{ type: 'text', content: 'Hello!' }] }],
-})
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-for await (const chunk of result) {
-  console.log(chunk)
+  return toServerSentEventsResponse(stream)
 }
 ```
 
-Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicText`, `geminiText`, `ollamaText`, and more.
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
+
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-         <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
@@ -96,7 +256,7 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-           <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
           <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
@@ -106,28 +266,39 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/ai-react/package.json b/packages/typescript/ai-react/package.json
index e27af6cc0..1cedcda5d 100644
--- a/packages/typescript/ai-react/package.json
+++ b/packages/typescript/ai-react/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-react",
   "version": "0.11.5",
-  "description": "React hooks for TanStack AI",
+  "description": "React hooks for TanStack AI streaming chat, realtime voice, structured outputs, and media generation.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -34,11 +34,17 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
     "react",
     "hooks",
-    "tanstack",
     "chat",
-    "streaming"
+    "streaming",
+    "realtime",
+    "tool-calling",
+    "structured-outputs",
+    "media-generation"
   ],
   "dependencies": {
     "@tanstack/ai-client": "workspace:*"
diff --git a/packages/typescript/ai-solid-ui/README.md b/packages/typescript/ai-solid-ui/README.md
index 3411c085f..1c98040b8 100644
--- a/packages/typescript/ai-solid-ui/README.md
+++ b/packages/typescript/ai-solid-ui/README.md
@@ -1,65 +1,254 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
+
+Install the core package and the provider/framework packages your app uses:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
+
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
+
+## Streaming Chat
+
+```typescript
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+
+export async function POST(request: Request) {
+  const body = await request.json()
+
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+  return toServerSentEventsResponse(stream)
+}
+```
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Type-safe tools with server/client execution
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
 
-### <a href="https://tanstack.com/ai">Read the docs →</b></a>
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" height="40" />
-          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
       </a>
@@ -67,9 +256,9 @@ A powerful, type-safe AI SDK for building AI-powered applications.
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" />
-          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" height="60" />
-          <img src="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" height="60" alt="Cloudflare" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
+          <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
       </a>
     </td>
@@ -77,28 +266,39 @@ A powerful, type-safe AI SDK for building AI-powered applications.
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools">TanStack Devtools</a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/ai-solid-ui/package.json b/packages/typescript/ai-solid-ui/package.json
index 0b24f480d..36752a24f 100644
--- a/packages/typescript/ai-solid-ui/package.json
+++ b/packages/typescript/ai-solid-ui/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-solid-ui",
   "version": "0.7.0",
-  "description": "Headless Solid components for building AI chat interfaces",
+  "description": "Headless Solid components for building TanStack AI chat interfaces with streamed message parts.",
   "module": "./src/index.ts",
   "types": "./src/index.ts",
   "type": "module",
@@ -31,14 +31,18 @@
     "test:types": "tsc"
   },
   "keywords": [
-    "tanstack",
     "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
     "solid",
     "solidjs",
     "chat",
     "ui",
     "headless",
-    "components"
+    "components",
+    "streaming",
+    "generative-ai"
   ],
   "dependencies": {
     "rehype-highlight": "^7.0.2",
diff --git a/packages/typescript/ai-solid/package.json b/packages/typescript/ai-solid/package.json
index ade778fe8..a5c2bb4e6 100644
--- a/packages/typescript/ai-solid/package.json
+++ b/packages/typescript/ai-solid/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-solid",
   "version": "0.10.5",
-  "description": "Solid hooks for TanStack AI",
+  "description": "Solid hooks for TanStack AI streaming chat, structured outputs, and media generation.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -32,11 +32,17 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
+    "solid",
     "solidjs",
     "hooks",
-    "tanstack",
     "chat",
-    "streaming"
+    "streaming",
+    "tool-calling",
+    "structured-outputs",
+    "media-generation"
   ],
   "dependencies": {
     "@tanstack/ai-client": "workspace:*"
diff --git a/packages/typescript/ai-svelte/package.json b/packages/typescript/ai-svelte/package.json
index b12b6b740..ab933856a 100644
--- a/packages/typescript/ai-svelte/package.json
+++ b/packages/typescript/ai-svelte/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-svelte",
   "version": "0.10.5",
-  "description": "Svelte bindings for TanStack AI",
+  "description": "Svelte 5 bindings for TanStack AI streaming chat, structured outputs, and media generation.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -36,11 +36,16 @@
   },
   "keywords": [
     "ai",
-    "svelte",
-    "hooks",
+    "ai-sdk",
+    "typescript",
     "tanstack",
+    "svelte",
+    "svelte5",
     "chat",
-    "streaming"
+    "streaming",
+    "tool-calling",
+    "structured-outputs",
+    "media-generation"
   ],
   "dependencies": {
     "@tanstack/ai-client": "workspace:*"
diff --git a/packages/typescript/ai-utils/package.json b/packages/typescript/ai-utils/package.json
index 91447e6b5..49ad3eb33 100644
--- a/packages/typescript/ai-utils/package.json
+++ b/packages/typescript/ai-utils/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-utils",
   "version": "0.2.0",
-  "description": "Shared utilities for TanStack AI adapter packages",
+  "description": "Shared TypeScript utilities for TanStack AI provider adapters and runtime packages.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -34,8 +34,12 @@
   },
   "keywords": [
     "ai",
-    "utils",
-    "tanstack"
+    "ai-sdk",
+    "typescript",
+    "tanstack",
+    "utilities",
+    "adapter",
+    "provider-adapter"
   ],
   "devDependencies": {
     "@types/node": "^24.10.1",
diff --git a/packages/typescript/ai-vue-ui/README.md b/packages/typescript/ai-vue-ui/README.md
index 3411c085f..1c98040b8 100644
--- a/packages/typescript/ai-vue-ui/README.md
+++ b/packages/typescript/ai-vue-ui/README.md
@@ -1,65 +1,254 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
+
+Install the core package and the provider/framework packages your app uses:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
+
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
+
+## Streaming Chat
+
+```typescript
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+
+export async function POST(request: Request) {
+  const body = await request.json()
+
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+  return toServerSentEventsResponse(stream)
+}
+```
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Type-safe tools with server/client execution
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
 
-### <a href="https://tanstack.com/ai">Read the docs →</b></a>
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" height="40" />
-          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
       </a>
@@ -67,9 +256,9 @@ A powerful, type-safe AI SDK for building AI-powered applications.
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" />
-          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" height="60" />
-          <img src="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" height="60" alt="Cloudflare" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
+          <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
       </a>
     </td>
@@ -77,28 +266,39 @@ A powerful, type-safe AI SDK for building AI-powered applications.
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools">TanStack Devtools</a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/ai-vue-ui/package.json b/packages/typescript/ai-vue-ui/package.json
index fe4c165c7..055003ce1 100644
--- a/packages/typescript/ai-vue-ui/package.json
+++ b/packages/typescript/ai-vue-ui/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-vue-ui",
   "version": "0.2.1",
-  "description": "Headless Vue components for building AI chat interfaces",
+  "description": "Headless Vue components for building TanStack AI chat interfaces with streamed message parts.",
   "module": "./src/index.ts",
   "types": "./src/index.ts",
   "type": "module",
@@ -30,13 +30,17 @@
     "test:types": "vue-tsc --noEmit"
   },
   "keywords": [
-    "tanstack",
     "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
     "vue",
     "chat",
     "ui",
     "headless",
-    "components"
+    "components",
+    "streaming",
+    "generative-ai"
   ],
   "dependencies": {
     "@crazydos/vue-markdown": "^1.1.4",
diff --git a/packages/typescript/ai-vue/README.md b/packages/typescript/ai-vue/README.md
index 3411c085f..1c98040b8 100644
--- a/packages/typescript/ai-vue/README.md
+++ b/packages/typescript/ai-vue/README.md
@@ -1,65 +1,254 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
+
+Install the core package and the provider/framework packages your app uses:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
+
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
+
+## Streaming Chat
+
+```typescript
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+
+export async function POST(request: Request) {
+  const body = await request.json()
+
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+  return toServerSentEventsResponse(stream)
+}
+```
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Type-safe tools with server/client execution
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
 
-### <a href="https://tanstack.com/ai">Read the docs →</b></a>
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" height="40" />
-          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
       </a>
@@ -67,9 +256,9 @@ A powerful, type-safe AI SDK for building AI-powered applications.
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" />
-          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" height="60" />
-          <img src="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" height="60" alt="Cloudflare" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
+          <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
       </a>
     </td>
@@ -77,28 +266,39 @@ A powerful, type-safe AI SDK for building AI-powered applications.
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools">TanStack Devtools</a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/ai-vue/package.json b/packages/typescript/ai-vue/package.json
index 5c47135e1..41e0c619a 100644
--- a/packages/typescript/ai-vue/package.json
+++ b/packages/typescript/ai-vue/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai-vue",
   "version": "0.10.6",
-  "description": "Vue hooks for TanStack AI",
+  "description": "Vue composables for TanStack AI streaming chat, structured outputs, and media generation.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -32,11 +32,17 @@
   },
   "keywords": [
     "ai",
-    "vue",
-    "hooks",
+    "ai-sdk",
+    "typescript",
     "tanstack",
+    "vue",
+    "vue3",
+    "composables",
     "chat",
-    "streaming"
+    "streaming",
+    "tool-calling",
+    "structured-outputs",
+    "media-generation"
   ],
   "dependencies": {
     "@tanstack/ai-client": "workspace:*"
diff --git a/packages/typescript/ai/README.md b/packages/typescript/ai/README.md
index 26e3db048..1c98040b8 100644
--- a/packages/typescript/ai/README.md
+++ b/packages/typescript/ai/README.md
@@ -1,93 +1,253 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+Install the core package and the provider/framework packages your app uses:
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- **Tree-shakeable adapters** - Import only what you need for smaller bundles
-- **Multimodal content support** - Send images, audio, video, and documents
-- **Image generation** - Generate images with OpenAI DALL-E/GPT-Image and Gemini Imagen
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Isomorphic type-safe tools with server/client execution
-- **Enhanced integration with TanStack Start** - Share implementations between AI tools and server functions
-- **Observability events** - Structured, typed events for text, tools, image, speech, transcription, and video ([docs](./docs/guides/observability.md))
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
 
-### <a href="https://tanstack.com/ai">Read the docs →</a>
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
 
-## Tree-Shakeable Adapters
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
 
-Import only the functionality you need for smaller bundle sizes:
+## Streaming Chat
 
 ```typescript
-// Only chat functionality - no summarization code bundled
-import { openaiText } from '@tanstack/ai-openai/adapters'
-import { generate } from '@tanstack/ai'
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
 
-const textAdapter = openaiText()
+export async function POST(request: Request) {
+  const body = await request.json()
 
-const result = generate({
-  adapter: textAdapter,
-  model: 'gpt-4o',
-  messages: [{ role: 'user', content: [{ type: 'text', content: 'Hello!' }] }],
-})
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-for await (const chunk of result) {
-  console.log(chunk)
+  return toServerSentEventsResponse(stream)
 }
 ```
 
-Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicText`, `geminiText`, `ollamaText`, and more.
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
+
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-         <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
@@ -96,7 +256,7 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-           <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
           <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
@@ -106,28 +266,39 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/ai/package.json b/packages/typescript/ai/package.json
index d1584ddb8..8b71beba5 100644
--- a/packages/typescript/ai/package.json
+++ b/packages/typescript/ai/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/ai",
   "version": "0.21.1",
-  "description": "Core TanStack AI library - Open source AI SDK",
+  "description": "Type-safe TypeScript AI SDK for streaming chat, tool calling, agents, structured outputs, and multimodal generation.",
   "author": "Tanner Linsley",
   "license": "MIT",
   "repository": {
@@ -57,11 +57,19 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
     "tanstack",
-    "sdk",
     "llm",
+    "generative-ai",
     "chat",
-    "embeddings",
+    "streaming",
+    "tool-calling",
+    "function-calling",
+    "agents",
+    "structured-outputs",
+    "multimodal",
+    "zod",
     "tanstack-intent"
   ],
   "dependencies": {
diff --git a/packages/typescript/openai-base/package.json b/packages/typescript/openai-base/package.json
index a80e10749..41f614d68 100644
--- a/packages/typescript/openai-base/package.json
+++ b/packages/typescript/openai-base/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/openai-base",
   "version": "0.3.5",
-  "description": "Shared base adapters for OpenAI-SDK-backed providers in TanStack AI (Chat Completions and Responses)",
+  "description": "Shared OpenAI SDK base adapters for TanStack AI providers using Chat Completions and Responses APIs.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -34,9 +34,15 @@
   },
   "keywords": [
     "ai",
-    "openai",
+    "ai-sdk",
+    "typescript",
     "tanstack",
-    "adapter"
+    "openai",
+    "adapter",
+    "provider-adapter",
+    "chat-completions",
+    "responses-api",
+    "structured-outputs"
   ],
   "dependencies": {
     "@tanstack/ai-utils": "workspace:*",
diff --git a/packages/typescript/preact-ai-devtools/README.md b/packages/typescript/preact-ai-devtools/README.md
index 26e3db048..1c98040b8 100644
--- a/packages/typescript/preact-ai-devtools/README.md
+++ b/packages/typescript/preact-ai-devtools/README.md
@@ -1,93 +1,253 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+Install the core package and the provider/framework packages your app uses:
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- **Tree-shakeable adapters** - Import only what you need for smaller bundles
-- **Multimodal content support** - Send images, audio, video, and documents
-- **Image generation** - Generate images with OpenAI DALL-E/GPT-Image and Gemini Imagen
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Isomorphic type-safe tools with server/client execution
-- **Enhanced integration with TanStack Start** - Share implementations between AI tools and server functions
-- **Observability events** - Structured, typed events for text, tools, image, speech, transcription, and video ([docs](./docs/guides/observability.md))
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
 
-### <a href="https://tanstack.com/ai">Read the docs →</a>
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
 
-## Tree-Shakeable Adapters
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
 
-Import only the functionality you need for smaller bundle sizes:
+## Streaming Chat
 
 ```typescript
-// Only chat functionality - no summarization code bundled
-import { openaiText } from '@tanstack/ai-openai/adapters'
-import { generate } from '@tanstack/ai'
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
 
-const textAdapter = openaiText()
+export async function POST(request: Request) {
+  const body = await request.json()
 
-const result = generate({
-  adapter: textAdapter,
-  model: 'gpt-4o',
-  messages: [{ role: 'user', content: [{ type: 'text', content: 'Hello!' }] }],
-})
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-for await (const chunk of result) {
-  console.log(chunk)
+  return toServerSentEventsResponse(stream)
 }
 ```
 
-Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicText`, `geminiText`, `ollamaText`, and more.
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
+
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-         <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
@@ -96,7 +256,7 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-           <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
           <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
@@ -106,28 +266,39 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/preact-ai-devtools/package.json b/packages/typescript/preact-ai-devtools/package.json
index 3b7bd07d9..f38932981 100644
--- a/packages/typescript/preact-ai-devtools/package.json
+++ b/packages/typescript/preact-ai-devtools/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/preact-ai-devtools",
   "version": "0.1.39",
-  "description": "Preact Devtools for TanStack AI.",
+  "description": "Preact Devtools plugin for inspecting TanStack AI chat messages, tool calls, streams, and errors.",
   "author": "tannerlinsley",
   "license": "MIT",
   "homepage": "https://tanstack.com/ai",
@@ -57,5 +57,17 @@
   },
   "peerDependencies": {
     "preact": "^10.0.0"
-  }
+  },
+  "keywords": [
+    "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
+    "preact",
+    "devtools",
+    "debugging",
+    "observability",
+    "chat",
+    "tool-calling"
+  ]
 }
diff --git a/packages/typescript/react-ai-devtools/README.md b/packages/typescript/react-ai-devtools/README.md
index 26e3db048..1c98040b8 100644
--- a/packages/typescript/react-ai-devtools/README.md
+++ b/packages/typescript/react-ai-devtools/README.md
@@ -1,93 +1,253 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+Install the core package and the provider/framework packages your app uses:
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- **Tree-shakeable adapters** - Import only what you need for smaller bundles
-- **Multimodal content support** - Send images, audio, video, and documents
-- **Image generation** - Generate images with OpenAI DALL-E/GPT-Image and Gemini Imagen
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Isomorphic type-safe tools with server/client execution
-- **Enhanced integration with TanStack Start** - Share implementations between AI tools and server functions
-- **Observability events** - Structured, typed events for text, tools, image, speech, transcription, and video ([docs](./docs/guides/observability.md))
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
 
-### <a href="https://tanstack.com/ai">Read the docs →</a>
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
 
-## Tree-Shakeable Adapters
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
 
-Import only the functionality you need for smaller bundle sizes:
+## Streaming Chat
 
 ```typescript
-// Only chat functionality - no summarization code bundled
-import { openaiText } from '@tanstack/ai-openai/adapters'
-import { generate } from '@tanstack/ai'
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
 
-const textAdapter = openaiText()
+export async function POST(request: Request) {
+  const body = await request.json()
 
-const result = generate({
-  adapter: textAdapter,
-  model: 'gpt-4o',
-  messages: [{ role: 'user', content: [{ type: 'text', content: 'Hello!' }] }],
-})
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-for await (const chunk of result) {
-  console.log(chunk)
+  return toServerSentEventsResponse(stream)
 }
 ```
 
-Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicText`, `geminiText`, `ollamaText`, and more.
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
+
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-         <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
@@ -96,7 +256,7 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-           <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
           <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
@@ -106,28 +266,39 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/react-ai-devtools/package.json b/packages/typescript/react-ai-devtools/package.json
index 63c9f8f7a..8499bba6d 100644
--- a/packages/typescript/react-ai-devtools/package.json
+++ b/packages/typescript/react-ai-devtools/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/react-ai-devtools",
   "version": "0.2.39",
-  "description": "React Devtools for TanStack AI.",
+  "description": "React Devtools plugin for inspecting TanStack AI chat messages, tool calls, streams, and errors.",
   "author": "tannerlinsley",
   "license": "MIT",
   "homepage": "https://tanstack.com/ai",
@@ -60,5 +60,17 @@
     "@vitest/coverage-v8": "4.0.14",
     "react": "^19.2.3",
     "vite": "^7.3.3"
-  }
+  },
+  "keywords": [
+    "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
+    "react",
+    "devtools",
+    "debugging",
+    "observability",
+    "chat",
+    "tool-calling"
+  ]
 }
diff --git a/packages/typescript/solid-ai-devtools/README.md b/packages/typescript/solid-ai-devtools/README.md
index 26e3db048..1c98040b8 100644
--- a/packages/typescript/solid-ai-devtools/README.md
+++ b/packages/typescript/solid-ai-devtools/README.md
@@ -1,93 +1,253 @@
 <div align="center">
-  <img src="./media/header_ai.png" >
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/header_ai.png" alt="TanStack AI" />
 </div>
 
 <br />
 
 <div align="center">
-<a href="https://npmjs.com/package/@tanstack/ai" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
-</a>
-<a href="https://github.com/TanStack/ai" target="\_parent">
-	  <img alt="" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" alt="GitHub stars" />
-</a>
-<a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="\_parent">
-  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
-</a>
+  <a href="https://npmjs.com/package/@tanstack/ai" target="_parent">
+    <img alt="NPM downloads" src="https://img.shields.io/npm/dm/@tanstack/ai.svg" />
+  </a>
+  <a href="https://github.com/TanStack/ai" target="_parent">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/ai.svg?style=social&label=Star" />
+  </a>
+  <a href="https://github.com/TanStack/ai/releases" target="_parent">
+    <img alt="Release" src="https://img.shields.io/github/v/release/tanstack/ai" />
+  </a>
+  <a href="https://bundlephobia.com/result?p=@tanstack/ai@latest" target="_parent">
+    <img alt="Bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/ai@latest" />
+  </a>
+  <a href="https://twitter.com/tan_stack">
+    <img alt="Follow @TanStack" src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" />
+  </a>
 </div>
 
-<div align="center">
-<a href="#badge">
-  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
-</a>
-	<a href="#badge">
-		<img src="https://img.shields.io/github/v/release/tanstack/ai" alt="Release"/>
-	</a>
-<a href="https://twitter.com/tan_stack">
-  <img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
-</a>
-</div>
+# TanStack AI
 
-<div align="center">
-  
-### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-</div>
+Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
+tool-calling agents, structured outputs, realtime voice, media generation, and
+framework-native AI apps.
 
-# TanStack AI
+TanStack AI is built from composable activities and provider adapters. Use one
+provider or switch between many. Import only chat, or add image, audio, video,
+speech, transcription, summarization, realtime, Code Mode, devtools, and
+framework bindings as your app needs them.
+
+## <a href="https://tanstack.com/ai">Read the docs -></a>
+
+## Start Here
+
+- [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
+  what TanStack AI is and how the packages fit together.
+- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat to a React app.
+- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
+  build with Vue composables.
+- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
+  build with Svelte 5 runes.
+- [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
+  use TanStack AI from a server endpoint, script, or backend service.
+- [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
+  compare architecture, feature coverage, and tradeoffs.
+
+## What You Can Build
+
+- Streaming chat experiences with typed messages, tool calls, reasoning parts,
+  and configurable connection adapters.
+- Type-safe tools that can run on the server or client from one shared
+  `toolDefinition()` contract.
+- Structured output flows backed by JSON Schema, Zod, ArkType, Valibot, or
+  plain JSON Schema.
+- Multimodal prompts and responses that include text, images, audio, video, and
+  documents.
+- Image, audio, video, speech, transcription, and summarization workflows using
+  a shared generation client pattern.
+- Realtime voice chat with provider adapters for realtime sessions and token
+  minting.
+- Code Mode agents that let an LLM write and execute TypeScript in an isolated
+  sandbox to orchestrate tools with loops, branches, and parallel calls.
+- Devtools and observability pipelines for inspecting messages, tool calls,
+  stream chunks, errors, usage, and OpenTelemetry traces.
+- Framework-native clients for React, Solid, Vue, Svelte, and Preact, plus a
+  headless client for custom runtimes.
+
+## Install
 
-A powerful, type-safe AI SDK for building AI-powered applications.
+Install the core package and the provider/framework packages your app uses:
 
-- Provider-agnostic adapters (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- **Tree-shakeable adapters** - Import only what you need for smaller bundles
-- **Multimodal content support** - Send images, audio, video, and documents
-- **Image generation** - Generate images with OpenAI DALL-E/GPT-Image and Gemini Imagen
-- Chat completion, streaming, and agent loop strategies
-- Headless chat state management with adapters (SSE, HTTP stream, custom)
-- Isomorphic type-safe tools with server/client execution
-- **Enhanced integration with TanStack Start** - Share implementations between AI tools and server functions
-- **Observability events** - Structured, typed events for text, tools, image, speech, transcription, and video ([docs](./docs/guides/observability.md))
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openai
+```
+
+For a React chat UI:
+
+```bash
+pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
+```
 
-### <a href="https://tanstack.com/ai">Read the docs →</a>
+OpenRouter is also a good starting point if you want access to many providers
+through one API key:
 
-## Tree-Shakeable Adapters
+```bash
+pnpm add @tanstack/ai @tanstack/ai-openrouter
+```
 
-Import only the functionality you need for smaller bundle sizes:
+## Streaming Chat
 
 ```typescript
-// Only chat functionality - no summarization code bundled
-import { openaiText } from '@tanstack/ai-openai/adapters'
-import { generate } from '@tanstack/ai'
+import { chat, toServerSentEventsResponse } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
 
-const textAdapter = openaiText()
+export async function POST(request: Request) {
+  const body = await request.json()
 
-const result = generate({
-  adapter: textAdapter,
-  model: 'gpt-4o',
-  messages: [{ role: 'user', content: [{ type: 'text', content: 'Hello!' }] }],
-})
+  const stream = chat({
+    adapter: openaiText('gpt-5.2'),
+    messages: body.messages,
+  })
 
-for await (const chunk of result) {
-  console.log(chunk)
+  return toServerSentEventsResponse(stream)
 }
 ```
 
-Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicText`, `geminiText`, `ollamaText`, and more.
+Learn more in the
+[Chat & Streaming docs](https://tanstack.com/ai/latest/docs/chat/streaming) and
+[Connection Adapters docs](https://tanstack.com/ai/latest/docs/chat/connection-adapters).
+
+## Type-Safe Tools
+
+Define a tool once, then attach a server or client implementation with the same
+input and output types:
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { z } from 'zod'
+
+const getProducts = toolDefinition({
+  name: 'getProducts',
+  description: 'Search the product catalog',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+    }),
+  ),
+}).server(async ({ query }) => {
+  return db.products.search(query)
+})
+```
+
+Learn more in the
+[Tools docs](https://tanstack.com/ai/latest/docs/tools/tools),
+[Tool Approval Flow docs](https://tanstack.com/ai/latest/docs/tools/tool-approval),
+and
+[Lazy Tool Discovery docs](https://tanstack.com/ai/latest/docs/tools/lazy-tool-discovery).
+
+## Structured Outputs
+
+Use `outputSchema` when you need typed objects instead of freeform text:
+
+```typescript
+import { chat } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { z } from 'zod'
+
+const Person = z.object({
+  name: z.string(),
+  age: z.number(),
+})
+
+const person = await chat({
+  adapter: openaiText('gpt-5.2'),
+  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
+  outputSchema: Person,
+})
+```
+
+Learn more in the
+[Structured Outputs docs](https://tanstack.com/ai/latest/docs/structured-outputs/overview).
+
+## Media, Realtime, and Code Mode
+
+- [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
+  pattern for image generation, text-to-speech, transcription, summarization,
+  audio generation, and video generation.
+- [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
+  build low-latency realtime voice experiences.
+- [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
+  models write and execute TypeScript inside a secure isolate.
+- [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
+  give Code Mode reusable runtime capabilities.
+
+## Providers
+
+Official adapters include:
+
+| Package                                                                              | Use it for                                                                     |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API                                         |
+| [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai)         | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
+| [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic)   | Anthropic Claude chat, thinking, tools, and structured outputs                 |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                        |
+| [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama)         | Local Ollama models                                                            |
+| [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok)             | xAI Grok chat, images, and realtime                                            |
+| [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq)             | Groq low-latency inference                                                     |
+| [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects     |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                   |
+
+The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
+`openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
+on.
+
+## Framework Packages
+
+| Package                                                                    | What it provides                                                         |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
+| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+
+## Advanced Docs
+
+- [Middleware](https://tanstack.com/ai/latest/docs/advanced/middleware) - hook
+  into chat configuration, chunks, tool calls, usage, errors, and structured
+  outputs.
+- [OpenTelemetry](https://tanstack.com/ai/latest/docs/advanced/otel) - emit
+  vendor-neutral GenAI traces and metrics.
+- [Observability](https://tanstack.com/ai/latest/docs/advanced/observability) -
+  subscribe to typed TanStack AI events.
+- [Per-Model Type Safety](https://tanstack.com/ai/latest/docs/advanced/per-model-type-safety) -
+  narrow model options and content modalities to the selected model.
+- [Runtime Adapter Switching](https://tanstack.com/ai/latest/docs/advanced/runtime-adapter-switching) -
+  switch providers at runtime.
+- [Tree-Shaking](https://tanstack.com/ai/latest/docs/advanced/tree-shaking) -
+  ship only the activities and adapters you use.
+- [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
+  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
+  and other coding agents with TanStack Intent.
 
 ## Get Involved
 
-- We welcome issues and pull requests!
-- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions)
-- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
-- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+- Read the [docs](https://tanstack.com/ai).
+- Participate in [GitHub discussions](https://github.com/TanStack/ai/discussions).
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ).
+- See [CONTRIBUTING.md](https://github.com/TanStack/ai/blob/main/CONTRIBUTING.md)
+  for setup instructions.
+- [Become a sponsor](https://github.com/sponsors/tannerlinsley/).
 
 ## Partners
 
 <table align="center">
   <tr>
     <td>
-      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
         <picture>
-         <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
           <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
         </picture>
@@ -96,7 +256,7 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
     <td>
       <a href="https://www.cloudflare.com?utm_source=tanstack">
         <picture>
-           <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
           <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
           <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
         </picture>
@@ -106,28 +266,39 @@ Available adapters: `openaiText`, `openaiEmbed`, `openaiSummarize`, `anthropicTe
 </table>
 
 <div align="center">
-<img src="./media/partner_logo.svg" alt="AI & you?" height="65">
-<p>
-We're looking for TanStack AI Partners to join our mission! Partner with us to push the boundaries of TanStack AI and build amazing things together.
-</p>
-<a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
+  <img src="https://raw.githubusercontent.com/TanStack/ai/main/media/partner_logo.svg" alt="AI and you?" height="65" />
+  <p>
+    We're looking for TanStack AI partners to join our mission. Partner with us
+    to push the boundaries of TanStack AI and build amazing things together.
+  </p>
+  <a href="mailto:partners@tanstack.com?subject=TanStack AI Partnership"><b>LET'S CHAT</b></a>
 </div>
 
 ## Explore the TanStack Ecosystem
 
-- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
-- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> – Unified devtools panel
-- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
-- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
-- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
-- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
-- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
-- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
-- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
-- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
-- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
-
-… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
-
-<!-- USE THE FORCE LUKE -->
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> -
+  tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> - reactive
+  sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> -
+  unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> -
+  type-safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> -
+  debouncing, throttling, batching
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> -
+  async state and caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> -
+  range and slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> -
+  type-safe routing, caching, and URL state
+- <a href="https://github.com/tanstack/start"><b>TanStack Start</b></a> -
+  full-stack SSR and streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> -
+  reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> -
+  headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> -
+  virtualized rendering
+
+...and more at <a href="https://tanstack.com"><b>TanStack.com</b></a>.
diff --git a/packages/typescript/solid-ai-devtools/package.json b/packages/typescript/solid-ai-devtools/package.json
index ae4d3ecd7..757697cb0 100644
--- a/packages/typescript/solid-ai-devtools/package.json
+++ b/packages/typescript/solid-ai-devtools/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/solid-ai-devtools",
   "version": "0.2.39",
-  "description": "Solid TanStack AI Devtools",
+  "description": "Solid Devtools plugin for inspecting TanStack AI chat messages, tool calls, streams, and errors.",
   "author": "",
   "license": "MIT",
   "repository": {
@@ -40,11 +40,16 @@
   },
   "keywords": [
     "ai",
+    "ai-sdk",
+    "typescript",
     "tanstack",
-    "sdk",
-    "llm",
+    "solid",
+    "solidjs",
+    "devtools",
+    "debugging",
+    "observability",
     "chat",
-    "embeddings"
+    "tool-calling"
   ],
   "dependencies": {
     "@tanstack/ai-devtools-core": "workspace:*",
diff --git a/scripts/copy-readme.js b/scripts/copy-readme.js
new file mode 100644
index 000000000..ddc2fbd0d
--- /dev/null
+++ b/scripts/copy-readme.js
@@ -0,0 +1,28 @@
+import { copyFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const rootDir = dirname(dirname(fileURLToPath(import.meta.url)))
+
+const targets = [
+  'packages/typescript/ai/README.md',
+  'packages/typescript/ai-client/README.md',
+  'packages/typescript/ai-devtools/README.md',
+  'packages/typescript/ai-gemini/README.md',
+  'packages/typescript/ai-ollama/README.md',
+  'packages/typescript/ai-openai/README.md',
+  'packages/typescript/ai-openrouter/README.md',
+  'packages/typescript/ai-preact/README.md',
+  'packages/typescript/ai-react/README.md',
+  'packages/typescript/ai-react-ui/README.md',
+  'packages/typescript/ai-solid-ui/README.md',
+  'packages/typescript/ai-vue/README.md',
+  'packages/typescript/ai-vue-ui/README.md',
+  'packages/typescript/preact-ai-devtools/README.md',
+  'packages/typescript/react-ai-devtools/README.md',
+  'packages/typescript/solid-ai-devtools/README.md',
+]
+
+for (const target of targets) {
+  copyFileSync(join(rootDir, 'README.md'), join(rootDir, target))
+}

From 6ec3e78cc31e741933e8e35e17bb5647fecb1ba4 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Fri, 22 May 2026 16:42:34 +0200
Subject: [PATCH 05/10] ci: Version Packages (#627)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 .changeset/openai-gpt-image-2.md              | 22 ------------
 .../openrouter-web-fetch-tool-capability.md   |  5 ---
 .changeset/openrouter-web-fetch-tool-types.md |  5 ---
 .changeset/refresh-readme-package-metadata.md | 35 -------------------
 .changeset/sync-models.md                     |  5 ---
 packages/typescript/ai-anthropic/CHANGELOG.md | 10 ++++++
 packages/typescript/ai-anthropic/package.json |  2 +-
 packages/typescript/ai-client/CHANGELOG.md    | 10 ++++++
 packages/typescript/ai-client/package.json    |  2 +-
 .../ai-code-mode-skills/CHANGELOG.md          | 10 ++++++
 .../ai-code-mode-skills/package.json          |  2 +-
 packages/typescript/ai-code-mode/CHANGELOG.md |  9 +++++
 packages/typescript/ai-code-mode/package.json |  2 +-
 packages/typescript/ai-devtools/CHANGELOG.md  | 10 ++++++
 packages/typescript/ai-devtools/package.json  |  2 +-
 .../typescript/ai-elevenlabs/CHANGELOG.md     | 11 ++++++
 .../typescript/ai-elevenlabs/package.json     |  2 +-
 .../typescript/ai-event-client/CHANGELOG.md   |  9 +++++
 .../typescript/ai-event-client/package.json   |  2 +-
 packages/typescript/ai-fal/CHANGELOG.md       | 10 ++++++
 packages/typescript/ai-fal/package.json       |  2 +-
 packages/typescript/ai-gemini/CHANGELOG.md    | 10 ++++++
 packages/typescript/ai-gemini/package.json    |  2 +-
 packages/typescript/ai-grok/CHANGELOG.md      | 11 ++++++
 packages/typescript/ai-grok/package.json      |  2 +-
 packages/typescript/ai-groq/CHANGELOG.md      | 11 ++++++
 packages/typescript/ai-groq/package.json      |  2 +-
 .../ai-isolate-cloudflare/CHANGELOG.md        |  9 +++++
 .../ai-isolate-cloudflare/package.json        |  2 +-
 .../typescript/ai-isolate-node/CHANGELOG.md   |  9 +++++
 .../typescript/ai-isolate-node/package.json   |  2 +-
 .../ai-isolate-quickjs/CHANGELOG.md           |  9 +++++
 .../ai-isolate-quickjs/package.json           |  2 +-
 packages/typescript/ai-ollama/CHANGELOG.md    | 10 ++++++
 packages/typescript/ai-ollama/package.json    |  2 +-
 packages/typescript/ai-openai/CHANGELOG.md    | 33 +++++++++++++++++
 packages/typescript/ai-openai/package.json    |  2 +-
 .../typescript/ai-openrouter/CHANGELOG.md     | 16 +++++++++
 .../typescript/ai-openrouter/package.json     |  2 +-
 packages/typescript/ai-preact/CHANGELOG.md    | 10 ++++++
 packages/typescript/ai-preact/package.json    |  2 +-
 packages/typescript/ai-react-ui/CHANGELOG.md  | 10 ++++++
 packages/typescript/ai-react-ui/package.json  |  2 +-
 packages/typescript/ai-react/CHANGELOG.md     | 10 ++++++
 packages/typescript/ai-react/package.json     |  2 +-
 packages/typescript/ai-solid-ui/CHANGELOG.md  | 10 ++++++
 packages/typescript/ai-solid-ui/package.json  |  2 +-
 packages/typescript/ai-solid/CHANGELOG.md     | 10 ++++++
 packages/typescript/ai-solid/package.json     |  2 +-
 packages/typescript/ai-svelte/CHANGELOG.md    | 10 ++++++
 packages/typescript/ai-svelte/package.json    |  2 +-
 packages/typescript/ai-utils/CHANGELOG.md     |  6 ++++
 packages/typescript/ai-utils/package.json     |  2 +-
 packages/typescript/ai-vue-ui/CHANGELOG.md    |  9 +++++
 packages/typescript/ai-vue-ui/package.json    |  2 +-
 packages/typescript/ai-vue/CHANGELOG.md       | 10 ++++++
 packages/typescript/ai-vue/package.json       |  2 +-
 packages/typescript/ai/CHANGELOG.md           |  9 +++++
 packages/typescript/ai/package.json           |  2 +-
 packages/typescript/openai-base/CHANGELOG.md  | 10 ++++++
 packages/typescript/openai-base/package.json  |  2 +-
 .../preact-ai-devtools/CHANGELOG.md           |  9 +++++
 .../preact-ai-devtools/package.json           |  2 +-
 .../typescript/react-ai-devtools/CHANGELOG.md |  9 +++++
 .../typescript/react-ai-devtools/package.json |  2 +-
 .../typescript/solid-ai-devtools/CHANGELOG.md |  9 +++++
 .../typescript/solid-ai-devtools/package.json |  2 +-
 67 files changed, 359 insertions(+), 103 deletions(-)
 delete mode 100644 .changeset/openai-gpt-image-2.md
 delete mode 100644 .changeset/openrouter-web-fetch-tool-capability.md
 delete mode 100644 .changeset/openrouter-web-fetch-tool-types.md
 delete mode 100644 .changeset/refresh-readme-package-metadata.md
 delete mode 100644 .changeset/sync-models.md

diff --git a/.changeset/openai-gpt-image-2.md b/.changeset/openai-gpt-image-2.md
deleted file mode 100644
index bc987807e..000000000
--- a/.changeset/openai-gpt-image-2.md
+++ /dev/null
@@ -1,22 +0,0 @@
----
-'@tanstack/ai-openai': minor
----
-
-Add `gpt-image-2` to the OpenAI image model list. The new model is exposed
-through the same tree-shakeable `openaiImage` adapter as `gpt-image-1` and
-shares its provider options (`quality`, `background`, `output_format`,
-`output_compression`, `moderation`, `partial_images`) and size set
-(`1024x1024`, `1536x1024`, `1024x1536`, `auto`).
-
-```ts
-import { openaiImage } from '@tanstack/ai-openai/adapters'
-import { generate } from '@tanstack/ai'
-
-const adapter = openaiImage({ apiKey: process.env.OPENAI_API_KEY! })
-
-const result = await generate({
-  adapter,
-  model: 'gpt-image-2',
-  prompt: 'A watercolor fox in a snowy forest',
-})
-```
diff --git a/.changeset/openrouter-web-fetch-tool-capability.md b/.changeset/openrouter-web-fetch-tool-capability.md
deleted file mode 100644
index 5054fe92d..000000000
--- a/.changeset/openrouter-web-fetch-tool-capability.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-'@tanstack/ai-openrouter': patch
----
-
-Restore `web_fetch` in `OpenRouterChatModelToolCapabilitiesByName` so `webFetchTool()` is assignable to OpenRouter text adapters again. The recent model-metadata sync (#623) regenerated this map with `web_search` only, breaking the per-model type-safety tests added in #611.
diff --git a/.changeset/openrouter-web-fetch-tool-types.md b/.changeset/openrouter-web-fetch-tool-types.md
deleted file mode 100644
index 066b2faa9..000000000
--- a/.changeset/openrouter-web-fetch-tool-types.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-'@tanstack/ai-openrouter': patch
----
-
-Fix OpenRouter provider tool type metadata to include `webFetchTool`.
diff --git a/.changeset/refresh-readme-package-metadata.md b/.changeset/refresh-readme-package-metadata.md
deleted file mode 100644
index 2564ffd9d..000000000
--- a/.changeset/refresh-readme-package-metadata.md
+++ /dev/null
@@ -1,35 +0,0 @@
----
-'@tanstack/ai': patch
-'@tanstack/ai-anthropic': patch
-'@tanstack/ai-client': patch
-'@tanstack/ai-code-mode': patch
-'@tanstack/ai-code-mode-skills': patch
-'@tanstack/ai-devtools-core': patch
-'@tanstack/ai-elevenlabs': patch
-'@tanstack/ai-event-client': patch
-'@tanstack/ai-fal': patch
-'@tanstack/ai-gemini': patch
-'@tanstack/ai-grok': patch
-'@tanstack/ai-groq': patch
-'@tanstack/ai-isolate-cloudflare': patch
-'@tanstack/ai-isolate-node': patch
-'@tanstack/ai-isolate-quickjs': patch
-'@tanstack/ai-ollama': patch
-'@tanstack/ai-openai': patch
-'@tanstack/ai-openrouter': patch
-'@tanstack/ai-preact': patch
-'@tanstack/ai-react': patch
-'@tanstack/ai-react-ui': patch
-'@tanstack/ai-solid': patch
-'@tanstack/ai-solid-ui': patch
-'@tanstack/ai-svelte': patch
-'@tanstack/ai-utils': patch
-'@tanstack/ai-vue': patch
-'@tanstack/ai-vue-ui': patch
-'@tanstack/openai-base': patch
-'@tanstack/preact-ai-devtools': patch
-'@tanstack/react-ai-devtools': patch
-'@tanstack/solid-ai-devtools': patch
----
-
-Refresh package README content and npm metadata for better discoverability.
diff --git a/.changeset/sync-models.md b/.changeset/sync-models.md
deleted file mode 100644
index 63eef764c..000000000
--- a/.changeset/sync-models.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-'@tanstack/ai-openrouter': patch
----
-
-Update model metadata from OpenRouter API
diff --git a/packages/typescript/ai-anthropic/CHANGELOG.md b/packages/typescript/ai-anthropic/CHANGELOG.md
index fd2d0d17f..891dda51d 100644
--- a/packages/typescript/ai-anthropic/CHANGELOG.md
+++ b/packages/typescript/ai-anthropic/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/ai-anthropic
 
+## 0.10.3
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-utils@0.2.1
+
 ## 0.10.2
 
 ### Patch Changes
diff --git a/packages/typescript/ai-anthropic/package.json b/packages/typescript/ai-anthropic/package.json
index 47ba1e6a8..680cc5f82 100644
--- a/packages/typescript/ai-anthropic/package.json
+++ b/packages/typescript/ai-anthropic/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-anthropic",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "Anthropic Claude adapter for TanStack AI chat, tool calling, thinking, and structured outputs.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-client/CHANGELOG.md b/packages/typescript/ai-client/CHANGELOG.md
index 8b52c7cad..08122d965 100644
--- a/packages/typescript/ai-client/CHANGELOG.md
+++ b/packages/typescript/ai-client/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/ai-client
 
+## 0.11.6
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-event-client@0.3.9
+
 ## 0.11.5
 
 ### Patch Changes
diff --git a/packages/typescript/ai-client/package.json b/packages/typescript/ai-client/package.json
index a98d98adf..b6e40f456 100644
--- a/packages/typescript/ai-client/package.json
+++ b/packages/typescript/ai-client/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-client",
-  "version": "0.11.5",
+  "version": "0.11.6",
   "description": "Framework-agnostic headless client for TanStack AI chat, realtime sessions, streaming transports, and media generations.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-code-mode-skills/CHANGELOG.md b/packages/typescript/ai-code-mode-skills/CHANGELOG.md
index 53bfdcdef..82923e3e1 100644
--- a/packages/typescript/ai-code-mode-skills/CHANGELOG.md
+++ b/packages/typescript/ai-code-mode-skills/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/ai-code-mode-skills
 
+## 0.1.19
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-code-mode@0.1.19
+
 ## 0.1.18
 
 ### Patch Changes
diff --git a/packages/typescript/ai-code-mode-skills/package.json b/packages/typescript/ai-code-mode-skills/package.json
index 25991aab1..ebc48dd3f 100644
--- 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.18",
+  "version": "0.1.19",
   "description": "Persistent runtime skill library for TanStack AI Code Mode agents and sandboxed tool orchestration.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-code-mode/CHANGELOG.md b/packages/typescript/ai-code-mode/CHANGELOG.md
index 54b1bfb6f..ee3d3414a 100644
--- a/packages/typescript/ai-code-mode/CHANGELOG.md
+++ b/packages/typescript/ai-code-mode/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @tanstack/ai-code-mode
 
+## 0.1.19
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+
 ## 0.1.18
 
 ### Patch Changes
diff --git a/packages/typescript/ai-code-mode/package.json b/packages/typescript/ai-code-mode/package.json
index 212fe1ac1..70498aa72 100644
--- 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.18",
+  "version": "0.1.19",
   "description": "Secure TypeScript Code Mode for TanStack AI agents to execute sandboxed tool orchestration programs.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-devtools/CHANGELOG.md b/packages/typescript/ai-devtools/CHANGELOG.md
index 68c4b893e..8ad237c00 100644
--- a/packages/typescript/ai-devtools/CHANGELOG.md
+++ b/packages/typescript/ai-devtools/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/ai-devtools-core
 
+## 0.3.36
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-event-client@0.3.9
+
 ## 0.3.35
 
 ### Patch Changes
diff --git a/packages/typescript/ai-devtools/package.json b/packages/typescript/ai-devtools/package.json
index fb43d31a2..d7ca23d69 100644
--- 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.35",
+  "version": "0.3.36",
   "description": "Core TanStack AI Devtools plugin for inspecting chat messages, tool calls, streams, and errors.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-elevenlabs/CHANGELOG.md b/packages/typescript/ai-elevenlabs/CHANGELOG.md
index 7ba268ce6..b5607f097 100644
--- a/packages/typescript/ai-elevenlabs/CHANGELOG.md
+++ b/packages/typescript/ai-elevenlabs/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @tanstack/ai-elevenlabs
 
+## 0.2.10
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-client@0.11.6
+  - @tanstack/ai-utils@0.2.1
+
 ## 0.2.9
 
 ### Patch Changes
diff --git a/packages/typescript/ai-elevenlabs/package.json b/packages/typescript/ai-elevenlabs/package.json
index 4354f2211..774c1ff1e 100644
--- 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.9",
+  "version": "0.2.10",
   "description": "ElevenLabs adapter for TanStack AI realtime voice, text-to-speech, transcription, music, and sound effects.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-event-client/CHANGELOG.md b/packages/typescript/ai-event-client/CHANGELOG.md
index d0c741799..1c327312e 100644
--- a/packages/typescript/ai-event-client/CHANGELOG.md
+++ b/packages/typescript/ai-event-client/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @tanstack/ai-event-client
 
+## 0.3.9
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+
 ## 0.3.8
 
 ### Patch Changes
diff --git a/packages/typescript/ai-event-client/package.json b/packages/typescript/ai-event-client/package.json
index 845246096..64d5a3eee 100644
--- 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.3.8",
+  "version": "0.3.9",
   "description": "Typed event client for TanStack AI devtools, observability, and streamed runtime events.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-fal/CHANGELOG.md b/packages/typescript/ai-fal/CHANGELOG.md
index 50a976703..c9faa7fc9 100644
--- a/packages/typescript/ai-fal/CHANGELOG.md
+++ b/packages/typescript/ai-fal/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/ai-fal
 
+## 0.7.12
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-utils@0.2.1
+
 ## 0.7.11
 
 ### Patch Changes
diff --git a/packages/typescript/ai-fal/package.json b/packages/typescript/ai-fal/package.json
index 361170847..fecea6aaf 100644
--- 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.11",
+  "version": "0.7.12",
   "description": "fal.ai adapter for TanStack AI image, video, audio, speech, and transcription generation.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-gemini/CHANGELOG.md b/packages/typescript/ai-gemini/CHANGELOG.md
index eef543217..7e22078e4 100644
--- a/packages/typescript/ai-gemini/CHANGELOG.md
+++ b/packages/typescript/ai-gemini/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/ai-gemini
 
+## 0.10.10
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-utils@0.2.1
+
 ## 0.10.9
 
 ### Patch Changes
diff --git a/packages/typescript/ai-gemini/package.json b/packages/typescript/ai-gemini/package.json
index 272e2f13f..560b87e39 100644
--- 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.9",
+  "version": "0.10.10",
   "description": "Google Gemini adapter for TanStack AI chat, images, speech, audio generation, and structured outputs.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-grok/CHANGELOG.md b/packages/typescript/ai-grok/CHANGELOG.md
index 50978465c..1dfae81c4 100644
--- a/packages/typescript/ai-grok/CHANGELOG.md
+++ b/packages/typescript/ai-grok/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @tanstack/ai-grok
 
+## 0.8.7
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-utils@0.2.1
+  - @tanstack/openai-base@0.3.6
+
 ## 0.8.6
 
 ### Patch Changes
diff --git a/packages/typescript/ai-grok/package.json b/packages/typescript/ai-grok/package.json
index 9c7cf8eda..c9cabeda4 100644
--- a/packages/typescript/ai-grok/package.json
+++ b/packages/typescript/ai-grok/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-grok",
-  "version": "0.8.6",
+  "version": "0.8.7",
   "description": "xAI Grok adapter for TanStack AI chat, image generation, realtime, and structured outputs.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-groq/CHANGELOG.md b/packages/typescript/ai-groq/CHANGELOG.md
index 83a6d2b97..0cde9d7c7 100644
--- a/packages/typescript/ai-groq/CHANGELOG.md
+++ b/packages/typescript/ai-groq/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @tanstack/ai-groq
 
+## 0.2.6
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-utils@0.2.1
+  - @tanstack/openai-base@0.3.6
+
 ## 0.2.5
 
 ### Patch Changes
diff --git a/packages/typescript/ai-groq/package.json b/packages/typescript/ai-groq/package.json
index 383b2b38b..0eba29568 100644
--- a/packages/typescript/ai-groq/package.json
+++ b/packages/typescript/ai-groq/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-groq",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "type": "module",
   "description": "Groq adapter for TanStack AI low-latency chat, tool calling, and structured outputs.",
   "author": "",
diff --git a/packages/typescript/ai-isolate-cloudflare/CHANGELOG.md b/packages/typescript/ai-isolate-cloudflare/CHANGELOG.md
index 40d1d1198..68552bdf2 100644
--- a/packages/typescript/ai-isolate-cloudflare/CHANGELOG.md
+++ b/packages/typescript/ai-isolate-cloudflare/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @tanstack/ai-isolate-cloudflare
 
+## 0.2.10
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai-code-mode@0.1.19
+
 ## 0.2.9
 
 ### Patch Changes
diff --git a/packages/typescript/ai-isolate-cloudflare/package.json b/packages/typescript/ai-isolate-cloudflare/package.json
index b5b2892b9..a677ae64f 100644
--- a/packages/typescript/ai-isolate-cloudflare/package.json
+++ b/packages/typescript/ai-isolate-cloudflare/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-isolate-cloudflare",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "Cloudflare Workers sandbox driver for TanStack AI Code Mode TypeScript execution at the edge.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-isolate-node/CHANGELOG.md b/packages/typescript/ai-isolate-node/CHANGELOG.md
index c761af249..ae390b8d3 100644
--- a/packages/typescript/ai-isolate-node/CHANGELOG.md
+++ b/packages/typescript/ai-isolate-node/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @tanstack/ai-isolate-node
 
+## 0.1.19
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai-code-mode@0.1.19
+
 ## 0.1.18
 
 ### Patch Changes
diff --git a/packages/typescript/ai-isolate-node/package.json b/packages/typescript/ai-isolate-node/package.json
index 7016ee822..111a47ca2 100644
--- a/packages/typescript/ai-isolate-node/package.json
+++ b/packages/typescript/ai-isolate-node/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-isolate-node",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "Node.js isolated-vm sandbox driver for TanStack AI Code Mode TypeScript execution.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-isolate-quickjs/CHANGELOG.md b/packages/typescript/ai-isolate-quickjs/CHANGELOG.md
index 4e28b0a28..373ec6309 100644
--- a/packages/typescript/ai-isolate-quickjs/CHANGELOG.md
+++ b/packages/typescript/ai-isolate-quickjs/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @tanstack/ai-isolate-quickjs
 
+## 0.1.19
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai-code-mode@0.1.19
+
 ## 0.1.18
 
 ### Patch Changes
diff --git a/packages/typescript/ai-isolate-quickjs/package.json b/packages/typescript/ai-isolate-quickjs/package.json
index 3526fe6ea..bf2865555 100644
--- a/packages/typescript/ai-isolate-quickjs/package.json
+++ b/packages/typescript/ai-isolate-quickjs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-isolate-quickjs",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "QuickJS WASM sandbox driver for TanStack AI Code Mode TypeScript execution across runtimes.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-ollama/CHANGELOG.md b/packages/typescript/ai-ollama/CHANGELOG.md
index b2c0742d1..ac8ee71f1 100644
--- a/packages/typescript/ai-ollama/CHANGELOG.md
+++ b/packages/typescript/ai-ollama/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/ai-ollama
 
+## 0.6.21
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-utils@0.2.1
+
 ## 0.6.20
 
 ### Patch Changes
diff --git a/packages/typescript/ai-ollama/package.json b/packages/typescript/ai-ollama/package.json
index 8fbfa53de..7a0a582c1 100644
--- a/packages/typescript/ai-ollama/package.json
+++ b/packages/typescript/ai-ollama/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-ollama",
-  "version": "0.6.20",
+  "version": "0.6.21",
   "description": "Ollama adapter for TanStack AI local LLM chat, tool calling, and structured outputs.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-openai/CHANGELOG.md b/packages/typescript/ai-openai/CHANGELOG.md
index 588e47642..c7e70def8 100644
--- a/packages/typescript/ai-openai/CHANGELOG.md
+++ b/packages/typescript/ai-openai/CHANGELOG.md
@@ -1,5 +1,38 @@
 # @tanstack/ai-openai
 
+## 0.10.0
+
+### Minor Changes
+
+- Add `gpt-image-2` to the OpenAI image model list. The new model is exposed ([#625](https://github.com/TanStack/ai/pull/625))
+  through the same tree-shakeable `openaiImage` adapter as `gpt-image-1` and
+  shares its provider options (`quality`, `background`, `output_format`,
+  `output_compression`, `moderation`, `partial_images`) and size set
+  (`1024x1024`, `1536x1024`, `1024x1536`, `auto`).
+
+  ```ts
+  import { openaiImage } from '@tanstack/ai-openai/adapters'
+  import { generate } from '@tanstack/ai'
+
+  const adapter = openaiImage({ apiKey: process.env.OPENAI_API_KEY! })
+
+  const result = await generate({
+    adapter,
+    model: 'gpt-image-2',
+    prompt: 'A watercolor fox in a snowy forest',
+  })
+  ```
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-client@0.11.6
+  - @tanstack/ai-utils@0.2.1
+  - @tanstack/openai-base@0.3.6
+
 ## 0.9.6
 
 ### Patch Changes
diff --git a/packages/typescript/ai-openai/package.json b/packages/typescript/ai-openai/package.json
index fa4b520cb..0a606ebd8 100644
--- a/packages/typescript/ai-openai/package.json
+++ b/packages/typescript/ai-openai/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-openai",
-  "version": "0.9.6",
+  "version": "0.10.0",
   "description": "OpenAI adapter for TanStack AI chat, tools, images, video, speech, transcription, realtime, and structured outputs.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-openrouter/CHANGELOG.md b/packages/typescript/ai-openrouter/CHANGELOG.md
index 54af9c34d..42ffacf89 100644
--- a/packages/typescript/ai-openrouter/CHANGELOG.md
+++ b/packages/typescript/ai-openrouter/CHANGELOG.md
@@ -1,5 +1,21 @@
 # @tanstack/ai-openrouter
 
+## 0.9.7
+
+### Patch Changes
+
+- Restore `web_fetch` in `OpenRouterChatModelToolCapabilitiesByName` so `webFetchTool()` is assignable to OpenRouter text adapters again. The recent model-metadata sync (#623) regenerated this map with `web_search` only, breaking the per-model type-safety tests added in #611. ([#625](https://github.com/TanStack/ai/pull/625))
+
+- Fix OpenRouter provider tool type metadata to include `webFetchTool`. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Update model metadata from OpenRouter API ([#623](https://github.com/TanStack/ai/pull/623))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-utils@0.2.1
+
 ## 0.9.6
 
 ### Patch Changes
diff --git a/packages/typescript/ai-openrouter/package.json b/packages/typescript/ai-openrouter/package.json
index 16c74001a..d038b1464 100644
--- a/packages/typescript/ai-openrouter/package.json
+++ b/packages/typescript/ai-openrouter/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-openrouter",
-  "version": "0.9.6",
+  "version": "0.9.7",
   "description": "TanStack AI adapter for OpenRouter chat, provider tools, structured outputs, and access to hundreds of LLMs.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-preact/CHANGELOG.md b/packages/typescript/ai-preact/CHANGELOG.md
index ade70b1ae..e239038eb 100644
--- a/packages/typescript/ai-preact/CHANGELOG.md
+++ b/packages/typescript/ai-preact/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/ai-preact
 
+## 0.6.31
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-client@0.11.6
+
 ## 0.6.30
 
 ### Patch Changes
diff --git a/packages/typescript/ai-preact/package.json b/packages/typescript/ai-preact/package.json
index 57c6e7e97..99764cd91 100644
--- a/packages/typescript/ai-preact/package.json
+++ b/packages/typescript/ai-preact/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-preact",
-  "version": "0.6.30",
+  "version": "0.6.31",
   "description": "Preact hooks for TanStack AI streaming chat and typed messages.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-react-ui/CHANGELOG.md b/packages/typescript/ai-react-ui/CHANGELOG.md
index 4c3af0434..d1157fa4b 100644
--- a/packages/typescript/ai-react-ui/CHANGELOG.md
+++ b/packages/typescript/ai-react-ui/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/ai-react-ui
 
+## 0.8.1
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai-client@0.11.6
+  - @tanstack/ai-react@0.11.6
+
 ## 0.8.0
 
 ### Minor Changes
diff --git a/packages/typescript/ai-react-ui/package.json b/packages/typescript/ai-react-ui/package.json
index 40cde12ff..2c464fe10 100644
--- a/packages/typescript/ai-react-ui/package.json
+++ b/packages/typescript/ai-react-ui/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-react-ui",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Headless React components for building TanStack AI chat interfaces with streamed message parts.",
   "module": "./dist/esm/index.js",
   "types": "./dist/esm/index.d.ts",
diff --git a/packages/typescript/ai-react/CHANGELOG.md b/packages/typescript/ai-react/CHANGELOG.md
index c958b9805..018633b2e 100644
--- a/packages/typescript/ai-react/CHANGELOG.md
+++ b/packages/typescript/ai-react/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/ai-react
 
+## 0.11.6
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-client@0.11.6
+
 ## 0.11.5
 
 ### Patch Changes
diff --git a/packages/typescript/ai-react/package.json b/packages/typescript/ai-react/package.json
index 1cedcda5d..27c2b2b1b 100644
--- a/packages/typescript/ai-react/package.json
+++ b/packages/typescript/ai-react/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-react",
-  "version": "0.11.5",
+  "version": "0.11.6",
   "description": "React hooks for TanStack AI streaming chat, realtime voice, structured outputs, and media generation.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-solid-ui/CHANGELOG.md b/packages/typescript/ai-solid-ui/CHANGELOG.md
index 30554b4b8..ea617057b 100644
--- a/packages/typescript/ai-solid-ui/CHANGELOG.md
+++ b/packages/typescript/ai-solid-ui/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/ai-solid-ui
 
+## 0.7.1
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai-client@0.11.6
+  - @tanstack/ai-solid@0.10.6
+
 ## 0.7.0
 
 ### Minor Changes
diff --git a/packages/typescript/ai-solid-ui/package.json b/packages/typescript/ai-solid-ui/package.json
index 36752a24f..01b4568fc 100644
--- a/packages/typescript/ai-solid-ui/package.json
+++ b/packages/typescript/ai-solid-ui/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-solid-ui",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Headless Solid components for building TanStack AI chat interfaces with streamed message parts.",
   "module": "./src/index.ts",
   "types": "./src/index.ts",
diff --git a/packages/typescript/ai-solid/CHANGELOG.md b/packages/typescript/ai-solid/CHANGELOG.md
index 7980ca3c1..d1bb5761f 100644
--- a/packages/typescript/ai-solid/CHANGELOG.md
+++ b/packages/typescript/ai-solid/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/ai-solid
 
+## 0.10.6
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-client@0.11.6
+
 ## 0.10.5
 
 ### Patch Changes
diff --git a/packages/typescript/ai-solid/package.json b/packages/typescript/ai-solid/package.json
index a5c2bb4e6..5d9bf4c19 100644
--- a/packages/typescript/ai-solid/package.json
+++ b/packages/typescript/ai-solid/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-solid",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "description": "Solid hooks for TanStack AI streaming chat, structured outputs, and media generation.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-svelte/CHANGELOG.md b/packages/typescript/ai-svelte/CHANGELOG.md
index c1db834a5..834f2e6a2 100644
--- a/packages/typescript/ai-svelte/CHANGELOG.md
+++ b/packages/typescript/ai-svelte/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/ai-svelte
 
+## 0.10.6
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-client@0.11.6
+
 ## 0.10.5
 
 ### Patch Changes
diff --git a/packages/typescript/ai-svelte/package.json b/packages/typescript/ai-svelte/package.json
index ab933856a..33876ff8a 100644
--- a/packages/typescript/ai-svelte/package.json
+++ b/packages/typescript/ai-svelte/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-svelte",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "description": "Svelte 5 bindings for TanStack AI streaming chat, structured outputs, and media generation.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-utils/CHANGELOG.md b/packages/typescript/ai-utils/CHANGELOG.md
index 17aa431de..ab69e983d 100644
--- a/packages/typescript/ai-utils/CHANGELOG.md
+++ b/packages/typescript/ai-utils/CHANGELOG.md
@@ -1,5 +1,11 @@
 # @tanstack/ai-utils
 
+## 0.2.1
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
 ## 0.2.0
 
 ### Minor Changes
diff --git a/packages/typescript/ai-utils/package.json b/packages/typescript/ai-utils/package.json
index 49ad3eb33..e9ab62296 100644
--- a/packages/typescript/ai-utils/package.json
+++ b/packages/typescript/ai-utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-utils",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Shared TypeScript utilities for TanStack AI provider adapters and runtime packages.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-vue-ui/CHANGELOG.md b/packages/typescript/ai-vue-ui/CHANGELOG.md
index d8f577a02..062db3131 100644
--- a/packages/typescript/ai-vue-ui/CHANGELOG.md
+++ b/packages/typescript/ai-vue-ui/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @tanstack/ai-vue-ui
 
+## 0.2.2
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai-vue@0.10.7
+
 ## 0.2.1
 
 ### Patch Changes
diff --git a/packages/typescript/ai-vue-ui/package.json b/packages/typescript/ai-vue-ui/package.json
index 055003ce1..e5ebadc99 100644
--- a/packages/typescript/ai-vue-ui/package.json
+++ b/packages/typescript/ai-vue-ui/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-vue-ui",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Headless Vue components for building TanStack AI chat interfaces with streamed message parts.",
   "module": "./src/index.ts",
   "types": "./src/index.ts",
diff --git a/packages/typescript/ai-vue/CHANGELOG.md b/packages/typescript/ai-vue/CHANGELOG.md
index 36968aa7a..ebf0085a1 100644
--- a/packages/typescript/ai-vue/CHANGELOG.md
+++ b/packages/typescript/ai-vue/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/ai-vue
 
+## 0.10.7
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-client@0.11.6
+
 ## 0.10.6
 
 ### Patch Changes
diff --git a/packages/typescript/ai-vue/package.json b/packages/typescript/ai-vue/package.json
index 41e0c619a..b6f5449a2 100644
--- a/packages/typescript/ai-vue/package.json
+++ b/packages/typescript/ai-vue/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-vue",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "description": "Vue composables for TanStack AI streaming chat, structured outputs, and media generation.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai/CHANGELOG.md b/packages/typescript/ai/CHANGELOG.md
index a9588d614..531dd024b 100644
--- a/packages/typescript/ai/CHANGELOG.md
+++ b/packages/typescript/ai/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @tanstack/ai
 
+## 0.21.2
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai-event-client@0.3.9
+
 ## 0.21.1
 
 ### Patch Changes
diff --git a/packages/typescript/ai/package.json b/packages/typescript/ai/package.json
index 8b71beba5..1988f2693 100644
--- a/packages/typescript/ai/package.json
+++ b/packages/typescript/ai/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai",
-  "version": "0.21.1",
+  "version": "0.21.2",
   "description": "Type-safe TypeScript AI SDK for streaming chat, tool calling, agents, structured outputs, and multimodal generation.",
   "author": "Tanner Linsley",
   "license": "MIT",
diff --git a/packages/typescript/openai-base/CHANGELOG.md b/packages/typescript/openai-base/CHANGELOG.md
index e535d4b0f..786ced6f9 100644
--- a/packages/typescript/openai-base/CHANGELOG.md
+++ b/packages/typescript/openai-base/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/openai-base
 
+## 0.3.6
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai@0.21.2
+  - @tanstack/ai-utils@0.2.1
+
 ## 0.3.5
 
 ### Patch Changes
diff --git a/packages/typescript/openai-base/package.json b/packages/typescript/openai-base/package.json
index 41f614d68..21ef5e2be 100644
--- a/packages/typescript/openai-base/package.json
+++ b/packages/typescript/openai-base/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/openai-base",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "Shared OpenAI SDK base adapters for TanStack AI providers using Chat Completions and Responses APIs.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/preact-ai-devtools/CHANGELOG.md b/packages/typescript/preact-ai-devtools/CHANGELOG.md
index 75e826779..47b8297b0 100644
--- a/packages/typescript/preact-ai-devtools/CHANGELOG.md
+++ b/packages/typescript/preact-ai-devtools/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @tanstack/preact-ai-devtools
 
+## 0.1.40
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai-devtools-core@0.3.36
+
 ## 0.1.39
 
 ### Patch Changes
diff --git a/packages/typescript/preact-ai-devtools/package.json b/packages/typescript/preact-ai-devtools/package.json
index f38932981..2c8a69e83 100644
--- a/packages/typescript/preact-ai-devtools/package.json
+++ b/packages/typescript/preact-ai-devtools/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/preact-ai-devtools",
-  "version": "0.1.39",
+  "version": "0.1.40",
   "description": "Preact Devtools plugin for inspecting TanStack AI chat messages, tool calls, streams, and errors.",
   "author": "tannerlinsley",
   "license": "MIT",
diff --git a/packages/typescript/react-ai-devtools/CHANGELOG.md b/packages/typescript/react-ai-devtools/CHANGELOG.md
index 350fc3ed7..4ce88f076 100644
--- a/packages/typescript/react-ai-devtools/CHANGELOG.md
+++ b/packages/typescript/react-ai-devtools/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @tanstack/react-ai-devtools
 
+## 0.2.40
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai-devtools-core@0.3.36
+
 ## 0.2.39
 
 ### Patch Changes
diff --git a/packages/typescript/react-ai-devtools/package.json b/packages/typescript/react-ai-devtools/package.json
index 8499bba6d..9dca899e0 100644
--- a/packages/typescript/react-ai-devtools/package.json
+++ b/packages/typescript/react-ai-devtools/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/react-ai-devtools",
-  "version": "0.2.39",
+  "version": "0.2.40",
   "description": "React Devtools plugin for inspecting TanStack AI chat messages, tool calls, streams, and errors.",
   "author": "tannerlinsley",
   "license": "MIT",
diff --git a/packages/typescript/solid-ai-devtools/CHANGELOG.md b/packages/typescript/solid-ai-devtools/CHANGELOG.md
index b6efc3ba3..cd76d532e 100644
--- a/packages/typescript/solid-ai-devtools/CHANGELOG.md
+++ b/packages/typescript/solid-ai-devtools/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @tanstack/solid-ai-devtools
 
+## 0.2.40
+
+### Patch Changes
+
+- Refresh package README content and npm metadata for better discoverability. ([#626](https://github.com/TanStack/ai/pull/626))
+
+- Updated dependencies [[`ebeb22e`](https://github.com/TanStack/ai/commit/ebeb22ec68f456b09e0181ac6f5d1ac25a0affd2)]:
+  - @tanstack/ai-devtools-core@0.3.36
+
 ## 0.2.39
 
 ### Patch Changes
diff --git a/packages/typescript/solid-ai-devtools/package.json b/packages/typescript/solid-ai-devtools/package.json
index 757697cb0..4acf0d1d4 100644
--- a/packages/typescript/solid-ai-devtools/package.json
+++ b/packages/typescript/solid-ai-devtools/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/solid-ai-devtools",
-  "version": "0.2.39",
+  "version": "0.2.40",
   "description": "Solid Devtools plugin for inspecting TanStack AI chat messages, tool calls, streams, and errors.",
   "author": "",
   "license": "MIT",

From 08a8e821279ed0d5f4a64711db93dcafc9c23f2c Mon Sep 17 00:00:00 2001
From: Alem Tuzlak <t.zlak@hotmail.com>
Date: Fri, 22 May 2026 18:34:26 +0200
Subject: [PATCH 06/10] fix: complete tool calls with server results (#596)

* fix: complete tool calls with server results

* fix: hydrate server tool outputs from history

* test: cover server tool history hydration

* ci: apply automated fixes

* test: add issue 176 manual repro page

* ci: apply automated fixes

* test: add live issue 176 repro flow

* test: hide issue 176 repro from sidebar

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
---
 .changeset/server-tool-results-complete.md    |   7 +
 examples/ts-react-chat/src/routeTree.gen.ts   |  21 ++
 .../src/routes/issue-176-tool-result.tsx      | 292 ++++++++++++++++++
 packages/typescript/ai-client/src/types.ts    |   1 +
 .../typescript/ai-event-client/src/index.ts   |   1 +
 .../ai/src/activities/chat/messages.ts        |  22 +-
 .../chat/stream/message-updaters.ts           |   6 +-
 .../src/activities/chat/stream/processor.ts   |   1 +
 packages/typescript/ai/src/types.ts           |   1 +
 .../ai/tests/message-converters.test.ts       |  21 +-
 .../ai/tests/message-updaters.test.ts         |   9 +-
 .../ai/tests/stream-processor.test.ts         |   4 +
 testing/e2e/src/routes/tools-test.tsx         |  52 +++-
 testing/e2e/tests/tools-test/helpers.ts       |  15 +
 .../tools-test/server-client-sequence.spec.ts |  73 ++++-
 .../tools-test/server-tool-history.spec.ts    |  64 ++++
 16 files changed, 565 insertions(+), 25 deletions(-)
 create mode 100644 .changeset/server-tool-results-complete.md
 create mode 100644 examples/ts-react-chat/src/routes/issue-176-tool-result.tsx
 create mode 100644 testing/e2e/tests/tools-test/server-tool-history.spec.ts

diff --git a/.changeset/server-tool-results-complete.md b/.changeset/server-tool-results-complete.md
new file mode 100644
index 000000000..0b97fbd43
--- /dev/null
+++ b/.changeset/server-tool-results-complete.md
@@ -0,0 +1,7 @@
+---
+'@tanstack/ai': patch
+'@tanstack/ai-client': patch
+'@tanstack/ai-event-client': patch
+---
+
+Populate server-executed tool results on the matching `tool-call` part and mark successful tool calls as `complete`.
diff --git a/examples/ts-react-chat/src/routeTree.gen.ts b/examples/ts-react-chat/src/routeTree.gen.ts
index 45a3107ea..d0966d88a 100644
--- a/examples/ts-react-chat/src/routeTree.gen.ts
+++ b/examples/ts-react-chat/src/routeTree.gen.ts
@@ -10,6 +10,7 @@
 
 import { Route as rootRouteImport } from './routes/__root'
 import { Route as RealtimeRouteImport } from './routes/realtime'
+import { Route as Issue176ToolResultRouteImport } from './routes/issue-176-tool-result'
 import { Route as ImageGenRouteImport } from './routes/image-gen'
 import { Route as IndexRouteImport } from './routes/index'
 import { Route as GenerationsVideoRouteImport } from './routes/generations.video'
@@ -38,6 +39,11 @@ const RealtimeRoute = RealtimeRouteImport.update({
   path: '/realtime',
   getParentRoute: () => rootRouteImport,
 } as any)
+const Issue176ToolResultRoute = Issue176ToolResultRouteImport.update({
+  id: '/issue-176-tool-result',
+  path: '/issue-176-tool-result',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const ImageGenRoute = ImageGenRouteImport.update({
   id: '/image-gen',
   path: '/image-gen',
@@ -155,6 +161,7 @@ const ApiGenerateAudioRoute = ApiGenerateAudioRouteImport.update({
 export interface FileRoutesByFullPath {
   '/': typeof IndexRoute
   '/image-gen': typeof ImageGenRoute
+  '/issue-176-tool-result': typeof Issue176ToolResultRoute
   '/realtime': typeof RealtimeRoute
   '/api/image-gen': typeof ApiImageGenRoute
   '/api/structured-chat': typeof ApiStructuredChatRoute
@@ -180,6 +187,7 @@ export interface FileRoutesByFullPath {
 export interface FileRoutesByTo {
   '/': typeof IndexRoute
   '/image-gen': typeof ImageGenRoute
+  '/issue-176-tool-result': typeof Issue176ToolResultRoute
   '/realtime': typeof RealtimeRoute
   '/api/image-gen': typeof ApiImageGenRoute
   '/api/structured-chat': typeof ApiStructuredChatRoute
@@ -206,6 +214,7 @@ export interface FileRoutesById {
   __root__: typeof rootRouteImport
   '/': typeof IndexRoute
   '/image-gen': typeof ImageGenRoute
+  '/issue-176-tool-result': typeof Issue176ToolResultRoute
   '/realtime': typeof RealtimeRoute
   '/api/image-gen': typeof ApiImageGenRoute
   '/api/structured-chat': typeof ApiStructuredChatRoute
@@ -233,6 +242,7 @@ export interface FileRouteTypes {
   fullPaths:
     | '/'
     | '/image-gen'
+    | '/issue-176-tool-result'
     | '/realtime'
     | '/api/image-gen'
     | '/api/structured-chat'
@@ -258,6 +268,7 @@ export interface FileRouteTypes {
   to:
     | '/'
     | '/image-gen'
+    | '/issue-176-tool-result'
     | '/realtime'
     | '/api/image-gen'
     | '/api/structured-chat'
@@ -283,6 +294,7 @@ export interface FileRouteTypes {
     | '__root__'
     | '/'
     | '/image-gen'
+    | '/issue-176-tool-result'
     | '/realtime'
     | '/api/image-gen'
     | '/api/structured-chat'
@@ -309,6 +321,7 @@ export interface FileRouteTypes {
 export interface RootRouteChildren {
   IndexRoute: typeof IndexRoute
   ImageGenRoute: typeof ImageGenRoute
+  Issue176ToolResultRoute: typeof Issue176ToolResultRoute
   RealtimeRoute: typeof RealtimeRoute
   ApiImageGenRoute: typeof ApiImageGenRoute
   ApiStructuredChatRoute: typeof ApiStructuredChatRoute
@@ -341,6 +354,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof RealtimeRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/issue-176-tool-result': {
+      id: '/issue-176-tool-result'
+      path: '/issue-176-tool-result'
+      fullPath: '/issue-176-tool-result'
+      preLoaderRoute: typeof Issue176ToolResultRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/image-gen': {
       id: '/image-gen'
       path: '/image-gen'
@@ -501,6 +521,7 @@ declare module '@tanstack/react-router' {
 const rootRouteChildren: RootRouteChildren = {
   IndexRoute: IndexRoute,
   ImageGenRoute: ImageGenRoute,
+  Issue176ToolResultRoute: Issue176ToolResultRoute,
   RealtimeRoute: RealtimeRoute,
   ApiImageGenRoute: ApiImageGenRoute,
   ApiStructuredChatRoute: ApiStructuredChatRoute,
diff --git a/examples/ts-react-chat/src/routes/issue-176-tool-result.tsx b/examples/ts-react-chat/src/routes/issue-176-tool-result.tsx
new file mode 100644
index 000000000..0eac5c48d
--- /dev/null
+++ b/examples/ts-react-chat/src/routes/issue-176-tool-result.tsx
@@ -0,0 +1,292 @@
+import { useMemo, useState } from 'react'
+import { createFileRoute } from '@tanstack/react-router'
+import { fetchServerSentEvents, useChat } from '@tanstack/ai-react'
+import { clientTools } from '@tanstack/ai-client'
+import { modelMessagesToUIMessages, type ModelMessage } from '@tanstack/ai'
+import { recommendGuitarToolDef } from '@/lib/guitar-tools'
+
+const modelMessages: Array<ModelMessage> = [
+  {
+    role: 'assistant',
+    content: 'Let me check the weather.',
+    toolCalls: [
+      {
+        id: 'issue-176-tool-call',
+        type: 'function',
+        function: {
+          name: 'getWeather',
+          arguments: '{"city":"NYC"}',
+        },
+      },
+    ],
+  },
+  {
+    role: 'tool',
+    content: '{"temp":72,"condition":"sunny"}',
+    toolCallId: 'issue-176-tool-call',
+  },
+]
+
+function Issue176ToolResultRepro() {
+  const [prompt, setPrompt] = useState(
+    'I want an acoustic guitar recommendation. Use the required tools.',
+  )
+  const initialMessages = useMemo(
+    () => modelMessagesToUIMessages(modelMessages),
+    [],
+  )
+  const liveTools = useMemo(
+    () =>
+      clientTools(
+        recommendGuitarToolDef.client(({ id }) => ({
+          id: Number(id),
+        })),
+      ),
+    [],
+  )
+
+  const { messages: fixtureMessages } = useChat({
+    id: 'issue-176-tool-result-repro',
+    connection: fetchServerSentEvents('/api/tanchat'),
+    initialMessages,
+  })
+  const {
+    messages: liveMessages,
+    sendMessage,
+    isLoading,
+    error,
+  } = useChat({
+    id: 'issue-176-live-tool-result-repro',
+    connection: fetchServerSentEvents('/api/tanchat'),
+    tools: liveTools,
+    body: {
+      provider: 'openai',
+      model: 'gpt-4o',
+    },
+  })
+
+  const toolCall = fixtureMessages
+    .flatMap((message) => message.parts)
+    .find(
+      (part) => part.type === 'tool-call' && part.id === 'issue-176-tool-call',
+    )
+  const toolResult = fixtureMessages
+    .flatMap((message) => message.parts)
+    .find(
+      (part) =>
+        part.type === 'tool-result' &&
+        part.toolCallId === 'issue-176-tool-call',
+    )
+  const isFixed =
+    toolCall?.type === 'tool-call' &&
+    toolCall.state === 'complete' &&
+    toolCall.output !== undefined
+  const liveServerToolCall = liveMessages
+    .flatMap((message) => message.parts)
+    .find((part) => part.type === 'tool-call' && part.name === 'getGuitars')
+  const liveServerToolResult = liveMessages
+    .flatMap((message) => message.parts)
+    .find(
+      (part) =>
+        part.type === 'tool-result' &&
+        liveServerToolCall?.type === 'tool-call' &&
+        part.toolCallId === liveServerToolCall.id,
+    )
+  const isLiveFixed =
+    liveServerToolCall?.type === 'tool-call' &&
+    liveServerToolCall.state === 'complete' &&
+    liveServerToolCall.output !== undefined
+
+  return (
+    <main className="min-h-screen bg-gray-950 text-gray-100">
+      <div className="mx-auto flex max-w-6xl flex-col gap-6 px-6 py-8">
+        <div>
+          <p className="text-sm font-medium uppercase tracking-wider text-orange-300">
+            Issue #176 manual repro
+          </p>
+          <h1 className="mt-2 text-3xl font-semibold">
+            Server tool result hydration
+          </h1>
+          <p className="mt-3 max-w-3xl text-sm leading-6 text-gray-300">
+            This page initializes a chat from model-message history containing
+            an assistant server tool call followed by a matching tool result.
+            The original tool-call part should be complete and include output.
+          </p>
+        </div>
+
+        <section className="rounded-lg border border-gray-800 bg-gray-900">
+          <div className="border-b border-gray-800 px-4 py-3">
+            <h2 className="text-lg font-semibold">Live LLM repro</h2>
+          </div>
+          <div className="grid gap-4 p-4 lg:grid-cols-[minmax(0,1fr)_220px_220px]">
+            <div className="flex flex-col gap-3">
+              <textarea
+                value={prompt}
+                onChange={(event) => setPrompt(event.target.value)}
+                className="min-h-28 rounded-lg border border-gray-700 bg-gray-950 p-3 text-sm text-gray-100 outline-none focus:border-orange-400"
+              />
+              <div className="flex items-center gap-3">
+                <button
+                  type="button"
+                  disabled={isLoading || !prompt.trim()}
+                  onClick={() => sendMessage(prompt)}
+                  className="rounded-lg bg-orange-500 px-4 py-2 text-sm font-semibold text-gray-950 transition hover:bg-orange-400 disabled:cursor-not-allowed disabled:opacity-60"
+                >
+                  Send to LLM
+                </button>
+                {error ? (
+                  <span className="text-sm text-red-300">{error.message}</span>
+                ) : (
+                  <span className="text-sm text-gray-400">
+                    {isLoading ? 'Running...' : 'Ready'}
+                  </span>
+                )}
+              </div>
+            </div>
+
+            <div className="rounded-lg border border-gray-800 bg-gray-950 p-4">
+              <div className="text-xs uppercase tracking-wider text-gray-400">
+                Live getGuitars state
+              </div>
+              <div
+                id="issue-176-live-tool-state"
+                className={`mt-2 text-2xl font-semibold ${
+                  isLiveFixed ? 'text-emerald-300' : 'text-amber-300'
+                }`}
+              >
+                {liveServerToolCall?.type === 'tool-call'
+                  ? liveServerToolCall.state
+                  : 'not run'}
+              </div>
+            </div>
+
+            <div className="rounded-lg border border-gray-800 bg-gray-950 p-4">
+              <div className="text-xs uppercase tracking-wider text-gray-400">
+                Live getGuitars output
+              </div>
+              <div
+                id="issue-176-live-tool-output"
+                className={`mt-2 text-2xl font-semibold ${
+                  liveServerToolCall?.type === 'tool-call' &&
+                  liveServerToolCall.output !== undefined
+                    ? 'text-emerald-300'
+                    : 'text-amber-300'
+                }`}
+              >
+                {liveServerToolCall?.type === 'tool-call' &&
+                liveServerToolCall.output !== undefined
+                  ? 'present'
+                  : 'missing'}
+              </div>
+            </div>
+          </div>
+          <div className="grid gap-4 border-t border-gray-800 p-4 lg:grid-cols-2">
+            <div>
+              <div className="mb-2 text-sm font-medium text-gray-200">
+                Live server tool-call part
+              </div>
+              <pre className="max-h-80 overflow-auto rounded-lg bg-gray-950 p-4 text-xs leading-5 text-gray-300">
+                {JSON.stringify(liveServerToolCall ?? null, null, 2)}
+              </pre>
+            </div>
+            <div>
+              <div className="mb-2 text-sm font-medium text-gray-200">
+                Live matching tool-result part
+              </div>
+              <pre className="max-h-80 overflow-auto rounded-lg bg-gray-950 p-4 text-xs leading-5 text-gray-300">
+                {JSON.stringify(liveServerToolResult ?? null, null, 2)}
+              </pre>
+            </div>
+          </div>
+        </section>
+
+        <section className="grid gap-4 md:grid-cols-3">
+          <div className="rounded-lg border border-gray-800 bg-gray-900 p-4">
+            <div className="text-xs uppercase tracking-wider text-gray-400">
+              Tool-call state
+            </div>
+            <div
+              id="issue-176-tool-state"
+              className={`mt-2 text-2xl font-semibold ${
+                isFixed ? 'text-emerald-300' : 'text-amber-300'
+              }`}
+            >
+              {toolCall?.type === 'tool-call' ? toolCall.state : 'missing'}
+            </div>
+          </div>
+
+          <div className="rounded-lg border border-gray-800 bg-gray-900 p-4">
+            <div className="text-xs uppercase tracking-wider text-gray-400">
+              Tool-call output
+            </div>
+            <div
+              id="issue-176-tool-output"
+              className={`mt-2 text-2xl font-semibold ${
+                toolCall?.type === 'tool-call' && toolCall.output !== undefined
+                  ? 'text-emerald-300'
+                  : 'text-amber-300'
+              }`}
+            >
+              {toolCall?.type === 'tool-call' && toolCall.output !== undefined
+                ? 'present'
+                : 'missing'}
+            </div>
+          </div>
+
+          <div className="rounded-lg border border-gray-800 bg-gray-900 p-4">
+            <div className="text-xs uppercase tracking-wider text-gray-400">
+              Tool-result part
+            </div>
+            <div
+              id="issue-176-tool-result"
+              className={`mt-2 text-2xl font-semibold ${
+                toolResult ? 'text-emerald-300' : 'text-amber-300'
+              }`}
+            >
+              {toolResult ? 'present' : 'missing'}
+            </div>
+          </div>
+        </section>
+
+        <section className="grid gap-6 lg:grid-cols-2">
+          <div className="rounded-lg border border-gray-800 bg-gray-900">
+            <div className="border-b border-gray-800 px-4 py-3 text-sm font-medium text-gray-200">
+              ModelMessage history fixture
+            </div>
+            <pre className="overflow-auto p-4 text-xs leading-5 text-gray-300">
+              {JSON.stringify(modelMessages, null, 2)}
+            </pre>
+          </div>
+
+          <div className="rounded-lg border border-gray-800 bg-gray-900">
+            <div className="border-b border-gray-800 px-4 py-3 text-sm font-medium text-gray-200">
+              Hydrated UIMessage.parts
+            </div>
+            <pre
+              id="issue-176-messages-json"
+              className="overflow-auto p-4 text-xs leading-5 text-gray-300"
+            >
+              {JSON.stringify(fixtureMessages, null, 2)}
+            </pre>
+          </div>
+        </section>
+
+        <section className="rounded-lg border border-gray-800 bg-gray-900">
+          <div className="border-b border-gray-800 px-4 py-3 text-sm font-medium text-gray-200">
+            Full live messages
+          </div>
+          <pre
+            id="issue-176-live-messages-json"
+            className="max-h-[520px] overflow-auto p-4 text-xs leading-5 text-gray-300"
+          >
+            {JSON.stringify(liveMessages, null, 2)}
+          </pre>
+        </section>
+      </div>
+    </main>
+  )
+}
+
+export const Route = createFileRoute('/issue-176-tool-result')({
+  component: Issue176ToolResultRepro,
+})
diff --git a/packages/typescript/ai-client/src/types.ts b/packages/typescript/ai-client/src/types.ts
index 815d6a838..1159150c1 100644
--- a/packages/typescript/ai-client/src/types.ts
+++ b/packages/typescript/ai-client/src/types.ts
@@ -25,6 +25,7 @@ export type ToolCallState =
   | 'input-complete' // All arguments received
   | 'approval-requested' // Waiting for user approval
   | 'approval-responded' // User has approved/denied
+  | 'complete' // Result is complete
 
 /**
  * Tool result states - track the lifecycle of a tool result
diff --git a/packages/typescript/ai-event-client/src/index.ts b/packages/typescript/ai-event-client/src/index.ts
index 17fa1d6e0..a4169c13c 100644
--- a/packages/typescript/ai-event-client/src/index.ts
+++ b/packages/typescript/ai-event-client/src/index.ts
@@ -112,6 +112,7 @@ export type ToolCallState =
   | 'input-complete' // All arguments received
   | 'approval-requested' // Waiting for user approval
   | 'approval-responded' // User has approved/denied
+  | 'complete' // Result is complete
 
 /**
  * Tool result states - track the lifecycle of a tool result
diff --git a/packages/typescript/ai/src/activities/chat/messages.ts b/packages/typescript/ai/src/activities/chat/messages.ts
index 6bfef628f..cf9892627 100644
--- a/packages/typescript/ai/src/activities/chat/messages.ts
+++ b/packages/typescript/ai/src/activities/chat/messages.ts
@@ -32,6 +32,14 @@ function safeJsonStringify(value: unknown): string {
   }
 }
 
+function parseToolResultContent(content: string): unknown {
+  try {
+    return JSON.parse(content)
+  } catch {
+    return content
+  }
+}
+
 /**
  * Collapse an array of ContentParts into the most compact ModelMessage content:
  * - Empty array → null
@@ -200,6 +208,7 @@ function createSegment(): AssistantSegment {
 function isToolCallIncluded(part: ToolCallPart): boolean {
   return (
     part.state === 'input-complete' ||
+    part.state === 'complete' ||
     part.state === 'approval-responded' ||
     part.output !== undefined
   )
@@ -467,10 +476,21 @@ export function modelMessagesToUIMessages(
         currentAssistantMessage &&
         currentAssistantMessage.role === 'assistant'
       ) {
+        const content = getTextContent(msg.content)
+        const toolCallPart = currentAssistantMessage.parts.find(
+          (part): part is ToolCallPart =>
+            part.type === 'tool-call' && part.id === msg.toolCallId,
+        )
+
+        if (toolCallPart) {
+          toolCallPart.output = parseToolResultContent(content)
+          toolCallPart.state = 'complete'
+        }
+
         currentAssistantMessage.parts.push({
           type: 'tool-result',
           toolCallId: msg.toolCallId,
-          content: getTextContent(msg.content),
+          content,
           state: 'complete',
         })
       } else {
diff --git a/packages/typescript/ai/src/activities/chat/stream/message-updaters.ts b/packages/typescript/ai/src/activities/chat/stream/message-updaters.ts
index e6d18f0da..3fd8895f3 100644
--- a/packages/typescript/ai/src/activities/chat/stream/message-updaters.ts
+++ b/packages/typescript/ai/src/activities/chat/stream/message-updaters.ts
@@ -217,11 +217,7 @@ export function updateToolCallWithOutput(
 
     if (toolCallPart) {
       toolCallPart.output = errorText ? { error: errorText } : output
-      if (state) {
-        toolCallPart.state = state
-      } else {
-        toolCallPart.state = 'input-complete'
-      }
+      toolCallPart.state = state ?? (errorText ? 'input-complete' : 'complete')
     }
 
     return { ...msg, parts }
diff --git a/packages/typescript/ai/src/activities/chat/stream/processor.ts b/packages/typescript/ai/src/activities/chat/stream/processor.ts
index 1b1f25e6a..9a6bc6740 100644
--- a/packages/typescript/ai/src/activities/chat/stream/processor.ts
+++ b/packages/typescript/ai/src/activities/chat/stream/processor.ts
@@ -378,6 +378,7 @@ export class StreamProcessor {
     // 3. It has a corresponding tool-result part (server tool completed)
     return toolParts.every(
       (part) =>
+        part.state === 'complete' ||
         part.state === 'approval-responded' ||
         (part.output !== undefined && !part.approval) ||
         toolResultIds.has(part.id),
diff --git a/packages/typescript/ai/src/types.ts b/packages/typescript/ai/src/types.ts
index a12964981..9566cb32f 100644
--- a/packages/typescript/ai/src/types.ts
+++ b/packages/typescript/ai/src/types.ts
@@ -40,6 +40,7 @@ export type ToolCallState =
   | 'input-complete' // All arguments received
   | 'approval-requested' // Waiting for user approval
   | 'approval-responded' // User has approved/denied
+  | 'complete' // Result is complete
 
 /**
  * Tool result states - track the lifecycle of a tool result
diff --git a/packages/typescript/ai/tests/message-converters.test.ts b/packages/typescript/ai/tests/message-converters.test.ts
index 9264d96b7..073868fd3 100644
--- a/packages/typescript/ai/tests/message-converters.test.ts
+++ b/packages/typescript/ai/tests/message-converters.test.ts
@@ -919,7 +919,8 @@ describe('Message Converters', () => {
           id: 'tc-1',
           name: 'getWeather',
           arguments: '{"city":"NYC"}',
-          state: 'input-complete',
+          state: 'complete',
+          output: { temp: 72 },
         },
         {
           type: 'tool-result',
@@ -978,7 +979,8 @@ describe('Message Converters', () => {
           id: 'tc-1',
           name: 'getGuitars',
           arguments: '',
-          state: 'input-complete',
+          state: 'complete',
+          output: [{ id: 7 }],
         },
         {
           type: 'tool-result',
@@ -995,7 +997,8 @@ describe('Message Converters', () => {
           id: 'tc-2',
           name: 'recommend',
           arguments: '{"id":7}',
-          state: 'input-complete',
+          state: 'complete',
+          output: { recommended: true },
         },
         {
           type: 'tool-result',
@@ -1083,7 +1086,8 @@ describe('Message Converters', () => {
         id: 'tc-1',
         name: 'getWeather',
         arguments: '{"city":"NYC"}',
-        state: 'input-complete',
+        state: 'complete',
+        output: { temp: 72 },
       })
       expect(assistantParts).toContainEqual({
         type: 'tool-result',
@@ -1222,7 +1226,8 @@ describe('Message Converters', () => {
             id: 'tc-1',
             name: 'getWeather',
             arguments: '{"city":"NYC"}',
-            state: 'input-complete',
+            state: 'complete',
+            output: { temp: 72 },
           },
           {
             type: 'tool-result',
@@ -1314,7 +1319,8 @@ describe('Message Converters', () => {
           id: 'tc-1',
           name: 'getGuitars',
           arguments: '',
-          state: 'input-complete',
+          state: 'complete',
+          output: [{ id: 7 }],
         },
         {
           type: 'tool-result',
@@ -1332,7 +1338,8 @@ describe('Message Converters', () => {
           id: 'tc-2',
           name: 'recommend',
           arguments: '{"id":7}',
-          state: 'input-complete',
+          state: 'complete',
+          output: { recommended: true },
         },
         {
           type: 'tool-result',
diff --git a/packages/typescript/ai/tests/message-updaters.test.ts b/packages/typescript/ai/tests/message-updaters.test.ts
index efae2cf3a..358cb2b3d 100644
--- a/packages/typescript/ai/tests/message-updaters.test.ts
+++ b/packages/typescript/ai/tests/message-updaters.test.ts
@@ -538,7 +538,7 @@ describe('message-updaters', () => {
   })
 
   describe('updateToolCallWithOutput', () => {
-    it('should update tool call with output', () => {
+    it('should update tool call with output and complete state', () => {
       const messages = [
         createMessage('msg-1', 'assistant', [
           {
@@ -558,7 +558,7 @@ describe('message-updaters', () => {
         id: 'call-1',
         name: 'getWeather',
         arguments: '{}',
-        state: 'input-complete',
+        state: 'complete',
         output,
       })
     })
@@ -588,7 +588,7 @@ describe('message-updaters', () => {
       expect(part?.output).toEqual(output)
     })
 
-    it('should default to input-complete state when not provided', () => {
+    it('should default to complete state when not provided', () => {
       const messages = [
         createMessage('msg-1', 'assistant', [
           {
@@ -604,7 +604,7 @@ describe('message-updaters', () => {
       const result = updateToolCallWithOutput(messages, 'call-1', output)
 
       const part = result[0]?.parts[0] as ToolCallPart | undefined
-      expect(part?.state).toBe('input-complete')
+      expect(part?.state).toBe('complete')
     })
 
     it('should handle error output', () => {
@@ -629,6 +629,7 @@ describe('message-updaters', () => {
 
       const part = result[0]?.parts[0] as ToolCallPart | undefined
       expect(part?.output).toEqual({ error: 'Tool execution failed' })
+      expect(part?.state).toBe('input-complete')
     })
 
     it('should search across all messages', () => {
diff --git a/packages/typescript/ai/tests/stream-processor.test.ts b/packages/typescript/ai/tests/stream-processor.test.ts
index 7b4dbeaa1..2e1f613bd 100644
--- a/packages/typescript/ai/tests/stream-processor.test.ts
+++ b/packages/typescript/ai/tests/stream-processor.test.ts
@@ -917,6 +917,7 @@ describe('StreamProcessor', () => {
         (p) => p.type === 'tool-call',
       ) as ToolCallPart
       expect((toolCallPart as any).output).toEqual({ temp: 72 })
+      expect(toolCallPart.state).toBe('complete')
 
       const toolResultPart = messages[0]?.parts.find(
         (p) => p.type === 'tool-result',
@@ -981,6 +982,7 @@ describe('StreamProcessor', () => {
         (p) => p.type === 'tool-call',
       ) as ToolCallPart
       expect((toolCallPart as any).output).toEqual({ temp: 72 })
+      expect(toolCallPart.state).toBe('complete')
 
       const toolResultPart = messages[0]!.parts.find(
         (p) => p.type === 'tool-result',
@@ -1020,6 +1022,7 @@ describe('StreamProcessor', () => {
         .getMessages()[0]!
         .parts.find((p) => p.type === 'tool-call') as ToolCallPart
       expect((toolCallPart as any).output).toEqual({ error: 'Network error' })
+      expect(toolCallPart.state).toBe('input-complete')
 
       const toolResultPart = processor
         .getMessages()[0]!
@@ -3326,6 +3329,7 @@ describe('StreamProcessor', () => {
         (p) => p.type === 'tool-call',
       ) as ToolCallPart
       expect((toolCallPart as any).output).toEqual({ temp: 72 })
+      expect(toolCallPart.state).toBe('complete')
 
       const toolResultPart = messages[0]?.parts.find(
         (p) => p.type === 'tool-result',
diff --git a/testing/e2e/src/routes/tools-test.tsx b/testing/e2e/src/routes/tools-test.tsx
index 893c55168..30f3ad55e 100644
--- a/testing/e2e/src/routes/tools-test.tsx
+++ b/testing/e2e/src/routes/tools-test.tsx
@@ -1,7 +1,11 @@
-import { useState, useCallback, useRef, useEffect } from 'react'
+import { useState, useCallback, useRef, useEffect, useMemo } from 'react'
 import { createFileRoute } from '@tanstack/react-router'
 import { useChat, fetchServerSentEvents } from '@tanstack/ai-react'
-import { toolDefinition } from '@tanstack/ai'
+import {
+  modelMessagesToUIMessages,
+  toolDefinition,
+  type ModelMessage,
+} from '@tanstack/ai'
 import { z } from 'zod'
 import { SCENARIO_LIST } from '@/lib/tools-test-tools'
 
@@ -98,8 +102,38 @@ function createTrackedTools(
   return [showNotificationTool, displayChartTool]
 }
 
+function createHistoryFixtureMessages(historyFixture?: string) {
+  if (historyFixture !== 'server-tool-result') {
+    return []
+  }
+
+  const modelMessages: Array<ModelMessage> = [
+    {
+      role: 'assistant',
+      content: 'Let me check the weather.',
+      toolCalls: [
+        {
+          id: 'history-tc-1',
+          type: 'function',
+          function: {
+            name: 'getWeather',
+            arguments: '{"city":"NYC"}',
+          },
+        },
+      ],
+    },
+    {
+      role: 'tool',
+      content: '{"temp":72,"condition":"sunny"}',
+      toolCallId: 'history-tc-1',
+    },
+  ]
+
+  return modelMessagesToUIMessages(modelMessages)
+}
+
 function ToolsTestPage() {
-  const { testId, aimockPort } = Route.useSearch()
+  const { testId, aimockPort, historyFixture } = Route.useSearch()
   const [scenario, setScenario] = useState('text-only')
   const [toolEvents, setToolEvents] = useState<Array<ToolEvent>>([])
   const [testStartTime, setTestStartTime] = useState<number | null>(null)
@@ -115,6 +149,10 @@ function ToolsTestPage() {
 
   // Create tracked tools (memoized since addEvent is stable)
   const clientTools = useRef(createTrackedTools(addEvent)).current
+  const initialMessages = useMemo(
+    () => createHistoryFixtureMessages(historyFixture),
+    [historyFixture],
+  )
 
   const {
     messages,
@@ -125,8 +163,9 @@ function ToolsTestPage() {
     error,
   } = useChat({
     // Include scenario in ID so client is recreated when scenario changes
-    id: `tools-test-${scenario}`,
+    id: `tools-test-${scenario}-${historyFixture || 'empty'}`,
     connection: fetchServerSentEvents('/api/tools-test'),
+    initialMessages,
     body: { scenario, testId, aimockPort },
     tools: clientTools,
     onFinish: () => {
@@ -565,6 +604,7 @@ function ToolsTestPage() {
         id="test-metadata"
         style={{ display: 'none' }}
         data-scenario={scenario}
+        data-history-fixture={historyFixture || ''}
         data-is-loading={isLoading.toString()}
         data-test-complete={testComplete.toString()}
         data-tool-call-count={toolCalls.length}
@@ -633,6 +673,10 @@ export const Route = createFileRoute('/tools-test')({
     return {
       testId: typeof search.testId === 'string' ? search.testId : undefined,
       aimockPort: port != null && !isNaN(port) ? port : undefined,
+      historyFixture:
+        typeof search.historyFixture === 'string'
+          ? search.historyFixture
+          : undefined,
     }
   },
 })
diff --git a/testing/e2e/tests/tools-test/helpers.ts b/testing/e2e/tests/tools-test/helpers.ts
index a83853cd9..4388ca80b 100644
--- a/testing/e2e/tests/tools-test/helpers.ts
+++ b/testing/e2e/tests/tools-test/helpers.ts
@@ -180,6 +180,21 @@ export async function getToolCalls(
   })
 }
 
+/**
+ * Parse the full UIMessage array from #messages-json-content.
+ */
+export async function getMessages(page: Page): Promise<Array<any>> {
+  return page.evaluate(() => {
+    const el = document.getElementById('messages-json-content')
+    if (!el) return []
+    try {
+      return JSON.parse(el.textContent || '[]')
+    } catch {
+      return []
+    }
+  })
+}
+
 /**
  * Extract tool-call parts with parsed arguments from #messages-json-content.
  */
diff --git a/testing/e2e/tests/tools-test/server-client-sequence.spec.ts b/testing/e2e/tests/tools-test/server-client-sequence.spec.ts
index e0f136ed8..a7c64426c 100644
--- a/testing/e2e/tests/tools-test/server-client-sequence.spec.ts
+++ b/testing/e2e/tests/tools-test/server-client-sequence.spec.ts
@@ -6,6 +6,7 @@ import {
   getMetadata,
   getEventLog,
   getToolCalls,
+  getMessages,
 } from './helpers'
 
 /**
@@ -58,6 +59,73 @@ test.describe('Server-Client Sequence E2E Tests', () => {
     expect(chartExecution).toBeTruthy()
   })
 
+  test('server and client tool results populate tool-call output and complete state', async ({
+    page,
+    testId,
+    aimockPort,
+  }) => {
+    await selectScenario(page, 'sequence-server-client', testId, aimockPort)
+    await runTest(page)
+
+    await waitForTestComplete(page, 15000, 2)
+
+    await page.waitForFunction(
+      () => {
+        const messagesEl = document.getElementById('messages-json-content')
+        const messages = JSON.parse(messagesEl?.textContent || '[]')
+        const toolCalls = messages.flatMap((msg: any) =>
+          (msg.parts || []).filter((part: any) => part.type === 'tool-call'),
+        )
+
+        const fetchData = toolCalls.find(
+          (part: any) => part.name === 'fetch_data',
+        )
+        const displayChart = toolCalls.find(
+          (part: any) => part.name === 'display_chart',
+        )
+
+        return (
+          fetchData?.state === 'complete' &&
+          fetchData.output !== undefined &&
+          displayChart?.state === 'complete' &&
+          displayChart.output !== undefined
+        )
+      },
+      { timeout: 10000 },
+    )
+
+    const messages = await getMessages(page)
+    const toolCalls = messages.flatMap((msg) =>
+      (msg.parts || []).filter((part: any) => part.type === 'tool-call'),
+    )
+    const toolResults = messages.flatMap((msg) =>
+      (msg.parts || []).filter((part: any) => part.type === 'tool-result'),
+    )
+
+    const fetchData = toolCalls.find((part) => part.name === 'fetch_data')
+    expect(fetchData).toMatchObject({
+      state: 'complete',
+      output: {
+        source: 'api',
+        data: [1, 2, 3, 4, 5],
+      },
+    })
+
+    const displayChart = toolCalls.find((part) => part.name === 'display_chart')
+    expect(displayChart?.state).toBe('complete')
+    expect(displayChart?.output).toMatchObject({ rendered: true })
+    expect(typeof displayChart?.output?.chartId).toBe('string')
+
+    expect(
+      toolResults.some(
+        (part) =>
+          part.toolCallId === fetchData?.id &&
+          part.state === 'complete' &&
+          JSON.parse(part.content).source === 'api',
+      ),
+    ).toBe(true)
+  })
+
   test('server then two client tools in sequence', async ({
     page,
     testId,
@@ -162,10 +230,7 @@ test.describe('Server-Client Sequence E2E Tests', () => {
     const toolCalls = await getToolCalls(page)
     const weatherTool = toolCalls.find((tc) => tc.name === 'get_weather')
     expect(weatherTool).toBeTruthy()
-    // Server tools stay at 'input-complete' state but are tracked as complete via tool-result parts
-    expect(['complete', 'input-complete', 'output-available']).toContain(
-      weatherTool?.state,
-    )
+    expect(weatherTool?.state).toBe('complete')
   })
 
   test('text only scenario has no tool calls', async ({
diff --git a/testing/e2e/tests/tools-test/server-tool-history.spec.ts b/testing/e2e/tests/tools-test/server-tool-history.spec.ts
new file mode 100644
index 000000000..40e558eb6
--- /dev/null
+++ b/testing/e2e/tests/tools-test/server-tool-history.spec.ts
@@ -0,0 +1,64 @@
+import { test, expect } from '../fixtures'
+import { getMessages } from './helpers'
+
+test.describe('Server Tool History Hydration', () => {
+  test('hydrates server tool-call output from a matching tool result', async ({
+    page,
+    testId,
+    aimockPort,
+  }) => {
+    const params = new URLSearchParams({
+      historyFixture: 'server-tool-result',
+      testId,
+      aimockPort: String(aimockPort),
+    })
+
+    await page.goto(`/tools-test?${params.toString()}`)
+    await page.waitForSelector('#run-test-button')
+
+    await page.waitForFunction(
+      () => {
+        const messagesEl = document.getElementById('messages-json-content')
+        const messages = JSON.parse(messagesEl?.textContent || '[]')
+        const toolCall = messages
+          .flatMap((msg: any) => msg.parts || [])
+          .find(
+            (part: any) =>
+              part.type === 'tool-call' && part.id === 'history-tc-1',
+          )
+
+        return toolCall?.state === 'complete' && toolCall.output !== undefined
+      },
+      { timeout: 10000 },
+    )
+
+    const messages = await getMessages(page)
+    const assistant = messages.find((message) => message.role === 'assistant')
+    const toolCall = assistant?.parts.find(
+      (part: any) => part.type === 'tool-call' && part.id === 'history-tc-1',
+    )
+    const toolResult = assistant?.parts.find(
+      (part: any) =>
+        part.type === 'tool-result' && part.toolCallId === 'history-tc-1',
+    )
+
+    expect(toolCall).toMatchObject({
+      type: 'tool-call',
+      id: 'history-tc-1',
+      name: 'getWeather',
+      arguments: '{"city":"NYC"}',
+      state: 'complete',
+      output: {
+        temp: 72,
+        condition: 'sunny',
+      },
+    })
+
+    expect(toolResult).toMatchObject({
+      type: 'tool-result',
+      toolCallId: 'history-tc-1',
+      content: '{"temp":72,"condition":"sunny"}',
+      state: 'complete',
+    })
+  })
+})

From 1fe07d4b25e13bf8f3ee7dda4d813d490a0c5edc Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sat, 23 May 2026 11:54:43 +0200
Subject: [PATCH 07/10] ci: Version Packages (#629)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 .changeset/server-tool-results-complete.md             |  7 -------
 packages/typescript/ai-client/CHANGELOG.md             | 10 ++++++++++
 packages/typescript/ai-client/package.json             |  2 +-
 packages/typescript/ai-code-mode-skills/CHANGELOG.md   |  8 ++++++++
 packages/typescript/ai-code-mode-skills/package.json   |  2 +-
 packages/typescript/ai-code-mode/CHANGELOG.md          |  7 +++++++
 packages/typescript/ai-code-mode/package.json          |  2 +-
 packages/typescript/ai-devtools/CHANGELOG.md           |  8 ++++++++
 packages/typescript/ai-devtools/package.json           |  2 +-
 packages/typescript/ai-event-client/CHANGELOG.md       |  9 +++++++++
 packages/typescript/ai-event-client/package.json       |  2 +-
 packages/typescript/ai-fal/CHANGELOG.md                |  7 +++++++
 packages/typescript/ai-fal/package.json                |  2 +-
 packages/typescript/ai-isolate-cloudflare/CHANGELOG.md |  7 +++++++
 packages/typescript/ai-isolate-cloudflare/package.json |  2 +-
 packages/typescript/ai-isolate-node/CHANGELOG.md       |  7 +++++++
 packages/typescript/ai-isolate-node/package.json       |  2 +-
 packages/typescript/ai-isolate-quickjs/CHANGELOG.md    |  7 +++++++
 packages/typescript/ai-isolate-quickjs/package.json    |  2 +-
 packages/typescript/ai-preact/CHANGELOG.md             |  8 ++++++++
 packages/typescript/ai-preact/package.json             |  2 +-
 packages/typescript/ai-react/CHANGELOG.md              |  8 ++++++++
 packages/typescript/ai-react/package.json              |  2 +-
 packages/typescript/ai-solid/CHANGELOG.md              |  8 ++++++++
 packages/typescript/ai-solid/package.json              |  2 +-
 packages/typescript/ai-svelte/CHANGELOG.md             |  8 ++++++++
 packages/typescript/ai-svelte/package.json             |  2 +-
 packages/typescript/ai-vue-ui/CHANGELOG.md             |  7 +++++++
 packages/typescript/ai-vue-ui/package.json             |  2 +-
 packages/typescript/ai-vue/CHANGELOG.md                |  8 ++++++++
 packages/typescript/ai-vue/package.json                |  2 +-
 packages/typescript/ai/CHANGELOG.md                    |  9 +++++++++
 packages/typescript/ai/package.json                    |  2 +-
 packages/typescript/preact-ai-devtools/CHANGELOG.md    |  7 +++++++
 packages/typescript/preact-ai-devtools/package.json    |  2 +-
 packages/typescript/react-ai-devtools/CHANGELOG.md     |  7 +++++++
 packages/typescript/react-ai-devtools/package.json     |  2 +-
 packages/typescript/solid-ai-devtools/CHANGELOG.md     |  7 +++++++
 packages/typescript/solid-ai-devtools/package.json     |  2 +-
 39 files changed, 166 insertions(+), 26 deletions(-)
 delete mode 100644 .changeset/server-tool-results-complete.md

diff --git a/.changeset/server-tool-results-complete.md b/.changeset/server-tool-results-complete.md
deleted file mode 100644
index 0b97fbd43..000000000
--- a/.changeset/server-tool-results-complete.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-'@tanstack/ai': patch
-'@tanstack/ai-client': patch
-'@tanstack/ai-event-client': patch
----
-
-Populate server-executed tool results on the matching `tool-call` part and mark successful tool calls as `complete`.
diff --git a/packages/typescript/ai-client/CHANGELOG.md b/packages/typescript/ai-client/CHANGELOG.md
index 08122d965..249eeac5d 100644
--- a/packages/typescript/ai-client/CHANGELOG.md
+++ b/packages/typescript/ai-client/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/ai-client
 
+## 0.11.7
+
+### Patch Changes
+
+- Populate server-executed tool results on the matching `tool-call` part and mark successful tool calls as `complete`. ([#596](https://github.com/TanStack/ai/pull/596))
+
+- Updated dependencies [[`e144a53`](https://github.com/TanStack/ai/commit/e144a53e4348bb0bc365dbe342c8538544242227)]:
+  - @tanstack/ai@0.21.3
+  - @tanstack/ai-event-client@0.3.10
+
 ## 0.11.6
 
 ### Patch Changes
diff --git a/packages/typescript/ai-client/package.json b/packages/typescript/ai-client/package.json
index b6e40f456..ed2837288 100644
--- a/packages/typescript/ai-client/package.json
+++ b/packages/typescript/ai-client/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-client",
-  "version": "0.11.6",
+  "version": "0.11.7",
   "description": "Framework-agnostic headless client for TanStack AI chat, realtime sessions, streaming transports, and media generations.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-code-mode-skills/CHANGELOG.md b/packages/typescript/ai-code-mode-skills/CHANGELOG.md
index 82923e3e1..7904f7b31 100644
--- 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.20
+
+### Patch Changes
+
+- Updated dependencies [[`e144a53`](https://github.com/TanStack/ai/commit/e144a53e4348bb0bc365dbe342c8538544242227)]:
+  - @tanstack/ai@0.21.3
+  - @tanstack/ai-code-mode@0.1.20
+
 ## 0.1.19
 
 ### Patch Changes
diff --git a/packages/typescript/ai-code-mode-skills/package.json b/packages/typescript/ai-code-mode-skills/package.json
index ebc48dd3f..9e6120700 100644
--- 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.19",
+  "version": "0.1.20",
   "description": "Persistent runtime skill library for TanStack AI Code Mode agents and sandboxed tool orchestration.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-code-mode/CHANGELOG.md b/packages/typescript/ai-code-mode/CHANGELOG.md
index ee3d3414a..d7c243024 100644
--- 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.20
+
+### Patch Changes
+
+- Updated dependencies [[`e144a53`](https://github.com/TanStack/ai/commit/e144a53e4348bb0bc365dbe342c8538544242227)]:
+  - @tanstack/ai@0.21.3
+
 ## 0.1.19
 
 ### Patch Changes
diff --git a/packages/typescript/ai-code-mode/package.json b/packages/typescript/ai-code-mode/package.json
index 70498aa72..ddfdf2495 100644
--- 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.19",
+  "version": "0.1.20",
   "description": "Secure TypeScript Code Mode for TanStack AI agents to execute sandboxed tool orchestration programs.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-devtools/CHANGELOG.md b/packages/typescript/ai-devtools/CHANGELOG.md
index 8ad237c00..0e1cec9e0 100644
--- a/packages/typescript/ai-devtools/CHANGELOG.md
+++ b/packages/typescript/ai-devtools/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-devtools-core
 
+## 0.3.37
+
+### Patch Changes
+
+- Updated dependencies [[`e144a53`](https://github.com/TanStack/ai/commit/e144a53e4348bb0bc365dbe342c8538544242227)]:
+  - @tanstack/ai@0.21.3
+  - @tanstack/ai-event-client@0.3.10
+
 ## 0.3.36
 
 ### Patch Changes
diff --git a/packages/typescript/ai-devtools/package.json b/packages/typescript/ai-devtools/package.json
index d7ca23d69..b76fddd39 100644
--- 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.36",
+  "version": "0.3.37",
   "description": "Core TanStack AI Devtools plugin for inspecting chat messages, tool calls, streams, and errors.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-event-client/CHANGELOG.md b/packages/typescript/ai-event-client/CHANGELOG.md
index 1c327312e..6dd418540 100644
--- a/packages/typescript/ai-event-client/CHANGELOG.md
+++ b/packages/typescript/ai-event-client/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @tanstack/ai-event-client
 
+## 0.3.10
+
+### Patch Changes
+
+- Populate server-executed tool results on the matching `tool-call` part and mark successful tool calls as `complete`. ([#596](https://github.com/TanStack/ai/pull/596))
+
+- Updated dependencies [[`e144a53`](https://github.com/TanStack/ai/commit/e144a53e4348bb0bc365dbe342c8538544242227)]:
+  - @tanstack/ai@0.21.3
+
 ## 0.3.9
 
 ### Patch Changes
diff --git a/packages/typescript/ai-event-client/package.json b/packages/typescript/ai-event-client/package.json
index 64d5a3eee..439a795f1 100644
--- 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.3.9",
+  "version": "0.3.10",
   "description": "Typed event client for TanStack AI devtools, observability, and streamed runtime events.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-fal/CHANGELOG.md b/packages/typescript/ai-fal/CHANGELOG.md
index c9faa7fc9..d7c959407 100644
--- a/packages/typescript/ai-fal/CHANGELOG.md
+++ b/packages/typescript/ai-fal/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/ai-fal
 
+## 0.7.13
+
+### Patch Changes
+
+- Updated dependencies [[`e144a53`](https://github.com/TanStack/ai/commit/e144a53e4348bb0bc365dbe342c8538544242227)]:
+  - @tanstack/ai@0.21.3
+
 ## 0.7.12
 
 ### Patch Changes
diff --git a/packages/typescript/ai-fal/package.json b/packages/typescript/ai-fal/package.json
index fecea6aaf..b942b7c84 100644
--- 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.12",
+  "version": "0.7.13",
   "description": "fal.ai adapter for TanStack AI image, video, audio, speech, and transcription generation.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-isolate-cloudflare/CHANGELOG.md b/packages/typescript/ai-isolate-cloudflare/CHANGELOG.md
index 68552bdf2..1b88e60ba 100644
--- a/packages/typescript/ai-isolate-cloudflare/CHANGELOG.md
+++ b/packages/typescript/ai-isolate-cloudflare/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/ai-isolate-cloudflare
 
+## 0.2.11
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/ai-code-mode@0.1.20
+
 ## 0.2.10
 
 ### Patch Changes
diff --git a/packages/typescript/ai-isolate-cloudflare/package.json b/packages/typescript/ai-isolate-cloudflare/package.json
index a677ae64f..ba3101b20 100644
--- a/packages/typescript/ai-isolate-cloudflare/package.json
+++ b/packages/typescript/ai-isolate-cloudflare/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-isolate-cloudflare",
-  "version": "0.2.10",
+  "version": "0.2.11",
   "description": "Cloudflare Workers sandbox driver for TanStack AI Code Mode TypeScript execution at the edge.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-isolate-node/CHANGELOG.md b/packages/typescript/ai-isolate-node/CHANGELOG.md
index ae390b8d3..cba9d4683 100644
--- a/packages/typescript/ai-isolate-node/CHANGELOG.md
+++ b/packages/typescript/ai-isolate-node/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/ai-isolate-node
 
+## 0.1.20
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/ai-code-mode@0.1.20
+
 ## 0.1.19
 
 ### Patch Changes
diff --git a/packages/typescript/ai-isolate-node/package.json b/packages/typescript/ai-isolate-node/package.json
index 111a47ca2..ec4c1bb1f 100644
--- a/packages/typescript/ai-isolate-node/package.json
+++ b/packages/typescript/ai-isolate-node/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-isolate-node",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "Node.js isolated-vm sandbox driver for TanStack AI Code Mode TypeScript execution.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-isolate-quickjs/CHANGELOG.md b/packages/typescript/ai-isolate-quickjs/CHANGELOG.md
index 373ec6309..b6789c8fb 100644
--- a/packages/typescript/ai-isolate-quickjs/CHANGELOG.md
+++ b/packages/typescript/ai-isolate-quickjs/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/ai-isolate-quickjs
 
+## 0.1.20
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/ai-code-mode@0.1.20
+
 ## 0.1.19
 
 ### Patch Changes
diff --git a/packages/typescript/ai-isolate-quickjs/package.json b/packages/typescript/ai-isolate-quickjs/package.json
index bf2865555..83cae190a 100644
--- a/packages/typescript/ai-isolate-quickjs/package.json
+++ b/packages/typescript/ai-isolate-quickjs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-isolate-quickjs",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "QuickJS WASM sandbox driver for TanStack AI Code Mode TypeScript execution across runtimes.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-preact/CHANGELOG.md b/packages/typescript/ai-preact/CHANGELOG.md
index e239038eb..66fba3c66 100644
--- a/packages/typescript/ai-preact/CHANGELOG.md
+++ b/packages/typescript/ai-preact/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-preact
 
+## 0.6.32
+
+### Patch Changes
+
+- Updated dependencies [[`e144a53`](https://github.com/TanStack/ai/commit/e144a53e4348bb0bc365dbe342c8538544242227)]:
+  - @tanstack/ai@0.21.3
+  - @tanstack/ai-client@0.11.7
+
 ## 0.6.31
 
 ### Patch Changes
diff --git a/packages/typescript/ai-preact/package.json b/packages/typescript/ai-preact/package.json
index 99764cd91..047cc84ee 100644
--- a/packages/typescript/ai-preact/package.json
+++ b/packages/typescript/ai-preact/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-preact",
-  "version": "0.6.31",
+  "version": "0.6.32",
   "description": "Preact hooks for TanStack AI streaming chat and typed messages.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-react/CHANGELOG.md b/packages/typescript/ai-react/CHANGELOG.md
index 018633b2e..667a627ed 100644
--- a/packages/typescript/ai-react/CHANGELOG.md
+++ b/packages/typescript/ai-react/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-react
 
+## 0.11.7
+
+### Patch Changes
+
+- Updated dependencies [[`e144a53`](https://github.com/TanStack/ai/commit/e144a53e4348bb0bc365dbe342c8538544242227)]:
+  - @tanstack/ai@0.21.3
+  - @tanstack/ai-client@0.11.7
+
 ## 0.11.6
 
 ### Patch Changes
diff --git a/packages/typescript/ai-react/package.json b/packages/typescript/ai-react/package.json
index 27c2b2b1b..9919e4d06 100644
--- a/packages/typescript/ai-react/package.json
+++ b/packages/typescript/ai-react/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-react",
-  "version": "0.11.6",
+  "version": "0.11.7",
   "description": "React hooks for TanStack AI streaming chat, realtime voice, structured outputs, and media generation.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-solid/CHANGELOG.md b/packages/typescript/ai-solid/CHANGELOG.md
index d1bb5761f..9d67904e9 100644
--- a/packages/typescript/ai-solid/CHANGELOG.md
+++ b/packages/typescript/ai-solid/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-solid
 
+## 0.10.7
+
+### Patch Changes
+
+- Updated dependencies [[`e144a53`](https://github.com/TanStack/ai/commit/e144a53e4348bb0bc365dbe342c8538544242227)]:
+  - @tanstack/ai@0.21.3
+  - @tanstack/ai-client@0.11.7
+
 ## 0.10.6
 
 ### Patch Changes
diff --git a/packages/typescript/ai-solid/package.json b/packages/typescript/ai-solid/package.json
index 5d9bf4c19..2cda10e37 100644
--- a/packages/typescript/ai-solid/package.json
+++ b/packages/typescript/ai-solid/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-solid",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "description": "Solid hooks for TanStack AI streaming chat, structured outputs, and media generation.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-svelte/CHANGELOG.md b/packages/typescript/ai-svelte/CHANGELOG.md
index 834f2e6a2..f3d8ca58c 100644
--- a/packages/typescript/ai-svelte/CHANGELOG.md
+++ b/packages/typescript/ai-svelte/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-svelte
 
+## 0.10.7
+
+### Patch Changes
+
+- Updated dependencies [[`e144a53`](https://github.com/TanStack/ai/commit/e144a53e4348bb0bc365dbe342c8538544242227)]:
+  - @tanstack/ai@0.21.3
+  - @tanstack/ai-client@0.11.7
+
 ## 0.10.6
 
 ### Patch Changes
diff --git a/packages/typescript/ai-svelte/package.json b/packages/typescript/ai-svelte/package.json
index 33876ff8a..0a7902faf 100644
--- a/packages/typescript/ai-svelte/package.json
+++ b/packages/typescript/ai-svelte/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-svelte",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "description": "Svelte 5 bindings for TanStack AI streaming chat, structured outputs, and media generation.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai-vue-ui/CHANGELOG.md b/packages/typescript/ai-vue-ui/CHANGELOG.md
index 062db3131..f29308f06 100644
--- a/packages/typescript/ai-vue-ui/CHANGELOG.md
+++ b/packages/typescript/ai-vue-ui/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/ai-vue-ui
 
+## 0.2.3
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/ai-vue@0.10.8
+
 ## 0.2.2
 
 ### Patch Changes
diff --git a/packages/typescript/ai-vue-ui/package.json b/packages/typescript/ai-vue-ui/package.json
index e5ebadc99..b6ca1606f 100644
--- a/packages/typescript/ai-vue-ui/package.json
+++ b/packages/typescript/ai-vue-ui/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-vue-ui",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Headless Vue components for building TanStack AI chat interfaces with streamed message parts.",
   "module": "./src/index.ts",
   "types": "./src/index.ts",
diff --git a/packages/typescript/ai-vue/CHANGELOG.md b/packages/typescript/ai-vue/CHANGELOG.md
index ebf0085a1..20d95c8ef 100644
--- a/packages/typescript/ai-vue/CHANGELOG.md
+++ b/packages/typescript/ai-vue/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/ai-vue
 
+## 0.10.8
+
+### Patch Changes
+
+- Updated dependencies [[`e144a53`](https://github.com/TanStack/ai/commit/e144a53e4348bb0bc365dbe342c8538544242227)]:
+  - @tanstack/ai@0.21.3
+  - @tanstack/ai-client@0.11.7
+
 ## 0.10.7
 
 ### Patch Changes
diff --git a/packages/typescript/ai-vue/package.json b/packages/typescript/ai-vue/package.json
index b6f5449a2..41aa226eb 100644
--- a/packages/typescript/ai-vue/package.json
+++ b/packages/typescript/ai-vue/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-vue",
-  "version": "0.10.7",
+  "version": "0.10.8",
   "description": "Vue composables for TanStack AI streaming chat, structured outputs, and media generation.",
   "author": "",
   "license": "MIT",
diff --git a/packages/typescript/ai/CHANGELOG.md b/packages/typescript/ai/CHANGELOG.md
index 531dd024b..d9a3501cb 100644
--- a/packages/typescript/ai/CHANGELOG.md
+++ b/packages/typescript/ai/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @tanstack/ai
 
+## 0.21.3
+
+### Patch Changes
+
+- Populate server-executed tool results on the matching `tool-call` part and mark successful tool calls as `complete`. ([#596](https://github.com/TanStack/ai/pull/596))
+
+- Updated dependencies [[`e144a53`](https://github.com/TanStack/ai/commit/e144a53e4348bb0bc365dbe342c8538544242227)]:
+  - @tanstack/ai-event-client@0.3.10
+
 ## 0.21.2
 
 ### Patch Changes
diff --git a/packages/typescript/ai/package.json b/packages/typescript/ai/package.json
index 1988f2693..7686dbf88 100644
--- a/packages/typescript/ai/package.json
+++ b/packages/typescript/ai/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai",
-  "version": "0.21.2",
+  "version": "0.21.3",
   "description": "Type-safe TypeScript AI SDK for streaming chat, tool calling, agents, structured outputs, and multimodal generation.",
   "author": "Tanner Linsley",
   "license": "MIT",
diff --git a/packages/typescript/preact-ai-devtools/CHANGELOG.md b/packages/typescript/preact-ai-devtools/CHANGELOG.md
index 47b8297b0..218d4d938 100644
--- a/packages/typescript/preact-ai-devtools/CHANGELOG.md
+++ b/packages/typescript/preact-ai-devtools/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/preact-ai-devtools
 
+## 0.1.41
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/ai-devtools-core@0.3.37
+
 ## 0.1.40
 
 ### Patch Changes
diff --git a/packages/typescript/preact-ai-devtools/package.json b/packages/typescript/preact-ai-devtools/package.json
index 2c8a69e83..8b0d5ac11 100644
--- a/packages/typescript/preact-ai-devtools/package.json
+++ b/packages/typescript/preact-ai-devtools/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/preact-ai-devtools",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "description": "Preact Devtools plugin for inspecting TanStack AI chat messages, tool calls, streams, and errors.",
   "author": "tannerlinsley",
   "license": "MIT",
diff --git a/packages/typescript/react-ai-devtools/CHANGELOG.md b/packages/typescript/react-ai-devtools/CHANGELOG.md
index 4ce88f076..f9c33b043 100644
--- a/packages/typescript/react-ai-devtools/CHANGELOG.md
+++ b/packages/typescript/react-ai-devtools/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/react-ai-devtools
 
+## 0.2.41
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/ai-devtools-core@0.3.37
+
 ## 0.2.40
 
 ### Patch Changes
diff --git a/packages/typescript/react-ai-devtools/package.json b/packages/typescript/react-ai-devtools/package.json
index 9dca899e0..8ed91adb2 100644
--- a/packages/typescript/react-ai-devtools/package.json
+++ b/packages/typescript/react-ai-devtools/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/react-ai-devtools",
-  "version": "0.2.40",
+  "version": "0.2.41",
   "description": "React Devtools plugin for inspecting TanStack AI chat messages, tool calls, streams, and errors.",
   "author": "tannerlinsley",
   "license": "MIT",
diff --git a/packages/typescript/solid-ai-devtools/CHANGELOG.md b/packages/typescript/solid-ai-devtools/CHANGELOG.md
index cd76d532e..c9ec4ff02 100644
--- a/packages/typescript/solid-ai-devtools/CHANGELOG.md
+++ b/packages/typescript/solid-ai-devtools/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/solid-ai-devtools
 
+## 0.2.41
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/ai-devtools-core@0.3.37
+
 ## 0.2.40
 
 ### Patch Changes
diff --git a/packages/typescript/solid-ai-devtools/package.json b/packages/typescript/solid-ai-devtools/package.json
index 4acf0d1d4..c68b30dec 100644
--- a/packages/typescript/solid-ai-devtools/package.json
+++ b/packages/typescript/solid-ai-devtools/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/solid-ai-devtools",
-  "version": "0.2.40",
+  "version": "0.2.41",
   "description": "Solid Devtools plugin for inspecting TanStack AI chat messages, tool calls, streams, and errors.",
   "author": "",
   "license": "MIT",

From 0fdf634b53e305181b23023f66174a5e2283134b Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sun, 24 May 2026 21:39:07 +0200
Subject: [PATCH 08/10] docs: regenerate API documentation (#631)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
---
 docs/reference/classes/StreamProcessor.md     | 20 ++---
 .../convertMessagesToModelMessages.md         |  2 +-
 .../reference/functions/createReplayStream.md |  2 +-
 docs/reference/functions/generateMessageId.md |  2 +-
 .../functions/modelMessageToUIMessage.md      |  2 +-
 .../functions/modelMessagesToUIMessages.md    |  2 +-
 .../functions/normalizeToUIMessage.md         |  2 +-
 .../functions/uiMessageToModelMessages.md     |  2 +-
 docs/reference/interfaces/AgentLoopState.md   |  8 +-
 .../interfaces/ApprovalRequestedEvent.md      |  8 +-
 .../interfaces/AudioGenerationOptions.md      | 12 +--
 .../interfaces/AudioGenerationResult.md       | 10 +--
 docs/reference/interfaces/AudioPart.md        |  8 +-
 docs/reference/interfaces/BaseAGUIEvent.md    |  4 +-
 .../interfaces/ContentPartDataSource.md       |  8 +-
 .../interfaces/ContentPartUrlSource.md        |  8 +-
 docs/reference/interfaces/CustomEvent.md      |  4 +-
 .../DefaultMessageMetadataByModality.md       | 12 +--
 docs/reference/interfaces/DocumentPart.md     |  8 +-
 .../interfaces/ImageGenerationOptions.md      | 14 ++--
 .../interfaces/ImageGenerationResult.md       | 10 +--
 docs/reference/interfaces/ImagePart.md        |  8 +-
 docs/reference/interfaces/JSONSchema.md       | 76 +++++++++----------
 .../interfaces/MessagesSnapshotEvent.md       |  4 +-
 docs/reference/interfaces/ModelMessage.md     | 14 ++--
 docs/reference/interfaces/ProviderTool.md     | 16 ++--
 .../ReasoningEncryptedValueEvent.md           |  4 +-
 .../reference/interfaces/ReasoningEndEvent.md |  4 +-
 .../ReasoningMessageContentEvent.md           |  4 +-
 .../interfaces/ReasoningMessageEndEvent.md    |  4 +-
 .../interfaces/ReasoningMessageStartEvent.md  |  4 +-
 .../interfaces/ReasoningStartEvent.md         |  4 +-
 docs/reference/interfaces/ResponseFormat.md   |  8 +-
 docs/reference/interfaces/RunErrorEvent.md    |  6 +-
 docs/reference/interfaces/RunFinishedEvent.md |  8 +-
 docs/reference/interfaces/RunStartedEvent.md  |  4 +-
 docs/reference/interfaces/ServerTool.md       | 16 ++--
 docs/reference/interfaces/StateDeltaEvent.md  |  4 +-
 .../interfaces/StateSnapshotEvent.md          |  6 +-
 .../reference/interfaces/StepFinishedEvent.md | 12 +--
 docs/reference/interfaces/StepStartedEvent.md |  8 +-
 .../StructuredOutputCompleteEvent.md          |  8 +-
 .../interfaces/StructuredOutputPart.md        | 18 ++---
 .../interfaces/StructuredOutputStartEvent.md  |  8 +-
 .../interfaces/SummarizationOptions.md        | 16 ++--
 .../interfaces/SummarizationResult.md         | 10 +--
 docs/reference/interfaces/TTSOptions.md       | 16 ++--
 docs/reference/interfaces/TTSResult.md        | 14 ++--
 .../interfaces/TextCompletionChunk.md         | 14 ++--
 .../interfaces/TextMessageContentEvent.md     |  6 +-
 .../interfaces/TextMessageEndEvent.md         |  4 +-
 .../interfaces/TextMessageStartEvent.md       |  4 +-
 docs/reference/interfaces/TextOptions.md      | 38 +++++-----
 docs/reference/interfaces/TextPart.md         |  8 +-
 docs/reference/interfaces/ThinkingPart.md     | 10 +--
 docs/reference/interfaces/Tool.md             | 18 ++---
 docs/reference/interfaces/ToolCall.md         | 10 +--
 .../reference/interfaces/ToolCallArgsEvent.md |  6 +-
 docs/reference/interfaces/ToolCallEndEvent.md | 12 +--
 docs/reference/interfaces/ToolCallPart.md     | 18 ++---
 .../interfaces/ToolCallResultEvent.md         |  4 +-
 .../interfaces/ToolCallStartEvent.md          | 10 +--
 docs/reference/interfaces/ToolConfig.md       |  2 +-
 docs/reference/interfaces/ToolDefinition.md   | 16 ++--
 .../interfaces/ToolDefinitionInstance.md      | 16 ++--
 .../interfaces/ToolExecutionContext.md        |  6 +-
 .../interfaces/ToolInputAvailableEvent.md     |  8 +-
 docs/reference/interfaces/ToolResultPart.md   | 12 +--
 .../interfaces/TranscriptionOptions.md        | 16 ++--
 .../interfaces/TranscriptionResult.md         | 16 ++--
 .../interfaces/TranscriptionSegment.md        | 14 ++--
 .../reference/interfaces/TranscriptionWord.md |  8 +-
 docs/reference/interfaces/UIMessage.md        | 10 +--
 .../interfaces/VideoGenerationOptions.md      | 14 ++--
 docs/reference/interfaces/VideoJobResult.md   |  6 +-
 docs/reference/interfaces/VideoPart.md        |  8 +-
 .../reference/interfaces/VideoStatusResult.md | 10 +--
 docs/reference/interfaces/VideoUrlResult.md   |  8 +-
 docs/reference/type-aliases/AGUIEvent.md      |  2 +-
 docs/reference/type-aliases/AGUIEventType.md  |  2 +-
 .../type-aliases/AgentLoopStrategy.md         |  2 +-
 .../type-aliases/ConstrainedContent.md        |  2 +-
 .../type-aliases/ConstrainedModelMessage.md   |  2 +-
 docs/reference/type-aliases/ContentPart.md    |  2 +-
 .../ContentPartForInputModalitiesTypes.md     |  2 +-
 .../type-aliases/ContentPartSource.md         |  2 +-
 docs/reference/type-aliases/DeepPartial.md    |  2 +-
 docs/reference/type-aliases/GeneratedAudio.md |  2 +-
 docs/reference/type-aliases/GeneratedImage.md |  2 +-
 .../type-aliases/GeneratedMediaSource.md      |  2 +-
 .../reference/type-aliases/InferSchemaType.md |  2 +-
 .../type-aliases/InputModalitiesTypes.md      |  6 +-
 docs/reference/type-aliases/MessagePart.md    |  2 +-
 .../type-aliases/ModalitiesArrayToUnion.md    |  2 +-
 docs/reference/type-aliases/Modality.md       |  2 +-
 docs/reference/type-aliases/SchemaInput.md    |  2 +-
 docs/reference/type-aliases/StreamChunk.md    |  2 +-
 .../reference/type-aliases/StreamChunkType.md |  2 +-
 .../type-aliases/StructuredOutputStream.md    |  2 +-
 docs/reference/type-aliases/ToolCallState.md  |  3 +-
 .../reference/type-aliases/ToolResultState.md |  2 +-
 101 files changed, 418 insertions(+), 417 deletions(-)

diff --git a/docs/reference/classes/StreamProcessor.md b/docs/reference/classes/StreamProcessor.md
index a17fcc9db..39a831082 100644
--- a/docs/reference/classes/StreamProcessor.md
+++ b/docs/reference/classes/StreamProcessor.md
@@ -177,7 +177,7 @@ Useful for auto-continue logic
 clearMessages(): void;
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:419](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L419)
+Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:420](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L420)
 
 Clear all messages
 
@@ -193,7 +193,7 @@ Clear all messages
 finalizeStream(): void;
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:1683](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L1683)
+Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:1684](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L1684)
 
 Finalize the stream — complete all pending operations.
 
@@ -251,7 +251,7 @@ Get current messages
 getRecording(): ChunkRecording | null;
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:1844](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L1844)
+Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:1845](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L1845)
 
 Get the current recording
 
@@ -267,7 +267,7 @@ Get the current recording
 getState(): ProcessorState;
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:1801](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L1801)
+Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:1802](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L1802)
 
 Get current processor state (aggregated across all messages)
 
@@ -303,7 +303,7 @@ auto-continuation produces no content.
 process(stream): Promise<ProcessorResult>;
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:436](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L436)
+Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:437](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L437)
 
 Process a stream and emit events through handlers
 
@@ -325,7 +325,7 @@ Process a stream and emit events through handlers
 processChunk(chunk): void;
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:470](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L470)
+Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:471](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L471)
 
 Process a single chunk from the stream.
 
@@ -355,7 +355,7 @@ docs/chat-architecture.md#adapter-contract — Expected event types and ordering
 removeMessagesAfter(index): void;
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:390](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L390)
+Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:391](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L391)
 
 Remove messages after a certain index (for reload/retry)
 
@@ -377,7 +377,7 @@ Remove messages after a certain index (for reload/retry)
 reset(): void;
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:1868](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L1868)
+Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:1869](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L1869)
 
 Full reset (including messages)
 
@@ -440,7 +440,7 @@ an assistant message which can cause empty message flicker.
 startRecording(): void;
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:1831](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L1831)
+Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:1832](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L1832)
 
 Start recording chunks
 
@@ -478,7 +478,7 @@ Get the conversation as ModelMessages (for sending to LLM)
 static replay(recording, options?): Promise<ProcessorResult>;
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:1887](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L1887)
+Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:1888](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L1888)
 
 Replay a recording through the processor
 
diff --git a/docs/reference/functions/convertMessagesToModelMessages.md b/docs/reference/functions/convertMessagesToModelMessages.md
index 81194e231..233941e5d 100644
--- a/docs/reference/functions/convertMessagesToModelMessages.md
+++ b/docs/reference/functions/convertMessagesToModelMessages.md
@@ -12,7 +12,7 @@ function convertMessagesToModelMessages(messages): ModelMessage<
   | null>[];
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/messages.ts:71](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/messages.ts#L71)
+Defined in: [packages/typescript/ai/src/activities/chat/messages.ts:79](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/messages.ts#L79)
 
 Convert UIMessages or ModelMessages to ModelMessages
 
diff --git a/docs/reference/functions/createReplayStream.md b/docs/reference/functions/createReplayStream.md
index 33cd60824..a85dd2ded 100644
--- a/docs/reference/functions/createReplayStream.md
+++ b/docs/reference/functions/createReplayStream.md
@@ -9,7 +9,7 @@ title: createReplayStream
 function createReplayStream(recording): AsyncIterable<AGUIEvent>;
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:1899](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L1899)
+Defined in: [packages/typescript/ai/src/activities/chat/stream/processor.ts:1900](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/stream/processor.ts#L1900)
 
 Create an async iterable from a recording
 
diff --git a/docs/reference/functions/generateMessageId.md b/docs/reference/functions/generateMessageId.md
index 9dfc5c4e7..8a865bd86 100644
--- a/docs/reference/functions/generateMessageId.md
+++ b/docs/reference/functions/generateMessageId.md
@@ -9,7 +9,7 @@ title: generateMessageId
 function generateMessageId(): string;
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/messages.ts:529](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/messages.ts#L529)
+Defined in: [packages/typescript/ai/src/activities/chat/messages.ts:549](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/messages.ts#L549)
 
 Generate a unique message ID
 
diff --git a/docs/reference/functions/modelMessageToUIMessage.md b/docs/reference/functions/modelMessageToUIMessage.md
index d67c90872..0319a3ddf 100644
--- a/docs/reference/functions/modelMessageToUIMessage.md
+++ b/docs/reference/functions/modelMessageToUIMessage.md
@@ -9,7 +9,7 @@ title: modelMessageToUIMessage
 function modelMessageToUIMessage(modelMessage, id?): UIMessage;
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/messages.ts:385](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/messages.ts#L385)
+Defined in: [packages/typescript/ai/src/activities/chat/messages.ts:394](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/messages.ts#L394)
 
 Convert a ModelMessage to UIMessage
 
diff --git a/docs/reference/functions/modelMessagesToUIMessages.md b/docs/reference/functions/modelMessagesToUIMessages.md
index 1cbd5b110..98aa4a182 100644
--- a/docs/reference/functions/modelMessagesToUIMessages.md
+++ b/docs/reference/functions/modelMessagesToUIMessages.md
@@ -9,7 +9,7 @@ title: modelMessagesToUIMessages
 function modelMessagesToUIMessages(modelMessages): UIMessage<unknown>[];
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/messages.ts:456](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/messages.ts#L456)
+Defined in: [packages/typescript/ai/src/activities/chat/messages.ts:465](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/messages.ts#L465)
 
 Convert an array of ModelMessages to UIMessages
 
diff --git a/docs/reference/functions/normalizeToUIMessage.md b/docs/reference/functions/normalizeToUIMessage.md
index 9d1533c8e..47e6b208f 100644
--- a/docs/reference/functions/normalizeToUIMessage.md
+++ b/docs/reference/functions/normalizeToUIMessage.md
@@ -9,7 +9,7 @@ title: normalizeToUIMessage
 function normalizeToUIMessage(message, generateId): UIMessage;
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/messages.ts:506](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/messages.ts#L506)
+Defined in: [packages/typescript/ai/src/activities/chat/messages.ts:526](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/messages.ts#L526)
 
 Normalize a message (UIMessage or ModelMessage) to a UIMessage
 Ensures the message has an ID and createdAt timestamp
diff --git a/docs/reference/functions/uiMessageToModelMessages.md b/docs/reference/functions/uiMessageToModelMessages.md
index 294fdc978..bbba0bdfa 100644
--- a/docs/reference/functions/uiMessageToModelMessages.md
+++ b/docs/reference/functions/uiMessageToModelMessages.md
@@ -12,7 +12,7 @@ function uiMessageToModelMessages(uiMessage): ModelMessage<
   | null>[];
 ```
 
-Defined in: [packages/typescript/ai/src/activities/chat/messages.ts:146](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/messages.ts#L146)
+Defined in: [packages/typescript/ai/src/activities/chat/messages.ts:154](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/activities/chat/messages.ts#L154)
 
 Convert a UIMessage to ModelMessage(s)
 
diff --git a/docs/reference/interfaces/AgentLoopState.md b/docs/reference/interfaces/AgentLoopState.md
index 22bc28351..8bd41ddf1 100644
--- a/docs/reference/interfaces/AgentLoopState.md
+++ b/docs/reference/interfaces/AgentLoopState.md
@@ -5,7 +5,7 @@ title: AgentLoopState
 
 # Interface: AgentLoopState
 
-Defined in: [packages/typescript/ai/src/types.ts:702](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L702)
+Defined in: [packages/typescript/ai/src/types.ts:703](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L703)
 
 State passed to agent loop strategy for determining whether to continue
 
@@ -17,7 +17,7 @@ State passed to agent loop strategy for determining whether to continue
 finishReason: string | null;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:708](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L708)
+Defined in: [packages/typescript/ai/src/types.ts:709](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L709)
 
 Finish reason from the last response
 
@@ -29,7 +29,7 @@ Finish reason from the last response
 iterationCount: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:704](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L704)
+Defined in: [packages/typescript/ai/src/types.ts:705](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L705)
 
 Current iteration count (0-indexed)
 
@@ -44,6 +44,6 @@ messages: ModelMessage<
   | null>[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:706](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L706)
+Defined in: [packages/typescript/ai/src/types.ts:707](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L707)
 
 Current messages array
diff --git a/docs/reference/interfaces/ApprovalRequestedEvent.md b/docs/reference/interfaces/ApprovalRequestedEvent.md
index ae3340884..04ee822e5 100644
--- a/docs/reference/interfaces/ApprovalRequestedEvent.md
+++ b/docs/reference/interfaces/ApprovalRequestedEvent.md
@@ -5,7 +5,7 @@ title: ApprovalRequestedEvent
 
 # Interface: ApprovalRequestedEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1195](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1195)
+Defined in: [packages/typescript/ai/src/types.ts:1196](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1196)
 
 Emitted when a server tool requires approval before execution. The agent
 loop yields this and pauses — `structured-output.complete` will not fire
@@ -31,7 +31,7 @@ for that run. The shape is fixed by the orchestrator's tool-approval flow
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1147](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1147)
+Defined in: [packages/typescript/ai/src/types.ts:1148](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1148)
 
 Model identifier for multi-model support
 
@@ -47,7 +47,7 @@ Model identifier for multi-model support
 name: "approval-requested";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1196](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1196)
+Defined in: [packages/typescript/ai/src/types.ts:1197](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1197)
 
 #### Overrides
 
@@ -63,7 +63,7 @@ CustomEvent.name
 value: object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1197](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1197)
+Defined in: [packages/typescript/ai/src/types.ts:1198](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1198)
 
 #### approval
 
diff --git a/docs/reference/interfaces/AudioGenerationOptions.md b/docs/reference/interfaces/AudioGenerationOptions.md
index 59edbeefe..2eee2baea 100644
--- a/docs/reference/interfaces/AudioGenerationOptions.md
+++ b/docs/reference/interfaces/AudioGenerationOptions.md
@@ -5,7 +5,7 @@ title: AudioGenerationOptions
 
 # Interface: AudioGenerationOptions\<TProviderOptions\>
 
-Defined in: [packages/typescript/ai/src/types.ts:1489](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1489)
+Defined in: [packages/typescript/ai/src/types.ts:1490](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1490)
 
 Options for audio generation (music, sound effects, etc.).
 These are the common options supported across providers.
@@ -24,7 +24,7 @@ These are the common options supported across providers.
 optional duration: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1497](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1497)
+Defined in: [packages/typescript/ai/src/types.ts:1498](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1498)
 
 Desired duration in seconds
 
@@ -36,7 +36,7 @@ Desired duration in seconds
 logger: InternalLogger;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1505](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1505)
+Defined in: [packages/typescript/ai/src/types.ts:1506](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1506)
 
 Internal logger threaded from the generateAudio() entry point. Adapters
 must call logger.request() before the SDK call and logger.errors() in
@@ -50,7 +50,7 @@ catch blocks.
 model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1493](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1493)
+Defined in: [packages/typescript/ai/src/types.ts:1494](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1494)
 
 The model to use for audio generation
 
@@ -62,7 +62,7 @@ The model to use for audio generation
 optional modelOptions: TProviderOptions;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1499](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1499)
+Defined in: [packages/typescript/ai/src/types.ts:1500](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1500)
 
 Model-specific options for audio generation
 
@@ -74,6 +74,6 @@ Model-specific options for audio generation
 prompt: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1495](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1495)
+Defined in: [packages/typescript/ai/src/types.ts:1496](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1496)
 
 Text description of the desired audio
diff --git a/docs/reference/interfaces/AudioGenerationResult.md b/docs/reference/interfaces/AudioGenerationResult.md
index 1643aa73e..eacc87acd 100644
--- a/docs/reference/interfaces/AudioGenerationResult.md
+++ b/docs/reference/interfaces/AudioGenerationResult.md
@@ -5,7 +5,7 @@ title: AudioGenerationResult
 
 # Interface: AudioGenerationResult
 
-Defined in: [packages/typescript/ai/src/types.ts:1521](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1521)
+Defined in: [packages/typescript/ai/src/types.ts:1522](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1522)
 
 Result of audio generation
 
@@ -17,7 +17,7 @@ Result of audio generation
 audio: GeneratedAudio;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1527](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1527)
+Defined in: [packages/typescript/ai/src/types.ts:1528](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1528)
 
 The generated audio
 
@@ -29,7 +29,7 @@ The generated audio
 id: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1523](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1523)
+Defined in: [packages/typescript/ai/src/types.ts:1524](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1524)
 
 Unique identifier for the generation
 
@@ -41,7 +41,7 @@ Unique identifier for the generation
 model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1525](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1525)
+Defined in: [packages/typescript/ai/src/types.ts:1526](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1526)
 
 Model used for generation
 
@@ -53,7 +53,7 @@ Model used for generation
 optional usage: object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1529](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1529)
+Defined in: [packages/typescript/ai/src/types.ts:1530](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1530)
 
 Token usage information (if available)
 
diff --git a/docs/reference/interfaces/AudioPart.md b/docs/reference/interfaces/AudioPart.md
index 47459e925..df3c3c8ad 100644
--- a/docs/reference/interfaces/AudioPart.md
+++ b/docs/reference/interfaces/AudioPart.md
@@ -5,7 +5,7 @@ title: AudioPart
 
 # Interface: AudioPart\<TMetadata\>
 
-Defined in: [packages/typescript/ai/src/types.ts:225](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L225)
+Defined in: [packages/typescript/ai/src/types.ts:226](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L226)
 
 Audio content part for multimodal messages.
 
@@ -25,7 +25,7 @@ Provider-specific metadata type
 optional metadata: TMetadata;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:230](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L230)
+Defined in: [packages/typescript/ai/src/types.ts:231](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L231)
 
 Provider-specific metadata (e.g., format, sample rate)
 
@@ -37,7 +37,7 @@ Provider-specific metadata (e.g., format, sample rate)
 source: ContentPartSource;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:228](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L228)
+Defined in: [packages/typescript/ai/src/types.ts:229](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L229)
 
 Source of the audio content
 
@@ -49,4 +49,4 @@ Source of the audio content
 type: "audio";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:226](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L226)
+Defined in: [packages/typescript/ai/src/types.ts:227](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L227)
diff --git a/docs/reference/interfaces/BaseAGUIEvent.md b/docs/reference/interfaces/BaseAGUIEvent.md
index eb492bbdb..66e5fdfac 100644
--- a/docs/reference/interfaces/BaseAGUIEvent.md
+++ b/docs/reference/interfaces/BaseAGUIEvent.md
@@ -5,7 +5,7 @@ title: BaseAGUIEvent
 
 # Interface: BaseAGUIEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:890](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L890)
+Defined in: [packages/typescript/ai/src/types.ts:891](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L891)
 
 Base structure for AG-UI events.
 Extends @ag-ui/core BaseEvent with TanStack AI additions.
@@ -31,6 +31,6 @@ TanStack AI adds: `model?`
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:892](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L892)
+Defined in: [packages/typescript/ai/src/types.ts:893](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L893)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/ContentPartDataSource.md b/docs/reference/interfaces/ContentPartDataSource.md
index a3576c7c1..c0977cd4c 100644
--- a/docs/reference/interfaces/ContentPartDataSource.md
+++ b/docs/reference/interfaces/ContentPartDataSource.md
@@ -5,7 +5,7 @@ title: ContentPartDataSource
 
 # Interface: ContentPartDataSource
 
-Defined in: [packages/typescript/ai/src/types.ts:166](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L166)
+Defined in: [packages/typescript/ai/src/types.ts:167](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L167)
 
 Source specification for inline data content (base64).
 Requires a mimeType to ensure providers receive proper content type information.
@@ -18,7 +18,7 @@ Requires a mimeType to ensure providers receive proper content type information.
 mimeType: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:179](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L179)
+Defined in: [packages/typescript/ai/src/types.ts:180](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L180)
 
 The MIME type of the content (e.g., 'image/png', 'audio/wav').
 Required for data sources to ensure proper handling by providers.
@@ -31,7 +31,7 @@ Required for data sources to ensure proper handling by providers.
 type: "data";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:170](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L170)
+Defined in: [packages/typescript/ai/src/types.ts:171](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L171)
 
 Indicates this is inline data content.
 
@@ -43,6 +43,6 @@ Indicates this is inline data content.
 value: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:174](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L174)
+Defined in: [packages/typescript/ai/src/types.ts:175](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L175)
 
 The base64-encoded content value.
diff --git a/docs/reference/interfaces/ContentPartUrlSource.md b/docs/reference/interfaces/ContentPartUrlSource.md
index 48596bcfa..fad2b1764 100644
--- a/docs/reference/interfaces/ContentPartUrlSource.md
+++ b/docs/reference/interfaces/ContentPartUrlSource.md
@@ -5,7 +5,7 @@ title: ContentPartUrlSource
 
 # Interface: ContentPartUrlSource
 
-Defined in: [packages/typescript/ai/src/types.ts:186](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L186)
+Defined in: [packages/typescript/ai/src/types.ts:187](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L187)
 
 Source specification for URL-based content.
 mimeType is optional as it can often be inferred from the URL or response headers.
@@ -18,7 +18,7 @@ mimeType is optional as it can often be inferred from the URL or response header
 optional mimeType: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:198](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L198)
+Defined in: [packages/typescript/ai/src/types.ts:199](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L199)
 
 Optional MIME type hint for cases where providers can't infer it from the URL.
 
@@ -30,7 +30,7 @@ Optional MIME type hint for cases where providers can't infer it from the URL.
 type: "url";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:190](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L190)
+Defined in: [packages/typescript/ai/src/types.ts:191](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L191)
 
 Indicates this is URL-referenced content.
 
@@ -42,6 +42,6 @@ Indicates this is URL-referenced content.
 value: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:194](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L194)
+Defined in: [packages/typescript/ai/src/types.ts:195](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L195)
 
 HTTP(S) URL or data URI pointing to the content.
diff --git a/docs/reference/interfaces/CustomEvent.md b/docs/reference/interfaces/CustomEvent.md
index 3ae9b180f..9d1c4aaca 100644
--- a/docs/reference/interfaces/CustomEvent.md
+++ b/docs/reference/interfaces/CustomEvent.md
@@ -5,7 +5,7 @@ title: CustomEvent
 
 # Interface: CustomEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1145](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1145)
+Defined in: [packages/typescript/ai/src/types.ts:1146](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1146)
 
 Custom event for extensibility.
 
@@ -37,6 +37,6 @@ TanStack AI adds: `model?`
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1147](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1147)
+Defined in: [packages/typescript/ai/src/types.ts:1148](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1148)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/DefaultMessageMetadataByModality.md b/docs/reference/interfaces/DefaultMessageMetadataByModality.md
index afd161320..bfeeb4401 100644
--- a/docs/reference/interfaces/DefaultMessageMetadataByModality.md
+++ b/docs/reference/interfaces/DefaultMessageMetadataByModality.md
@@ -5,7 +5,7 @@ title: DefaultMessageMetadataByModality
 
 # Interface: DefaultMessageMetadataByModality
 
-Defined in: [packages/typescript/ai/src/types.ts:1741](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1741)
+Defined in: [packages/typescript/ai/src/types.ts:1742](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1742)
 
 Default metadata type for adapters that don't define custom metadata.
 Uses unknown for all modalities.
@@ -18,7 +18,7 @@ Uses unknown for all modalities.
 audio: unknown;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1744](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1744)
+Defined in: [packages/typescript/ai/src/types.ts:1745](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1745)
 
 ***
 
@@ -28,7 +28,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1744](https://github.com/TanSta
 document: unknown;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1746](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1746)
+Defined in: [packages/typescript/ai/src/types.ts:1747](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1747)
 
 ***
 
@@ -38,7 +38,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1746](https://github.com/TanSta
 image: unknown;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1743](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1743)
+Defined in: [packages/typescript/ai/src/types.ts:1744](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1744)
 
 ***
 
@@ -48,7 +48,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1743](https://github.com/TanSta
 text: unknown;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1742](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1742)
+Defined in: [packages/typescript/ai/src/types.ts:1743](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1743)
 
 ***
 
@@ -58,4 +58,4 @@ Defined in: [packages/typescript/ai/src/types.ts:1742](https://github.com/TanSta
 video: unknown;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1745](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1745)
+Defined in: [packages/typescript/ai/src/types.ts:1746](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1746)
diff --git a/docs/reference/interfaces/DocumentPart.md b/docs/reference/interfaces/DocumentPart.md
index 847ec3c4a..afa56d6d1 100644
--- a/docs/reference/interfaces/DocumentPart.md
+++ b/docs/reference/interfaces/DocumentPart.md
@@ -5,7 +5,7 @@ title: DocumentPart
 
 # Interface: DocumentPart\<TMetadata\>
 
-Defined in: [packages/typescript/ai/src/types.ts:249](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L249)
+Defined in: [packages/typescript/ai/src/types.ts:250](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L250)
 
 Document content part for multimodal messages (e.g., PDFs).
 
@@ -25,7 +25,7 @@ Provider-specific metadata type (e.g., Anthropic's media_type)
 optional metadata: TMetadata;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:254](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L254)
+Defined in: [packages/typescript/ai/src/types.ts:255](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L255)
 
 Provider-specific metadata (e.g., media_type for PDFs)
 
@@ -37,7 +37,7 @@ Provider-specific metadata (e.g., media_type for PDFs)
 source: ContentPartSource;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:252](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L252)
+Defined in: [packages/typescript/ai/src/types.ts:253](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L253)
 
 Source of the document content
 
@@ -49,4 +49,4 @@ Source of the document content
 type: "document";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:250](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L250)
+Defined in: [packages/typescript/ai/src/types.ts:251](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L251)
diff --git a/docs/reference/interfaces/ImageGenerationOptions.md b/docs/reference/interfaces/ImageGenerationOptions.md
index 670054dc1..4f2b44fa8 100644
--- a/docs/reference/interfaces/ImageGenerationOptions.md
+++ b/docs/reference/interfaces/ImageGenerationOptions.md
@@ -5,7 +5,7 @@ title: ImageGenerationOptions
 
 # Interface: ImageGenerationOptions\<TProviderOptions, TSize\>
 
-Defined in: [packages/typescript/ai/src/types.ts:1416](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1416)
+Defined in: [packages/typescript/ai/src/types.ts:1417](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1417)
 
 Options for image generation.
 These are the common options supported across providers.
@@ -28,7 +28,7 @@ These are the common options supported across providers.
 logger: InternalLogger;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1434](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1434)
+Defined in: [packages/typescript/ai/src/types.ts:1435](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1435)
 
 Internal logger threaded from the generateImage() entry point. Adapters must
 call logger.request() before the SDK call and logger.errors() in catch blocks.
@@ -41,7 +41,7 @@ call logger.request() before the SDK call and logger.errors() in catch blocks.
 model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1421](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1421)
+Defined in: [packages/typescript/ai/src/types.ts:1422](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1422)
 
 The model to use for image generation
 
@@ -53,7 +53,7 @@ The model to use for image generation
 optional modelOptions: TProviderOptions;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1429](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1429)
+Defined in: [packages/typescript/ai/src/types.ts:1430](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1430)
 
 Model-specific options for image generation
 
@@ -65,7 +65,7 @@ Model-specific options for image generation
 optional numberOfImages: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1425](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1425)
+Defined in: [packages/typescript/ai/src/types.ts:1426](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1426)
 
 Number of images to generate (default: 1)
 
@@ -77,7 +77,7 @@ Number of images to generate (default: 1)
 prompt: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1423](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1423)
+Defined in: [packages/typescript/ai/src/types.ts:1424](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1424)
 
 Text description of the desired image(s)
 
@@ -89,6 +89,6 @@ Text description of the desired image(s)
 optional size: TSize;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1427](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1427)
+Defined in: [packages/typescript/ai/src/types.ts:1428](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1428)
 
 Image size in WIDTHxHEIGHT format (e.g., "1024x1024")
diff --git a/docs/reference/interfaces/ImageGenerationResult.md b/docs/reference/interfaces/ImageGenerationResult.md
index 1d8a003af..d0a3a42ca 100644
--- a/docs/reference/interfaces/ImageGenerationResult.md
+++ b/docs/reference/interfaces/ImageGenerationResult.md
@@ -5,7 +5,7 @@ title: ImageGenerationResult
 
 # Interface: ImageGenerationResult
 
-Defined in: [packages/typescript/ai/src/types.ts:1466](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1466)
+Defined in: [packages/typescript/ai/src/types.ts:1467](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1467)
 
 Result of image generation
 
@@ -17,7 +17,7 @@ Result of image generation
 id: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1468](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1468)
+Defined in: [packages/typescript/ai/src/types.ts:1469](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1469)
 
 Unique identifier for the generation
 
@@ -29,7 +29,7 @@ Unique identifier for the generation
 images: GeneratedImage[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1472](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1472)
+Defined in: [packages/typescript/ai/src/types.ts:1473](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1473)
 
 Array of generated images
 
@@ -41,7 +41,7 @@ Array of generated images
 model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1470](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1470)
+Defined in: [packages/typescript/ai/src/types.ts:1471](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1471)
 
 Model used for generation
 
@@ -53,7 +53,7 @@ Model used for generation
 optional usage: object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1474](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1474)
+Defined in: [packages/typescript/ai/src/types.ts:1475](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1475)
 
 Token usage information (if available)
 
diff --git a/docs/reference/interfaces/ImagePart.md b/docs/reference/interfaces/ImagePart.md
index 66a9ca8c4..57bbc77f9 100644
--- a/docs/reference/interfaces/ImagePart.md
+++ b/docs/reference/interfaces/ImagePart.md
@@ -5,7 +5,7 @@ title: ImagePart
 
 # Interface: ImagePart\<TMetadata\>
 
-Defined in: [packages/typescript/ai/src/types.ts:213](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L213)
+Defined in: [packages/typescript/ai/src/types.ts:214](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L214)
 
 Image content part for multimodal messages.
 
@@ -25,7 +25,7 @@ Provider-specific metadata type (e.g., OpenAI's detail level)
 optional metadata: TMetadata;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:218](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L218)
+Defined in: [packages/typescript/ai/src/types.ts:219](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L219)
 
 Provider-specific metadata (e.g., OpenAI's detail: 'auto' | 'low' | 'high')
 
@@ -37,7 +37,7 @@ Provider-specific metadata (e.g., OpenAI's detail: 'auto' | 'low' | 'high')
 source: ContentPartSource;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:216](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L216)
+Defined in: [packages/typescript/ai/src/types.ts:217](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L217)
 
 Source of the image content
 
@@ -49,4 +49,4 @@ Source of the image content
 type: "image";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:214](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L214)
+Defined in: [packages/typescript/ai/src/types.ts:215](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L215)
diff --git a/docs/reference/interfaces/JSONSchema.md b/docs/reference/interfaces/JSONSchema.md
index b6d0b5155..2fcb41550 100644
--- a/docs/reference/interfaces/JSONSchema.md
+++ b/docs/reference/interfaces/JSONSchema.md
@@ -5,7 +5,7 @@ title: JSONSchema
 
 # Interface: JSONSchema
 
-Defined in: [packages/typescript/ai/src/types.ts:56](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L56)
+Defined in: [packages/typescript/ai/src/types.ts:57](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L57)
 
 JSON Schema type for defining tool input/output schemas as raw JSON Schema objects.
 This allows tools to be defined without schema libraries when you have JSON Schema definitions available.
@@ -24,7 +24,7 @@ This allows tools to be defined without schema libraries when you have JSON Sche
 optional $defs: Record<string, JSONSchema>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:66](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L66)
+Defined in: [packages/typescript/ai/src/types.ts:67](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L67)
 
 ***
 
@@ -34,7 +34,7 @@ Defined in: [packages/typescript/ai/src/types.ts:66](https://github.com/TanStack
 optional $ref: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:65](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L65)
+Defined in: [packages/typescript/ai/src/types.ts:66](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L66)
 
 ***
 
@@ -44,7 +44,7 @@ Defined in: [packages/typescript/ai/src/types.ts:65](https://github.com/TanStack
 optional additionalItems: boolean | JSONSchema;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:87](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L87)
+Defined in: [packages/typescript/ai/src/types.ts:88](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L88)
 
 ***
 
@@ -54,7 +54,7 @@ Defined in: [packages/typescript/ai/src/types.ts:87](https://github.com/TanStack
 optional additionalProperties: boolean | JSONSchema;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:86](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L86)
+Defined in: [packages/typescript/ai/src/types.ts:87](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L87)
 
 ***
 
@@ -64,7 +64,7 @@ Defined in: [packages/typescript/ai/src/types.ts:86](https://github.com/TanStack
 optional allOf: JSONSchema[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:68](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L68)
+Defined in: [packages/typescript/ai/src/types.ts:69](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L69)
 
 ***
 
@@ -74,7 +74,7 @@ Defined in: [packages/typescript/ai/src/types.ts:68](https://github.com/TanStack
 optional anyOf: JSONSchema[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:69](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L69)
+Defined in: [packages/typescript/ai/src/types.ts:70](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L70)
 
 ***
 
@@ -84,7 +84,7 @@ Defined in: [packages/typescript/ai/src/types.ts:69](https://github.com/TanStack
 optional const: unknown;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:62](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L62)
+Defined in: [packages/typescript/ai/src/types.ts:63](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L63)
 
 ***
 
@@ -94,7 +94,7 @@ Defined in: [packages/typescript/ai/src/types.ts:62](https://github.com/TanStack
 optional default: unknown;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:64](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L64)
+Defined in: [packages/typescript/ai/src/types.ts:65](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L65)
 
 ***
 
@@ -104,7 +104,7 @@ Defined in: [packages/typescript/ai/src/types.ts:64](https://github.com/TanStack
 optional definitions: Record<string, JSONSchema>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:67](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L67)
+Defined in: [packages/typescript/ai/src/types.ts:68](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L68)
 
 ***
 
@@ -114,7 +114,7 @@ Defined in: [packages/typescript/ai/src/types.ts:67](https://github.com/TanStack
 optional description: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:63](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L63)
+Defined in: [packages/typescript/ai/src/types.ts:64](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L64)
 
 ***
 
@@ -124,7 +124,7 @@ Defined in: [packages/typescript/ai/src/types.ts:63](https://github.com/TanStack
 optional else: JSONSchema;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:74](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L74)
+Defined in: [packages/typescript/ai/src/types.ts:75](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L75)
 
 ***
 
@@ -134,7 +134,7 @@ Defined in: [packages/typescript/ai/src/types.ts:74](https://github.com/TanStack
 optional enum: unknown[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:61](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L61)
+Defined in: [packages/typescript/ai/src/types.ts:62](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L62)
 
 ***
 
@@ -144,7 +144,7 @@ Defined in: [packages/typescript/ai/src/types.ts:61](https://github.com/TanStack
 optional examples: unknown[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:93](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L93)
+Defined in: [packages/typescript/ai/src/types.ts:94](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L94)
 
 ***
 
@@ -154,7 +154,7 @@ Defined in: [packages/typescript/ai/src/types.ts:93](https://github.com/TanStack
 optional exclusiveMaximum: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:78](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L78)
+Defined in: [packages/typescript/ai/src/types.ts:79](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L79)
 
 ***
 
@@ -164,7 +164,7 @@ Defined in: [packages/typescript/ai/src/types.ts:78](https://github.com/TanStack
 optional exclusiveMinimum: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:77](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L77)
+Defined in: [packages/typescript/ai/src/types.ts:78](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L78)
 
 ***
 
@@ -174,7 +174,7 @@ Defined in: [packages/typescript/ai/src/types.ts:77](https://github.com/TanStack
 optional format: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:82](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L82)
+Defined in: [packages/typescript/ai/src/types.ts:83](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L83)
 
 ***
 
@@ -184,7 +184,7 @@ Defined in: [packages/typescript/ai/src/types.ts:82](https://github.com/TanStack
 optional if: JSONSchema;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:72](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L72)
+Defined in: [packages/typescript/ai/src/types.ts:73](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L73)
 
 ***
 
@@ -194,7 +194,7 @@ Defined in: [packages/typescript/ai/src/types.ts:72](https://github.com/TanStack
 optional items: JSONSchema | JSONSchema[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:59](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L59)
+Defined in: [packages/typescript/ai/src/types.ts:60](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L60)
 
 ***
 
@@ -204,7 +204,7 @@ Defined in: [packages/typescript/ai/src/types.ts:59](https://github.com/TanStack
 optional maximum: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:76](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L76)
+Defined in: [packages/typescript/ai/src/types.ts:77](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L77)
 
 ***
 
@@ -214,7 +214,7 @@ Defined in: [packages/typescript/ai/src/types.ts:76](https://github.com/TanStack
 optional maxItems: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:84](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L84)
+Defined in: [packages/typescript/ai/src/types.ts:85](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L85)
 
 ***
 
@@ -224,7 +224,7 @@ Defined in: [packages/typescript/ai/src/types.ts:84](https://github.com/TanStack
 optional maxLength: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:80](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L80)
+Defined in: [packages/typescript/ai/src/types.ts:81](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L81)
 
 ***
 
@@ -234,7 +234,7 @@ Defined in: [packages/typescript/ai/src/types.ts:80](https://github.com/TanStack
 optional maxProperties: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:91](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L91)
+Defined in: [packages/typescript/ai/src/types.ts:92](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L92)
 
 ***
 
@@ -244,7 +244,7 @@ Defined in: [packages/typescript/ai/src/types.ts:91](https://github.com/TanStack
 optional minimum: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:75](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L75)
+Defined in: [packages/typescript/ai/src/types.ts:76](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L76)
 
 ***
 
@@ -254,7 +254,7 @@ Defined in: [packages/typescript/ai/src/types.ts:75](https://github.com/TanStack
 optional minItems: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:83](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L83)
+Defined in: [packages/typescript/ai/src/types.ts:84](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L84)
 
 ***
 
@@ -264,7 +264,7 @@ Defined in: [packages/typescript/ai/src/types.ts:83](https://github.com/TanStack
 optional minLength: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:79](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L79)
+Defined in: [packages/typescript/ai/src/types.ts:80](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L80)
 
 ***
 
@@ -274,7 +274,7 @@ Defined in: [packages/typescript/ai/src/types.ts:79](https://github.com/TanStack
 optional minProperties: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:90](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L90)
+Defined in: [packages/typescript/ai/src/types.ts:91](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L91)
 
 ***
 
@@ -284,7 +284,7 @@ Defined in: [packages/typescript/ai/src/types.ts:90](https://github.com/TanStack
 optional not: JSONSchema;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:71](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L71)
+Defined in: [packages/typescript/ai/src/types.ts:72](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L72)
 
 ***
 
@@ -294,7 +294,7 @@ Defined in: [packages/typescript/ai/src/types.ts:71](https://github.com/TanStack
 optional oneOf: JSONSchema[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:70](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L70)
+Defined in: [packages/typescript/ai/src/types.ts:71](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L71)
 
 ***
 
@@ -304,7 +304,7 @@ Defined in: [packages/typescript/ai/src/types.ts:70](https://github.com/TanStack
 optional pattern: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:81](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L81)
+Defined in: [packages/typescript/ai/src/types.ts:82](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L82)
 
 ***
 
@@ -314,7 +314,7 @@ Defined in: [packages/typescript/ai/src/types.ts:81](https://github.com/TanStack
 optional patternProperties: Record<string, JSONSchema>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:88](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L88)
+Defined in: [packages/typescript/ai/src/types.ts:89](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L89)
 
 ***
 
@@ -324,7 +324,7 @@ Defined in: [packages/typescript/ai/src/types.ts:88](https://github.com/TanStack
 optional properties: Record<string, JSONSchema>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:58](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L58)
+Defined in: [packages/typescript/ai/src/types.ts:59](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L59)
 
 ***
 
@@ -334,7 +334,7 @@ Defined in: [packages/typescript/ai/src/types.ts:58](https://github.com/TanStack
 optional propertyNames: JSONSchema;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:89](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L89)
+Defined in: [packages/typescript/ai/src/types.ts:90](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L90)
 
 ***
 
@@ -344,7 +344,7 @@ Defined in: [packages/typescript/ai/src/types.ts:89](https://github.com/TanStack
 optional required: string[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:60](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L60)
+Defined in: [packages/typescript/ai/src/types.ts:61](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L61)
 
 ***
 
@@ -354,7 +354,7 @@ Defined in: [packages/typescript/ai/src/types.ts:60](https://github.com/TanStack
 optional then: JSONSchema;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:73](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L73)
+Defined in: [packages/typescript/ai/src/types.ts:74](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L74)
 
 ***
 
@@ -364,7 +364,7 @@ Defined in: [packages/typescript/ai/src/types.ts:73](https://github.com/TanStack
 optional title: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:92](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L92)
+Defined in: [packages/typescript/ai/src/types.ts:93](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L93)
 
 ***
 
@@ -374,7 +374,7 @@ Defined in: [packages/typescript/ai/src/types.ts:92](https://github.com/TanStack
 optional type: string | string[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:57](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L57)
+Defined in: [packages/typescript/ai/src/types.ts:58](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L58)
 
 ***
 
@@ -384,4 +384,4 @@ Defined in: [packages/typescript/ai/src/types.ts:57](https://github.com/TanStack
 optional uniqueItems: boolean;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:85](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L85)
+Defined in: [packages/typescript/ai/src/types.ts:86](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L86)
diff --git a/docs/reference/interfaces/MessagesSnapshotEvent.md b/docs/reference/interfaces/MessagesSnapshotEvent.md
index a335df929..28c23743f 100644
--- a/docs/reference/interfaces/MessagesSnapshotEvent.md
+++ b/docs/reference/interfaces/MessagesSnapshotEvent.md
@@ -5,7 +5,7 @@ title: MessagesSnapshotEvent
 
 # Interface: MessagesSnapshotEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1107](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1107)
+Defined in: [packages/typescript/ai/src/types.ts:1108](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1108)
 
 Emitted to provide a snapshot of all messages in a conversation.
 
@@ -36,6 +36,6 @@ Use converters to transform to/from TanStack UIMessage format.
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1109](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1109)
+Defined in: [packages/typescript/ai/src/types.ts:1110](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1110)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/ModelMessage.md b/docs/reference/interfaces/ModelMessage.md
index 2020904c7..15f4a4e43 100644
--- a/docs/reference/interfaces/ModelMessage.md
+++ b/docs/reference/interfaces/ModelMessage.md
@@ -5,7 +5,7 @@ title: ModelMessage
 
 # Interface: ModelMessage\<TContent\>
 
-Defined in: [packages/typescript/ai/src/types.ts:312](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L312)
+Defined in: [packages/typescript/ai/src/types.ts:313](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L313)
 
 ## Type Parameters
 
@@ -21,7 +21,7 @@ Defined in: [packages/typescript/ai/src/types.ts:312](https://github.com/TanStac
 content: TContent;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:319](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L319)
+Defined in: [packages/typescript/ai/src/types.ts:320](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L320)
 
 ***
 
@@ -31,7 +31,7 @@ Defined in: [packages/typescript/ai/src/types.ts:319](https://github.com/TanStac
 optional name: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:320](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L320)
+Defined in: [packages/typescript/ai/src/types.ts:321](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L321)
 
 ***
 
@@ -41,7 +41,7 @@ Defined in: [packages/typescript/ai/src/types.ts:320](https://github.com/TanStac
 role: "user" | "assistant" | "tool";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:318](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L318)
+Defined in: [packages/typescript/ai/src/types.ts:319](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L319)
 
 ***
 
@@ -51,7 +51,7 @@ Defined in: [packages/typescript/ai/src/types.ts:318](https://github.com/TanStac
 optional thinking: object[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:323](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L323)
+Defined in: [packages/typescript/ai/src/types.ts:324](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L324)
 
 #### content
 
@@ -73,7 +73,7 @@ optional signature: string;
 optional toolCallId: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:322](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L322)
+Defined in: [packages/typescript/ai/src/types.ts:323](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L323)
 
 ***
 
@@ -83,4 +83,4 @@ Defined in: [packages/typescript/ai/src/types.ts:322](https://github.com/TanStac
 optional toolCalls: ToolCall<unknown>[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:321](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L321)
+Defined in: [packages/typescript/ai/src/types.ts:322](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L322)
diff --git a/docs/reference/interfaces/ProviderTool.md b/docs/reference/interfaces/ProviderTool.md
index a257fcf77..7034dd9f2 100644
--- a/docs/reference/interfaces/ProviderTool.md
+++ b/docs/reference/interfaces/ProviderTool.md
@@ -65,7 +65,7 @@ Defined in: [packages/typescript/ai/src/tools/provider-tool.ts:24](https://githu
 description: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:509](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L509)
+Defined in: [packages/typescript/ai/src/types.ts:510](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L510)
 
 Clear description of what the tool does.
 
@@ -90,7 +90,7 @@ Be specific about what the tool does, what parameters it needs, and what it retu
 optional execute: (args, context?) => any;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:589](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L589)
+Defined in: [packages/typescript/ai/src/types.ts:590](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L590)
 
 Optional function to execute when the model calls this tool.
 
@@ -138,7 +138,7 @@ execute: async (args) => {
 optional inputSchema: SchemaInput;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:549](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L549)
+Defined in: [packages/typescript/ai/src/types.ts:550](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L550)
 
 Schema describing the tool's input parameters.
 
@@ -196,7 +196,7 @@ type({
 optional lazy: boolean;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:597](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L597)
+Defined in: [packages/typescript/ai/src/types.ts:598](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L598)
 
 If true, this tool is lazy and will only be sent to the LLM after being discovered via the lazy tool discovery mechanism. Only meaningful when used with chat().
 
@@ -212,7 +212,7 @@ If true, this tool is lazy and will only be sent to the LLM after being discover
 optional metadata: Record<string, any>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:600](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L600)
+Defined in: [packages/typescript/ai/src/types.ts:601](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L601)
 
 Additional metadata for adapters or custom extensions
 
@@ -228,7 +228,7 @@ Additional metadata for adapters or custom extensions
 name: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:499](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L499)
+Defined in: [packages/typescript/ai/src/types.ts:500](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L500)
 
 Unique name of the tool (used by the model to call it).
 
@@ -253,7 +253,7 @@ Must be unique within the tools array.
 optional needsApproval: boolean;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:594](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L594)
+Defined in: [packages/typescript/ai/src/types.ts:595](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L595)
 
 If true, tool execution requires user approval before running. Works with both server and client tools.
 
@@ -269,7 +269,7 @@ If true, tool execution requires user approval before running. Works with both s
 optional outputSchema: SchemaInput;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:570](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L570)
+Defined in: [packages/typescript/ai/src/types.ts:571](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L571)
 
 Optional schema for validating tool output.
 
diff --git a/docs/reference/interfaces/ReasoningEncryptedValueEvent.md b/docs/reference/interfaces/ReasoningEncryptedValueEvent.md
index c5d32cba8..b96ae838f 100644
--- a/docs/reference/interfaces/ReasoningEncryptedValueEvent.md
+++ b/docs/reference/interfaces/ReasoningEncryptedValueEvent.md
@@ -5,7 +5,7 @@ title: ReasoningEncryptedValueEvent
 
 # Interface: ReasoningEncryptedValueEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1323](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1323)
+Defined in: [packages/typescript/ai/src/types.ts:1324](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1324)
 
 Emitted for encrypted reasoning values.
 
@@ -30,6 +30,6 @@ TanStack AI adds: `model?`
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1325](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1325)
+Defined in: [packages/typescript/ai/src/types.ts:1326](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1326)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/ReasoningEndEvent.md b/docs/reference/interfaces/ReasoningEndEvent.md
index a1b8d96fb..5492c9858 100644
--- a/docs/reference/interfaces/ReasoningEndEvent.md
+++ b/docs/reference/interfaces/ReasoningEndEvent.md
@@ -5,7 +5,7 @@ title: ReasoningEndEvent
 
 # Interface: ReasoningEndEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1312](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1312)
+Defined in: [packages/typescript/ai/src/types.ts:1313](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1313)
 
 Emitted when reasoning ends for a message.
 
@@ -30,6 +30,6 @@ TanStack AI adds: `model?`
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1314](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1314)
+Defined in: [packages/typescript/ai/src/types.ts:1315](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1315)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/ReasoningMessageContentEvent.md b/docs/reference/interfaces/ReasoningMessageContentEvent.md
index e66f0de99..45d1c5a87 100644
--- a/docs/reference/interfaces/ReasoningMessageContentEvent.md
+++ b/docs/reference/interfaces/ReasoningMessageContentEvent.md
@@ -5,7 +5,7 @@ title: ReasoningMessageContentEvent
 
 # Interface: ReasoningMessageContentEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1290](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1290)
+Defined in: [packages/typescript/ai/src/types.ts:1291](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1291)
 
 Emitted when reasoning message content is generated.
 
@@ -30,6 +30,6 @@ TanStack AI adds: `model?`
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1292](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1292)
+Defined in: [packages/typescript/ai/src/types.ts:1293](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1293)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/ReasoningMessageEndEvent.md b/docs/reference/interfaces/ReasoningMessageEndEvent.md
index 5c4661c31..3607a4b18 100644
--- a/docs/reference/interfaces/ReasoningMessageEndEvent.md
+++ b/docs/reference/interfaces/ReasoningMessageEndEvent.md
@@ -5,7 +5,7 @@ title: ReasoningMessageEndEvent
 
 # Interface: ReasoningMessageEndEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1301](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1301)
+Defined in: [packages/typescript/ai/src/types.ts:1302](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1302)
 
 Emitted when a reasoning message ends.
 
@@ -30,6 +30,6 @@ TanStack AI adds: `model?`
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1303](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1303)
+Defined in: [packages/typescript/ai/src/types.ts:1304](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1304)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/ReasoningMessageStartEvent.md b/docs/reference/interfaces/ReasoningMessageStartEvent.md
index 46c58f7b2..8fbeb2ef6 100644
--- a/docs/reference/interfaces/ReasoningMessageStartEvent.md
+++ b/docs/reference/interfaces/ReasoningMessageStartEvent.md
@@ -5,7 +5,7 @@ title: ReasoningMessageStartEvent
 
 # Interface: ReasoningMessageStartEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1279](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1279)
+Defined in: [packages/typescript/ai/src/types.ts:1280](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1280)
 
 Emitted when a reasoning message starts.
 
@@ -30,6 +30,6 @@ TanStack AI adds: `model?`
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1281](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1281)
+Defined in: [packages/typescript/ai/src/types.ts:1282](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1282)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/ReasoningStartEvent.md b/docs/reference/interfaces/ReasoningStartEvent.md
index e38c2ddd1..e39647ca0 100644
--- a/docs/reference/interfaces/ReasoningStartEvent.md
+++ b/docs/reference/interfaces/ReasoningStartEvent.md
@@ -5,7 +5,7 @@ title: ReasoningStartEvent
 
 # Interface: ReasoningStartEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1268](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1268)
+Defined in: [packages/typescript/ai/src/types.ts:1269](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1269)
 
 Emitted when reasoning starts for a message.
 
@@ -30,6 +30,6 @@ TanStack AI adds: `model?`
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1270](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1270)
+Defined in: [packages/typescript/ai/src/types.ts:1271](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1271)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/ResponseFormat.md b/docs/reference/interfaces/ResponseFormat.md
index 98650721d..4c0ad5010 100644
--- a/docs/reference/interfaces/ResponseFormat.md
+++ b/docs/reference/interfaces/ResponseFormat.md
@@ -5,7 +5,7 @@ title: ResponseFormat
 
 # Interface: ResponseFormat\<TData\>
 
-Defined in: [packages/typescript/ai/src/types.ts:618](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L618)
+Defined in: [packages/typescript/ai/src/types.ts:619](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L619)
 
 Structured output format specification.
 
@@ -33,7 +33,7 @@ TypeScript type of the expected data structure (for type safety)
 optional __data: TData;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:696](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L696)
+Defined in: [packages/typescript/ai/src/types.ts:697](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L697)
 
 **`Internal`**
 
@@ -50,7 +50,7 @@ Allows the SDK to know what type to expect when parsing the response.
 optional json_schema: object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:635](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L635)
+Defined in: [packages/typescript/ai/src/types.ts:636](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L636)
 
 JSON schema specification (required when type is "json_schema").
 
@@ -139,7 +139,7 @@ https://platform.openai.com/docs/guides/structured-outputs#strict-mode
 type: "json_object" | "json_schema";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:627](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L627)
+Defined in: [packages/typescript/ai/src/types.ts:628](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L628)
 
 Type of structured output.
 
diff --git a/docs/reference/interfaces/RunErrorEvent.md b/docs/reference/interfaces/RunErrorEvent.md
index 983527687..4d03019ee 100644
--- a/docs/reference/interfaces/RunErrorEvent.md
+++ b/docs/reference/interfaces/RunErrorEvent.md
@@ -5,7 +5,7 @@ title: RunErrorEvent
 
 # Interface: RunErrorEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:936](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L936)
+Defined in: [packages/typescript/ai/src/types.ts:937](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L937)
 
 Emitted when an error occurs during a run.
 
@@ -30,7 +30,7 @@ TanStack AI adds: `model?`, `error?` (deprecated nested form)
 optional error: object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:943](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L943)
+Defined in: [packages/typescript/ai/src/types.ts:944](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L944)
 
 #### ~~code?~~
 
@@ -57,6 +57,6 @@ Kept for backward compatibility.
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:938](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L938)
+Defined in: [packages/typescript/ai/src/types.ts:939](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L939)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/RunFinishedEvent.md b/docs/reference/interfaces/RunFinishedEvent.md
index 1396492fb..a51c86978 100644
--- a/docs/reference/interfaces/RunFinishedEvent.md
+++ b/docs/reference/interfaces/RunFinishedEvent.md
@@ -5,7 +5,7 @@ title: RunFinishedEvent
 
 # Interface: RunFinishedEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:917](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L917)
+Defined in: [packages/typescript/ai/src/types.ts:918](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L918)
 
 Emitted when a run completes successfully.
 
@@ -30,7 +30,7 @@ TanStack AI adds: `model?`, `finishReason?`, `usage?`
 optional finishReason: "length" | "stop" | "content_filter" | "tool_calls" | null;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:921](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L921)
+Defined in: [packages/typescript/ai/src/types.ts:922](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L922)
 
 Why the generation stopped
 
@@ -42,7 +42,7 @@ Why the generation stopped
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:919](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L919)
+Defined in: [packages/typescript/ai/src/types.ts:920](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L920)
 
 Model identifier for multi-model support
 
@@ -54,7 +54,7 @@ Model identifier for multi-model support
 optional usage: object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:923](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L923)
+Defined in: [packages/typescript/ai/src/types.ts:924](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L924)
 
 Token usage statistics
 
diff --git a/docs/reference/interfaces/RunStartedEvent.md b/docs/reference/interfaces/RunStartedEvent.md
index d3b774b01..a5ef6fbf4 100644
--- a/docs/reference/interfaces/RunStartedEvent.md
+++ b/docs/reference/interfaces/RunStartedEvent.md
@@ -5,7 +5,7 @@ title: RunStartedEvent
 
 # Interface: RunStartedEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:906](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L906)
+Defined in: [packages/typescript/ai/src/types.ts:907](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L907)
 
 Emitted when a run starts.
 This is the first event in any streaming response.
@@ -31,6 +31,6 @@ TanStack AI adds: `model?`
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:908](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L908)
+Defined in: [packages/typescript/ai/src/types.ts:909](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L909)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/ServerTool.md b/docs/reference/interfaces/ServerTool.md
index 8471b6eb6..85a515872 100644
--- a/docs/reference/interfaces/ServerTool.md
+++ b/docs/reference/interfaces/ServerTool.md
@@ -45,7 +45,7 @@ Defined in: [packages/typescript/ai/src/activities/chat/tools/tool-definition.ts
 description: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:509](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L509)
+Defined in: [packages/typescript/ai/src/types.ts:510](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L510)
 
 Clear description of what the tool does.
 
@@ -70,7 +70,7 @@ Be specific about what the tool does, what parameters it needs, and what it retu
 optional execute: (args, context?) => any;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:589](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L589)
+Defined in: [packages/typescript/ai/src/types.ts:590](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L590)
 
 Optional function to execute when the model calls this tool.
 
@@ -118,7 +118,7 @@ execute: async (args) => {
 optional inputSchema: TInput;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:549](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L549)
+Defined in: [packages/typescript/ai/src/types.ts:550](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L550)
 
 Schema describing the tool's input parameters.
 
@@ -176,7 +176,7 @@ type({
 optional lazy: boolean;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:597](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L597)
+Defined in: [packages/typescript/ai/src/types.ts:598](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L598)
 
 If true, this tool is lazy and will only be sent to the LLM after being discovered via the lazy tool discovery mechanism. Only meaningful when used with chat().
 
@@ -192,7 +192,7 @@ If true, this tool is lazy and will only be sent to the LLM after being discover
 optional metadata: Record<string, any>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:600](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L600)
+Defined in: [packages/typescript/ai/src/types.ts:601](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L601)
 
 Additional metadata for adapters or custom extensions
 
@@ -208,7 +208,7 @@ Additional metadata for adapters or custom extensions
 name: TName;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:499](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L499)
+Defined in: [packages/typescript/ai/src/types.ts:500](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L500)
 
 Unique name of the tool (used by the model to call it).
 
@@ -233,7 +233,7 @@ Must be unique within the tools array.
 optional needsApproval: boolean;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:594](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L594)
+Defined in: [packages/typescript/ai/src/types.ts:595](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L595)
 
 If true, tool execution requires user approval before running. Works with both server and client tools.
 
@@ -249,7 +249,7 @@ If true, tool execution requires user approval before running. Works with both s
 optional outputSchema: TOutput;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:570](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L570)
+Defined in: [packages/typescript/ai/src/types.ts:571](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L571)
 
 Optional schema for validating tool output.
 
diff --git a/docs/reference/interfaces/StateDeltaEvent.md b/docs/reference/interfaces/StateDeltaEvent.md
index fccf0d948..5c7e0aeb2 100644
--- a/docs/reference/interfaces/StateDeltaEvent.md
+++ b/docs/reference/interfaces/StateDeltaEvent.md
@@ -5,7 +5,7 @@ title: StateDeltaEvent
 
 # Interface: StateDeltaEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1134](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1134)
+Defined in: [packages/typescript/ai/src/types.ts:1135](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1135)
 
 Emitted to provide an incremental state update.
 
@@ -30,6 +30,6 @@ TanStack AI adds: `model?`
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1136](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1136)
+Defined in: [packages/typescript/ai/src/types.ts:1137](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1137)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/StateSnapshotEvent.md b/docs/reference/interfaces/StateSnapshotEvent.md
index 98e82878e..a6af812bc 100644
--- a/docs/reference/interfaces/StateSnapshotEvent.md
+++ b/docs/reference/interfaces/StateSnapshotEvent.md
@@ -5,7 +5,7 @@ title: StateSnapshotEvent
 
 # Interface: StateSnapshotEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1118](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1118)
+Defined in: [packages/typescript/ai/src/types.ts:1119](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1119)
 
 Emitted to provide a full state snapshot.
 
@@ -30,7 +30,7 @@ TanStack AI adds: `model?`, `state?` (deprecated alias for snapshot)
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1120](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1120)
+Defined in: [packages/typescript/ai/src/types.ts:1121](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1121)
 
 Model identifier for multi-model support
 
@@ -42,7 +42,7 @@ Model identifier for multi-model support
 optional state: Record<string, unknown>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1125](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1125)
+Defined in: [packages/typescript/ai/src/types.ts:1126](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1126)
 
 #### Deprecated
 
diff --git a/docs/reference/interfaces/StepFinishedEvent.md b/docs/reference/interfaces/StepFinishedEvent.md
index 5ca35ca04..111dcef4b 100644
--- a/docs/reference/interfaces/StepFinishedEvent.md
+++ b/docs/reference/interfaces/StepFinishedEvent.md
@@ -5,7 +5,7 @@ title: StepFinishedEvent
 
 # Interface: StepFinishedEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1079](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1079)
+Defined in: [packages/typescript/ai/src/types.ts:1080](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1080)
 
 Emitted when a thinking/reasoning step finishes.
 
@@ -30,7 +30,7 @@ TanStack AI adds: `model?`, `stepId?` (deprecated alias), `delta?`, `content?`
 optional content: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1090](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1090)
+Defined in: [packages/typescript/ai/src/types.ts:1091](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1091)
 
 Full accumulated thinking content (TanStack AI internal)
 
@@ -42,7 +42,7 @@ Full accumulated thinking content (TanStack AI internal)
 optional delta: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1088](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1088)
+Defined in: [packages/typescript/ai/src/types.ts:1089](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1089)
 
 Incremental thinking content (TanStack AI internal)
 
@@ -54,7 +54,7 @@ Incremental thinking content (TanStack AI internal)
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1081](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1081)
+Defined in: [packages/typescript/ai/src/types.ts:1082](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1082)
 
 Model identifier for multi-model support
 
@@ -66,7 +66,7 @@ Model identifier for multi-model support
 optional signature: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1092](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1092)
+Defined in: [packages/typescript/ai/src/types.ts:1093](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1093)
 
 Provider signature for the thinking block
 
@@ -78,7 +78,7 @@ Provider signature for the thinking block
 optional stepId: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1086](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1086)
+Defined in: [packages/typescript/ai/src/types.ts:1087](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1087)
 
 #### Deprecated
 
diff --git a/docs/reference/interfaces/StepStartedEvent.md b/docs/reference/interfaces/StepStartedEvent.md
index 629459f66..a701d2ed2 100644
--- a/docs/reference/interfaces/StepStartedEvent.md
+++ b/docs/reference/interfaces/StepStartedEvent.md
@@ -5,7 +5,7 @@ title: StepStartedEvent
 
 # Interface: StepStartedEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1061](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1061)
+Defined in: [packages/typescript/ai/src/types.ts:1062](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1062)
 
 Emitted when a thinking/reasoning step starts.
 
@@ -30,7 +30,7 @@ TanStack AI adds: `model?`, `stepId?` (deprecated alias), `stepType?`
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1063](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1063)
+Defined in: [packages/typescript/ai/src/types.ts:1064](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1064)
 
 Model identifier for multi-model support
 
@@ -42,7 +42,7 @@ Model identifier for multi-model support
 optional stepId: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1068](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1068)
+Defined in: [packages/typescript/ai/src/types.ts:1069](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1069)
 
 #### Deprecated
 
@@ -57,6 +57,6 @@ Kept for backward compatibility.
 optional stepType: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1070](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1070)
+Defined in: [packages/typescript/ai/src/types.ts:1071](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1071)
 
 Type of step (e.g., 'thinking', 'planning')
diff --git a/docs/reference/interfaces/StructuredOutputCompleteEvent.md b/docs/reference/interfaces/StructuredOutputCompleteEvent.md
index 7f7b28398..9470572a4 100644
--- a/docs/reference/interfaces/StructuredOutputCompleteEvent.md
+++ b/docs/reference/interfaces/StructuredOutputCompleteEvent.md
@@ -5,7 +5,7 @@ title: StructuredOutputCompleteEvent
 
 # Interface: StructuredOutputCompleteEvent\<T\>
 
-Defined in: [packages/typescript/ai/src/types.ts:1168](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1168)
+Defined in: [packages/typescript/ai/src/types.ts:1169](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1169)
 
 Final event of a streaming structured-output run. Carries the validated
 `object` (typed as `T` after the orchestrator runs Standard Schema parsing),
@@ -48,7 +48,7 @@ if (chunk.type === 'CUSTOM' && chunk.name === 'structured-output.complete') {
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1147](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1147)
+Defined in: [packages/typescript/ai/src/types.ts:1148](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1148)
 
 Model identifier for multi-model support
 
@@ -64,7 +64,7 @@ Model identifier for multi-model support
 name: "structured-output.complete";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1171](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1171)
+Defined in: [packages/typescript/ai/src/types.ts:1172](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1172)
 
 #### Overrides
 
@@ -80,7 +80,7 @@ CustomEvent.name
 value: object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1172](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1172)
+Defined in: [packages/typescript/ai/src/types.ts:1173](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1173)
 
 #### object
 
diff --git a/docs/reference/interfaces/StructuredOutputPart.md b/docs/reference/interfaces/StructuredOutputPart.md
index feebc7b6d..926c1b4e3 100644
--- a/docs/reference/interfaces/StructuredOutputPart.md
+++ b/docs/reference/interfaces/StructuredOutputPart.md
@@ -5,7 +5,7 @@ title: StructuredOutputPart
 
 # Interface: StructuredOutputPart\<TData\>
 
-Defined in: [packages/typescript/ai/src/types.ts:390](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L390)
+Defined in: [packages/typescript/ai/src/types.ts:391](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L391)
 
 StructuredOutputPart — a typed structured response attached to the assistant
 message that produced it. Generic over the schema-inferred data type so
@@ -27,7 +27,7 @@ to `messages[i].parts[j].data`. Defaults to `unknown` so untyped consumers
 optional data: TData;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:396](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L396)
+Defined in: [packages/typescript/ai/src/types.ts:397](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L397)
 
 Validated final object — only set when `status === 'complete'`.
 
@@ -39,7 +39,7 @@ Validated final object — only set when `status === 'complete'`.
 optional errorMessage: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:402](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L402)
+Defined in: [packages/typescript/ai/src/types.ts:403](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L403)
 
 Populated when `status === 'error'`.
 
@@ -51,7 +51,7 @@ Populated when `status === 'error'`.
 optional partial: DeepPartial<TData>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:394](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L394)
+Defined in: [packages/typescript/ai/src/types.ts:395](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L395)
 
 Progressive parse of `raw` via parsePartialJSON — populated while streaming and after complete.
 
@@ -63,7 +63,7 @@ Progressive parse of `raw` via parsePartialJSON — populated while streaming an
 raw: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:398](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L398)
+Defined in: [packages/typescript/ai/src/types.ts:399](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L399)
 
 Accumulating JSON buffer. Source of truth for wire round-trip.
 
@@ -75,7 +75,7 @@ Accumulating JSON buffer. Source of truth for wire round-trip.
 optional reasoning: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:400](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L400)
+Defined in: [packages/typescript/ai/src/types.ts:401](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L401)
 
 Optional chain-of-thought surfaced by reasoning models alongside the structured output.
 
@@ -84,10 +84,10 @@ Optional chain-of-thought surfaced by reasoning models alongside the structured
 ### status
 
 ```ts
-status: "error" | "streaming" | "complete";
+status: "error" | "complete" | "streaming";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:392](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L392)
+Defined in: [packages/typescript/ai/src/types.ts:393](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L393)
 
 ***
 
@@ -97,4 +97,4 @@ Defined in: [packages/typescript/ai/src/types.ts:392](https://github.com/TanStac
 type: "structured-output";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:391](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L391)
+Defined in: [packages/typescript/ai/src/types.ts:392](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L392)
diff --git a/docs/reference/interfaces/StructuredOutputStartEvent.md b/docs/reference/interfaces/StructuredOutputStartEvent.md
index f949533fe..19bb8134d 100644
--- a/docs/reference/interfaces/StructuredOutputStartEvent.md
+++ b/docs/reference/interfaces/StructuredOutputStartEvent.md
@@ -5,7 +5,7 @@ title: StructuredOutputStartEvent
 
 # Interface: StructuredOutputStartEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1183](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1183)
+Defined in: [packages/typescript/ai/src/types.ts:1184](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1184)
 
 Emitted at the start of a streaming structured-output run, before the JSON
 deltas. Tells consumers that the upcoming `TEXT_MESSAGE_CONTENT` deltas
@@ -32,7 +32,7 @@ made per-message rather than globally.
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1147](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1147)
+Defined in: [packages/typescript/ai/src/types.ts:1148](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1148)
 
 Model identifier for multi-model support
 
@@ -48,7 +48,7 @@ Model identifier for multi-model support
 name: "structured-output.start";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1184](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1184)
+Defined in: [packages/typescript/ai/src/types.ts:1185](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1185)
 
 #### Overrides
 
@@ -64,7 +64,7 @@ CustomEvent.name
 value: object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1185](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1185)
+Defined in: [packages/typescript/ai/src/types.ts:1186](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1186)
 
 #### messageId
 
diff --git a/docs/reference/interfaces/SummarizationOptions.md b/docs/reference/interfaces/SummarizationOptions.md
index 62036ec39..0c7e1ea37 100644
--- a/docs/reference/interfaces/SummarizationOptions.md
+++ b/docs/reference/interfaces/SummarizationOptions.md
@@ -5,7 +5,7 @@ title: SummarizationOptions
 
 # Interface: SummarizationOptions\<TProviderOptions\>
 
-Defined in: [packages/typescript/ai/src/types.ts:1380](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1380)
+Defined in: [packages/typescript/ai/src/types.ts:1381](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1381)
 
 ## Type Parameters
 
@@ -21,7 +21,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1380](https://github.com/TanSta
 optional focus: string[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1387](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1387)
+Defined in: [packages/typescript/ai/src/types.ts:1388](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1388)
 
 ***
 
@@ -31,7 +31,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1387](https://github.com/TanSta
 logger: InternalLogger;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1394](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1394)
+Defined in: [packages/typescript/ai/src/types.ts:1395](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1395)
 
 Internal logger threaded from the summarize() entry point. Adapters must
 call logger.request() before the SDK call and logger.errors() in catch blocks.
@@ -44,7 +44,7 @@ call logger.request() before the SDK call and logger.errors() in catch blocks.
 optional maxLength: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1385](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1385)
+Defined in: [packages/typescript/ai/src/types.ts:1386](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1386)
 
 ***
 
@@ -54,7 +54,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1385](https://github.com/TanSta
 model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1383](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1383)
+Defined in: [packages/typescript/ai/src/types.ts:1384](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1384)
 
 ***
 
@@ -64,7 +64,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1383](https://github.com/TanSta
 optional modelOptions: TProviderOptions;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1389](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1389)
+Defined in: [packages/typescript/ai/src/types.ts:1390](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1390)
 
 Provider-specific options forwarded by the summarize() activity.
 
@@ -76,7 +76,7 @@ Provider-specific options forwarded by the summarize() activity.
 optional style: "bullet-points" | "paragraph" | "concise";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1386](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1386)
+Defined in: [packages/typescript/ai/src/types.ts:1387](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1387)
 
 ***
 
@@ -86,4 +86,4 @@ Defined in: [packages/typescript/ai/src/types.ts:1386](https://github.com/TanSta
 text: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1384](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1384)
+Defined in: [packages/typescript/ai/src/types.ts:1385](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1385)
diff --git a/docs/reference/interfaces/SummarizationResult.md b/docs/reference/interfaces/SummarizationResult.md
index ba2ab6718..7d48b8ec0 100644
--- a/docs/reference/interfaces/SummarizationResult.md
+++ b/docs/reference/interfaces/SummarizationResult.md
@@ -5,7 +5,7 @@ title: SummarizationResult
 
 # Interface: SummarizationResult
 
-Defined in: [packages/typescript/ai/src/types.ts:1397](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1397)
+Defined in: [packages/typescript/ai/src/types.ts:1398](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1398)
 
 ## Properties
 
@@ -15,7 +15,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1397](https://github.com/TanSta
 id: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1398](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1398)
+Defined in: [packages/typescript/ai/src/types.ts:1399](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1399)
 
 ***
 
@@ -25,7 +25,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1398](https://github.com/TanSta
 model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1399](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1399)
+Defined in: [packages/typescript/ai/src/types.ts:1400](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1400)
 
 ***
 
@@ -35,7 +35,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1399](https://github.com/TanSta
 summary: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1400](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1400)
+Defined in: [packages/typescript/ai/src/types.ts:1401](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1401)
 
 ***
 
@@ -45,7 +45,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1400](https://github.com/TanSta
 usage: object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1401](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1401)
+Defined in: [packages/typescript/ai/src/types.ts:1402](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1402)
 
 #### completionTokens
 
diff --git a/docs/reference/interfaces/TTSOptions.md b/docs/reference/interfaces/TTSOptions.md
index 59352a580..1cd054cf1 100644
--- a/docs/reference/interfaces/TTSOptions.md
+++ b/docs/reference/interfaces/TTSOptions.md
@@ -5,7 +5,7 @@ title: TTSOptions
 
 # Interface: TTSOptions\<TProviderOptions\>
 
-Defined in: [packages/typescript/ai/src/types.ts:1617](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1617)
+Defined in: [packages/typescript/ai/src/types.ts:1618](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1618)
 
 Options for text-to-speech generation.
 These are the common options supported across providers.
@@ -24,7 +24,7 @@ These are the common options supported across providers.
 optional format: "mp3" | "opus" | "aac" | "flac" | "wav" | "pcm";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1625](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1625)
+Defined in: [packages/typescript/ai/src/types.ts:1626](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1626)
 
 The output audio format
 
@@ -36,7 +36,7 @@ The output audio format
 logger: InternalLogger;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1635](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1635)
+Defined in: [packages/typescript/ai/src/types.ts:1636](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1636)
 
 Internal logger threaded from the generateSpeech() entry point. Adapters
 must call logger.request() before the SDK call and logger.errors() in
@@ -50,7 +50,7 @@ catch blocks.
 model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1619](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1619)
+Defined in: [packages/typescript/ai/src/types.ts:1620](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1620)
 
 The model to use for TTS generation
 
@@ -62,7 +62,7 @@ The model to use for TTS generation
 optional modelOptions: TProviderOptions;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1629](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1629)
+Defined in: [packages/typescript/ai/src/types.ts:1630](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1630)
 
 Model-specific options for TTS generation
 
@@ -74,7 +74,7 @@ Model-specific options for TTS generation
 optional speed: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1627](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1627)
+Defined in: [packages/typescript/ai/src/types.ts:1628](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1628)
 
 The speed of the generated audio (0.25 to 4.0)
 
@@ -86,7 +86,7 @@ The speed of the generated audio (0.25 to 4.0)
 text: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1621](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1621)
+Defined in: [packages/typescript/ai/src/types.ts:1622](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1622)
 
 The text to convert to speech
 
@@ -98,6 +98,6 @@ The text to convert to speech
 optional voice: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1623](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1623)
+Defined in: [packages/typescript/ai/src/types.ts:1624](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1624)
 
 The voice to use for generation
diff --git a/docs/reference/interfaces/TTSResult.md b/docs/reference/interfaces/TTSResult.md
index 16834a09e..d80ad7010 100644
--- a/docs/reference/interfaces/TTSResult.md
+++ b/docs/reference/interfaces/TTSResult.md
@@ -5,7 +5,7 @@ title: TTSResult
 
 # Interface: TTSResult
 
-Defined in: [packages/typescript/ai/src/types.ts:1641](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1641)
+Defined in: [packages/typescript/ai/src/types.ts:1642](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1642)
 
 Result of text-to-speech generation.
 
@@ -17,7 +17,7 @@ Result of text-to-speech generation.
 audio: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1647](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1647)
+Defined in: [packages/typescript/ai/src/types.ts:1648](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1648)
 
 Base64-encoded audio data
 
@@ -29,7 +29,7 @@ Base64-encoded audio data
 optional contentType: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1653](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1653)
+Defined in: [packages/typescript/ai/src/types.ts:1654](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1654)
 
 Content type of the audio (e.g., 'audio/mp3')
 
@@ -41,7 +41,7 @@ Content type of the audio (e.g., 'audio/mp3')
 optional duration: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1651](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1651)
+Defined in: [packages/typescript/ai/src/types.ts:1652](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1652)
 
 Duration of the audio in seconds, if available
 
@@ -53,7 +53,7 @@ Duration of the audio in seconds, if available
 format: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1649](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1649)
+Defined in: [packages/typescript/ai/src/types.ts:1650](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1650)
 
 Audio format of the generated audio
 
@@ -65,7 +65,7 @@ Audio format of the generated audio
 id: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1643](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1643)
+Defined in: [packages/typescript/ai/src/types.ts:1644](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1644)
 
 Unique identifier for the generation
 
@@ -77,6 +77,6 @@ Unique identifier for the generation
 model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1645](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1645)
+Defined in: [packages/typescript/ai/src/types.ts:1646](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1646)
 
 Model used for generation
diff --git a/docs/reference/interfaces/TextCompletionChunk.md b/docs/reference/interfaces/TextCompletionChunk.md
index 0ff40f268..8168ef0dd 100644
--- a/docs/reference/interfaces/TextCompletionChunk.md
+++ b/docs/reference/interfaces/TextCompletionChunk.md
@@ -5,7 +5,7 @@ title: TextCompletionChunk
 
 # Interface: TextCompletionChunk
 
-Defined in: [packages/typescript/ai/src/types.ts:1367](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1367)
+Defined in: [packages/typescript/ai/src/types.ts:1368](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1368)
 
 ## Properties
 
@@ -15,7 +15,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1367](https://github.com/TanSta
 content: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1370](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1370)
+Defined in: [packages/typescript/ai/src/types.ts:1371](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1371)
 
 ***
 
@@ -25,7 +25,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1370](https://github.com/TanSta
 optional finishReason: "length" | "stop" | "content_filter" | null;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1372](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1372)
+Defined in: [packages/typescript/ai/src/types.ts:1373](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1373)
 
 ***
 
@@ -35,7 +35,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1372](https://github.com/TanSta
 id: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1368](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1368)
+Defined in: [packages/typescript/ai/src/types.ts:1369](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1369)
 
 ***
 
@@ -45,7 +45,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1368](https://github.com/TanSta
 model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1369](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1369)
+Defined in: [packages/typescript/ai/src/types.ts:1370](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1370)
 
 ***
 
@@ -55,7 +55,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1369](https://github.com/TanSta
 optional role: "assistant";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1371](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1371)
+Defined in: [packages/typescript/ai/src/types.ts:1372](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1372)
 
 ***
 
@@ -65,7 +65,7 @@ Defined in: [packages/typescript/ai/src/types.ts:1371](https://github.com/TanSta
 optional usage: object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1373](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1373)
+Defined in: [packages/typescript/ai/src/types.ts:1374](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1374)
 
 #### completionTokens
 
diff --git a/docs/reference/interfaces/TextMessageContentEvent.md b/docs/reference/interfaces/TextMessageContentEvent.md
index 07a937b9a..c2750cfe9 100644
--- a/docs/reference/interfaces/TextMessageContentEvent.md
+++ b/docs/reference/interfaces/TextMessageContentEvent.md
@@ -5,7 +5,7 @@ title: TextMessageContentEvent
 
 # Interface: TextMessageContentEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:968](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L968)
+Defined in: [packages/typescript/ai/src/types.ts:969](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L969)
 
 Emitted when text content is generated (streaming tokens).
 
@@ -30,7 +30,7 @@ TanStack AI adds: `model?`, `content?` (accumulated)
 optional content: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:972](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L972)
+Defined in: [packages/typescript/ai/src/types.ts:973](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L973)
 
 Full accumulated content so far (TanStack AI internal, for debugging)
 
@@ -42,6 +42,6 @@ Full accumulated content so far (TanStack AI internal, for debugging)
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:970](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L970)
+Defined in: [packages/typescript/ai/src/types.ts:971](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L971)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/TextMessageEndEvent.md b/docs/reference/interfaces/TextMessageEndEvent.md
index 548e619e5..89d23d341 100644
--- a/docs/reference/interfaces/TextMessageEndEvent.md
+++ b/docs/reference/interfaces/TextMessageEndEvent.md
@@ -5,7 +5,7 @@ title: TextMessageEndEvent
 
 # Interface: TextMessageEndEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:981](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L981)
+Defined in: [packages/typescript/ai/src/types.ts:982](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L982)
 
 Emitted when a text message completes.
 
@@ -30,6 +30,6 @@ TanStack AI adds: `model?`
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:983](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L983)
+Defined in: [packages/typescript/ai/src/types.ts:984](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L984)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/TextMessageStartEvent.md b/docs/reference/interfaces/TextMessageStartEvent.md
index ed0e38fb6..a32a9b957 100644
--- a/docs/reference/interfaces/TextMessageStartEvent.md
+++ b/docs/reference/interfaces/TextMessageStartEvent.md
@@ -5,7 +5,7 @@ title: TextMessageStartEvent
 
 # Interface: TextMessageStartEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:957](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L957)
+Defined in: [packages/typescript/ai/src/types.ts:958](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L958)
 
 Emitted when a text message starts.
 
@@ -30,6 +30,6 @@ TanStack AI adds: `model?`
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:959](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L959)
+Defined in: [packages/typescript/ai/src/types.ts:960](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L960)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/TextOptions.md b/docs/reference/interfaces/TextOptions.md
index b5d184e9d..e70fe0f20 100644
--- a/docs/reference/interfaces/TextOptions.md
+++ b/docs/reference/interfaces/TextOptions.md
@@ -5,7 +5,7 @@ title: TextOptions
 
 # Interface: TextOptions\<TProviderOptionsSuperset, TProviderOptionsForModel\>
 
-Defined in: [packages/typescript/ai/src/types.ts:728](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L728)
+Defined in: [packages/typescript/ai/src/types.ts:729](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L729)
 
 Options passed into the SDK and further piped to the AI provider.
 
@@ -27,7 +27,7 @@ Options passed into the SDK and further piped to the AI provider.
 optional abortController: AbortController;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:832](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L832)
+Defined in: [packages/typescript/ai/src/types.ts:833](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L833)
 
 AbortController for request cancellation.
 
@@ -54,7 +54,7 @@ https://developer.mozilla.org/en-US/docs/Web/API/AbortController
 optional agentLoopStrategy: AgentLoopStrategy;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:750](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L750)
+Defined in: [packages/typescript/ai/src/types.ts:751](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L751)
 
 ***
 
@@ -64,7 +64,7 @@ Defined in: [packages/typescript/ai/src/types.ts:750](https://github.com/TanStac
 optional conversationId: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:818](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L818)
+Defined in: [packages/typescript/ai/src/types.ts:819](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L819)
 
 #### Deprecated
 
@@ -85,7 +85,7 @@ Will be removed in a future major release.
 logger: InternalLogger;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:839](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L839)
+Defined in: [packages/typescript/ai/src/types.ts:840](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L840)
 
 Internal logger threaded from the chat entry point. Adapter implementations
 must call `logger.request()` before SDK calls, `logger.provider()` for each
@@ -99,7 +99,7 @@ chunk received, and `logger.errors()` in catch blocks.
 optional maxTokens: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:785](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L785)
+Defined in: [packages/typescript/ai/src/types.ts:786](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L786)
 
 The maximum number of tokens to generate in the response.
 
@@ -119,7 +119,7 @@ messages: ModelMessage<
   | null>[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:733](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L733)
+Defined in: [packages/typescript/ai/src/types.ts:734](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L734)
 
 ***
 
@@ -129,7 +129,7 @@ Defined in: [packages/typescript/ai/src/types.ts:733](https://github.com/TanStac
 optional metadata: Record<string, any>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:796](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L796)
+Defined in: [packages/typescript/ai/src/types.ts:797](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L797)
 
 Additional metadata to attach to the request.
 Can be used for tracking, debugging, or passing custom information.
@@ -148,7 +148,7 @@ Provider usage:
 model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:732](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L732)
+Defined in: [packages/typescript/ai/src/types.ts:733](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L733)
 
 ***
 
@@ -158,7 +158,7 @@ Defined in: [packages/typescript/ai/src/types.ts:732](https://github.com/TanStac
 optional modelOptions: TProviderOptionsForModel;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:797](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L797)
+Defined in: [packages/typescript/ai/src/types.ts:798](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L798)
 
 ***
 
@@ -168,7 +168,7 @@ Defined in: [packages/typescript/ai/src/types.ts:797](https://github.com/TanStac
 optional outputSchema: SchemaInput;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:807](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L807)
+Defined in: [packages/typescript/ai/src/types.ts:808](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L808)
 
 Schema for structured output.
 When provided, the adapter should use the provider's native structured output API
@@ -184,7 +184,7 @@ Supports any Standard JSON Schema compliant library (Zod, ArkType, Valibot, etc.
 optional parentRunId: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:856](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L856)
+Defined in: [packages/typescript/ai/src/types.ts:857](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L857)
 
 Parent run ID for AG-UI protocol nested run correlation.
 Surfaced for observability/middleware; not consumed by the LLM call.
@@ -197,7 +197,7 @@ Surfaced for observability/middleware; not consumed by the LLM call.
 optional request: Request | RequestInit;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:798](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L798)
+Defined in: [packages/typescript/ai/src/types.ts:799](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L799)
 
 ***
 
@@ -207,7 +207,7 @@ Defined in: [packages/typescript/ai/src/types.ts:798](https://github.com/TanStac
 optional runId: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:851](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L851)
+Defined in: [packages/typescript/ai/src/types.ts:852](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L852)
 
 Run ID for AG-UI protocol run correlation.
 When provided, this will be used in RunStartedEvent and RunFinishedEvent.
@@ -221,7 +221,7 @@ If not provided, a unique ID will be generated.
 optional systemPrompts: SystemPrompt[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:749](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L749)
+Defined in: [packages/typescript/ai/src/types.ts:750](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L750)
 
 System prompts to include with the request.
 
@@ -246,7 +246,7 @@ SystemPrompt
 optional temperature: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:763](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L763)
+Defined in: [packages/typescript/ai/src/types.ts:764](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L764)
 
 Controls the randomness of the output.
 Higher values (e.g., 0.8) make output more random, lower values (e.g., 0.2) make it more focused and deterministic.
@@ -267,7 +267,7 @@ Provider usage:
 optional threadId: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:845](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L845)
+Defined in: [packages/typescript/ai/src/types.ts:846](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L846)
 
 Thread ID for AG-UI protocol run correlation.
 When provided, this will be used in RunStartedEvent and RunFinishedEvent.
@@ -280,7 +280,7 @@ When provided, this will be used in RunStartedEvent and RunFinishedEvent.
 optional tools: Tool<any, any, any>[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:734](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L734)
+Defined in: [packages/typescript/ai/src/types.ts:735](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L735)
 
 ***
 
@@ -290,7 +290,7 @@ Defined in: [packages/typescript/ai/src/types.ts:734](https://github.com/TanStac
 optional topP: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:776](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L776)
+Defined in: [packages/typescript/ai/src/types.ts:777](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L777)
 
 Nucleus sampling parameter. An alternative to temperature sampling.
 The model considers the results of tokens with topP probability mass.
diff --git a/docs/reference/interfaces/TextPart.md b/docs/reference/interfaces/TextPart.md
index 4e530b355..c97cde6de 100644
--- a/docs/reference/interfaces/TextPart.md
+++ b/docs/reference/interfaces/TextPart.md
@@ -5,7 +5,7 @@ title: TextPart
 
 # Interface: TextPart\<TMetadata\>
 
-Defined in: [packages/typescript/ai/src/types.ts:329](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L329)
+Defined in: [packages/typescript/ai/src/types.ts:330](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L330)
 
 Message parts - building blocks of UIMessage
 
@@ -23,7 +23,7 @@ Message parts - building blocks of UIMessage
 content: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:331](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L331)
+Defined in: [packages/typescript/ai/src/types.ts:332](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L332)
 
 ***
 
@@ -33,7 +33,7 @@ Defined in: [packages/typescript/ai/src/types.ts:331](https://github.com/TanStac
 optional metadata: TMetadata;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:332](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L332)
+Defined in: [packages/typescript/ai/src/types.ts:333](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L333)
 
 ***
 
@@ -43,4 +43,4 @@ Defined in: [packages/typescript/ai/src/types.ts:332](https://github.com/TanStac
 type: "text";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:330](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L330)
+Defined in: [packages/typescript/ai/src/types.ts:331](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L331)
diff --git a/docs/reference/interfaces/ThinkingPart.md b/docs/reference/interfaces/ThinkingPart.md
index 8973001bd..8a1907571 100644
--- a/docs/reference/interfaces/ThinkingPart.md
+++ b/docs/reference/interfaces/ThinkingPart.md
@@ -5,7 +5,7 @@ title: ThinkingPart
 
 # Interface: ThinkingPart
 
-Defined in: [packages/typescript/ai/src/types.ts:362](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L362)
+Defined in: [packages/typescript/ai/src/types.ts:363](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L363)
 
 ## Properties
 
@@ -15,7 +15,7 @@ Defined in: [packages/typescript/ai/src/types.ts:362](https://github.com/TanStac
 content: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:364](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L364)
+Defined in: [packages/typescript/ai/src/types.ts:365](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L365)
 
 ***
 
@@ -25,7 +25,7 @@ Defined in: [packages/typescript/ai/src/types.ts:364](https://github.com/TanStac
 optional signature: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:366](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L366)
+Defined in: [packages/typescript/ai/src/types.ts:367](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L367)
 
 ***
 
@@ -35,7 +35,7 @@ Defined in: [packages/typescript/ai/src/types.ts:366](https://github.com/TanStac
 optional stepId: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:365](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L365)
+Defined in: [packages/typescript/ai/src/types.ts:366](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L366)
 
 ***
 
@@ -45,4 +45,4 @@ Defined in: [packages/typescript/ai/src/types.ts:365](https://github.com/TanStac
 type: "thinking";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:363](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L363)
+Defined in: [packages/typescript/ai/src/types.ts:364](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L364)
diff --git a/docs/reference/interfaces/Tool.md b/docs/reference/interfaces/Tool.md
index 17a3a7277..b75a8ba7f 100644
--- a/docs/reference/interfaces/Tool.md
+++ b/docs/reference/interfaces/Tool.md
@@ -5,7 +5,7 @@ title: Tool
 
 # Interface: Tool\<TInput, TOutput, TName\>
 
-Defined in: [packages/typescript/ai/src/types.ts:486](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L486)
+Defined in: [packages/typescript/ai/src/types.ts:487](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L487)
 
 Tool/Function definition for function calling.
 
@@ -49,7 +49,7 @@ or plain JSON Schema objects for runtime validation and type safety.
 description: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:509](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L509)
+Defined in: [packages/typescript/ai/src/types.ts:510](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L510)
 
 Clear description of what the tool does.
 
@@ -70,7 +70,7 @@ Be specific about what the tool does, what parameters it needs, and what it retu
 optional execute: (args, context?) => any;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:589](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L589)
+Defined in: [packages/typescript/ai/src/types.ts:590](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L590)
 
 Optional function to execute when the model calls this tool.
 
@@ -114,7 +114,7 @@ execute: async (args) => {
 optional inputSchema: TInput;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:549](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L549)
+Defined in: [packages/typescript/ai/src/types.ts:550](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L550)
 
 Schema describing the tool's input parameters.
 
@@ -168,7 +168,7 @@ type({
 optional lazy: boolean;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:597](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L597)
+Defined in: [packages/typescript/ai/src/types.ts:598](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L598)
 
 If true, this tool is lazy and will only be sent to the LLM after being discovered via the lazy tool discovery mechanism. Only meaningful when used with chat().
 
@@ -180,7 +180,7 @@ If true, this tool is lazy and will only be sent to the LLM after being discover
 optional metadata: Record<string, any>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:600](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L600)
+Defined in: [packages/typescript/ai/src/types.ts:601](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L601)
 
 Additional metadata for adapters or custom extensions
 
@@ -192,7 +192,7 @@ Additional metadata for adapters or custom extensions
 name: TName;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:499](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L499)
+Defined in: [packages/typescript/ai/src/types.ts:500](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L500)
 
 Unique name of the tool (used by the model to call it).
 
@@ -213,7 +213,7 @@ Must be unique within the tools array.
 optional needsApproval: boolean;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:594](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L594)
+Defined in: [packages/typescript/ai/src/types.ts:595](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L595)
 
 If true, tool execution requires user approval before running. Works with both server and client tools.
 
@@ -225,7 +225,7 @@ If true, tool execution requires user approval before running. Works with both s
 optional outputSchema: TOutput;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:570](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L570)
+Defined in: [packages/typescript/ai/src/types.ts:571](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L571)
 
 Optional schema for validating tool output.
 
diff --git a/docs/reference/interfaces/ToolCall.md b/docs/reference/interfaces/ToolCall.md
index 4cca14c2d..fc6e27f6c 100644
--- a/docs/reference/interfaces/ToolCall.md
+++ b/docs/reference/interfaces/ToolCall.md
@@ -5,7 +5,7 @@ title: ToolCall
 
 # Interface: ToolCall\<TMetadata\>
 
-Defined in: [packages/typescript/ai/src/types.ts:135](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L135)
+Defined in: [packages/typescript/ai/src/types.ts:136](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L136)
 
 ## Type Parameters
 
@@ -21,7 +21,7 @@ Defined in: [packages/typescript/ai/src/types.ts:135](https://github.com/TanStac
 function: object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:138](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L138)
+Defined in: [packages/typescript/ai/src/types.ts:139](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L139)
 
 #### arguments
 
@@ -43,7 +43,7 @@ name: string;
 id: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:136](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L136)
+Defined in: [packages/typescript/ai/src/types.ts:137](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L137)
 
 ***
 
@@ -53,7 +53,7 @@ Defined in: [packages/typescript/ai/src/types.ts:136](https://github.com/TanStac
 optional metadata: TMetadata;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:145](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L145)
+Defined in: [packages/typescript/ai/src/types.ts:146](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L146)
 
 Provider-specific metadata to carry through the tool call lifecycle.
 Typed per-adapter via `TToolCallMetadata`. For example,
@@ -67,4 +67,4 @@ Typed per-adapter via `TToolCallMetadata`. For example,
 type: "function";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:137](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L137)
+Defined in: [packages/typescript/ai/src/types.ts:138](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L138)
diff --git a/docs/reference/interfaces/ToolCallArgsEvent.md b/docs/reference/interfaces/ToolCallArgsEvent.md
index 20c36c756..b6519fa20 100644
--- a/docs/reference/interfaces/ToolCallArgsEvent.md
+++ b/docs/reference/interfaces/ToolCallArgsEvent.md
@@ -5,7 +5,7 @@ title: ToolCallArgsEvent
 
 # Interface: ToolCallArgsEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1015](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1015)
+Defined in: [packages/typescript/ai/src/types.ts:1016](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1016)
 
 Emitted when tool call arguments are streaming.
 
@@ -30,7 +30,7 @@ TanStack AI adds: `model?`, `args?` (accumulated)
 optional args: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1019](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1019)
+Defined in: [packages/typescript/ai/src/types.ts:1020](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1020)
 
 Full accumulated arguments so far (TanStack AI internal)
 
@@ -42,6 +42,6 @@ Full accumulated arguments so far (TanStack AI internal)
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1017](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1017)
+Defined in: [packages/typescript/ai/src/types.ts:1018](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1018)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/ToolCallEndEvent.md b/docs/reference/interfaces/ToolCallEndEvent.md
index 33edfb237..86c24565b 100644
--- a/docs/reference/interfaces/ToolCallEndEvent.md
+++ b/docs/reference/interfaces/ToolCallEndEvent.md
@@ -5,7 +5,7 @@ title: ToolCallEndEvent
 
 # Interface: ToolCallEndEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1028](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1028)
+Defined in: [packages/typescript/ai/src/types.ts:1029](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1029)
 
 Emitted when a tool call completes.
 
@@ -30,7 +30,7 @@ TanStack AI adds: `model?`, `toolCallName?`, `toolName?` (deprecated), `input?`,
 optional input: unknown;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1039](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1039)
+Defined in: [packages/typescript/ai/src/types.ts:1040](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1040)
 
 Final parsed input arguments (TanStack AI internal)
 
@@ -42,7 +42,7 @@ Final parsed input arguments (TanStack AI internal)
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1030](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1030)
+Defined in: [packages/typescript/ai/src/types.ts:1031](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1031)
 
 Model identifier for multi-model support
 
@@ -54,7 +54,7 @@ Model identifier for multi-model support
 optional result: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1041](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1041)
+Defined in: [packages/typescript/ai/src/types.ts:1042](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1042)
 
 Tool execution result (TanStack AI internal)
 
@@ -66,7 +66,7 @@ Tool execution result (TanStack AI internal)
 optional toolCallName: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1032](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1032)
+Defined in: [packages/typescript/ai/src/types.ts:1033](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1033)
 
 Name of the tool that completed
 
@@ -78,7 +78,7 @@ Name of the tool that completed
 optional toolName: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1037](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1037)
+Defined in: [packages/typescript/ai/src/types.ts:1038](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1038)
 
 #### Deprecated
 
diff --git a/docs/reference/interfaces/ToolCallPart.md b/docs/reference/interfaces/ToolCallPart.md
index fc944fd5c..eced9abaf 100644
--- a/docs/reference/interfaces/ToolCallPart.md
+++ b/docs/reference/interfaces/ToolCallPart.md
@@ -5,7 +5,7 @@ title: ToolCallPart
 
 # Interface: ToolCallPart\<TMetadata\>
 
-Defined in: [packages/typescript/ai/src/types.ts:335](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L335)
+Defined in: [packages/typescript/ai/src/types.ts:336](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L336)
 
 ## Type Parameters
 
@@ -21,7 +21,7 @@ Defined in: [packages/typescript/ai/src/types.ts:335](https://github.com/TanStac
 optional approval: object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:342](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L342)
+Defined in: [packages/typescript/ai/src/types.ts:343](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L343)
 
 Approval metadata if tool requires user approval
 
@@ -51,7 +51,7 @@ needsApproval: boolean;
 arguments: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:339](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L339)
+Defined in: [packages/typescript/ai/src/types.ts:340](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L340)
 
 ***
 
@@ -61,7 +61,7 @@ Defined in: [packages/typescript/ai/src/types.ts:339](https://github.com/TanStac
 id: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:337](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L337)
+Defined in: [packages/typescript/ai/src/types.ts:338](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L338)
 
 ***
 
@@ -71,7 +71,7 @@ Defined in: [packages/typescript/ai/src/types.ts:337](https://github.com/TanStac
 optional metadata: TMetadata;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:351](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L351)
+Defined in: [packages/typescript/ai/src/types.ts:352](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L352)
 
 Provider-specific metadata that round-trips with the tool call.
 Typed per-adapter via `TToolCallMetadata`.
@@ -84,7 +84,7 @@ Typed per-adapter via `TToolCallMetadata`.
 name: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:338](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L338)
+Defined in: [packages/typescript/ai/src/types.ts:339](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L339)
 
 ***
 
@@ -94,7 +94,7 @@ Defined in: [packages/typescript/ai/src/types.ts:338](https://github.com/TanStac
 optional output: any;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:348](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L348)
+Defined in: [packages/typescript/ai/src/types.ts:349](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L349)
 
 Tool execution output (for client tools or after approval)
 
@@ -106,7 +106,7 @@ Tool execution output (for client tools or after approval)
 state: ToolCallState;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:340](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L340)
+Defined in: [packages/typescript/ai/src/types.ts:341](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L341)
 
 ***
 
@@ -116,4 +116,4 @@ Defined in: [packages/typescript/ai/src/types.ts:340](https://github.com/TanStac
 type: "tool-call";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:336](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L336)
+Defined in: [packages/typescript/ai/src/types.ts:337](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L337)
diff --git a/docs/reference/interfaces/ToolCallResultEvent.md b/docs/reference/interfaces/ToolCallResultEvent.md
index d49a9ffa1..8d1ba0d2a 100644
--- a/docs/reference/interfaces/ToolCallResultEvent.md
+++ b/docs/reference/interfaces/ToolCallResultEvent.md
@@ -5,7 +5,7 @@ title: ToolCallResultEvent
 
 # Interface: ToolCallResultEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1050](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1050)
+Defined in: [packages/typescript/ai/src/types.ts:1051](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1051)
 
 Emitted when a tool call result is available.
 
@@ -30,6 +30,6 @@ TanStack AI adds: `model?`
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1052](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1052)
+Defined in: [packages/typescript/ai/src/types.ts:1053](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1053)
 
 Model identifier for multi-model support
diff --git a/docs/reference/interfaces/ToolCallStartEvent.md b/docs/reference/interfaces/ToolCallStartEvent.md
index a62db2335..864509ceb 100644
--- a/docs/reference/interfaces/ToolCallStartEvent.md
+++ b/docs/reference/interfaces/ToolCallStartEvent.md
@@ -5,7 +5,7 @@ title: ToolCallStartEvent
 
 # Interface: ToolCallStartEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:992](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L992)
+Defined in: [packages/typescript/ai/src/types.ts:993](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L993)
 
 Emitted when a tool call starts.
 
@@ -30,7 +30,7 @@ TanStack AI adds: `model?`, `toolName` (deprecated alias), `index?`, `metadata?`
 optional index: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1001](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1001)
+Defined in: [packages/typescript/ai/src/types.ts:1002](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1002)
 
 Index for parallel tool calls
 
@@ -42,7 +42,7 @@ Index for parallel tool calls
 optional metadata: Record<string, unknown>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1006](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1006)
+Defined in: [packages/typescript/ai/src/types.ts:1007](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1007)
 
 Provider-specific metadata to carry into the ToolCall.
 Untyped at the event layer because events flow through a discriminated
@@ -57,7 +57,7 @@ union that does not survive generics; adapters cast it to their typed
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:994](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L994)
+Defined in: [packages/typescript/ai/src/types.ts:995](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L995)
 
 Model identifier for multi-model support
 
@@ -69,7 +69,7 @@ Model identifier for multi-model support
 toolName: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:999](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L999)
+Defined in: [packages/typescript/ai/src/types.ts:1000](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1000)
 
 #### Deprecated
 
diff --git a/docs/reference/interfaces/ToolConfig.md b/docs/reference/interfaces/ToolConfig.md
index b6609558c..c64a66f35 100644
--- a/docs/reference/interfaces/ToolConfig.md
+++ b/docs/reference/interfaces/ToolConfig.md
@@ -5,7 +5,7 @@ title: ToolConfig
 
 # Interface: ToolConfig
 
-Defined in: [packages/typescript/ai/src/types.ts:603](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L603)
+Defined in: [packages/typescript/ai/src/types.ts:604](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L604)
 
 ## Indexable
 
diff --git a/docs/reference/interfaces/ToolDefinition.md b/docs/reference/interfaces/ToolDefinition.md
index 728f8da6c..6dfb7b144 100644
--- a/docs/reference/interfaces/ToolDefinition.md
+++ b/docs/reference/interfaces/ToolDefinition.md
@@ -73,7 +73,7 @@ Create a client-side tool with optional execute function
 description: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:509](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L509)
+Defined in: [packages/typescript/ai/src/types.ts:510](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L510)
 
 Clear description of what the tool does.
 
@@ -98,7 +98,7 @@ Be specific about what the tool does, what parameters it needs, and what it retu
 optional execute: (args, context?) => any;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:589](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L589)
+Defined in: [packages/typescript/ai/src/types.ts:590](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L590)
 
 Optional function to execute when the model calls this tool.
 
@@ -146,7 +146,7 @@ execute: async (args) => {
 optional inputSchema: TInput;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:549](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L549)
+Defined in: [packages/typescript/ai/src/types.ts:550](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L550)
 
 Schema describing the tool's input parameters.
 
@@ -204,7 +204,7 @@ type({
 optional lazy: boolean;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:597](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L597)
+Defined in: [packages/typescript/ai/src/types.ts:598](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L598)
 
 If true, this tool is lazy and will only be sent to the LLM after being discovered via the lazy tool discovery mechanism. Only meaningful when used with chat().
 
@@ -220,7 +220,7 @@ If true, this tool is lazy and will only be sent to the LLM after being discover
 optional metadata: Record<string, any>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:600](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L600)
+Defined in: [packages/typescript/ai/src/types.ts:601](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L601)
 
 Additional metadata for adapters or custom extensions
 
@@ -236,7 +236,7 @@ Additional metadata for adapters or custom extensions
 name: TName;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:499](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L499)
+Defined in: [packages/typescript/ai/src/types.ts:500](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L500)
 
 Unique name of the tool (used by the model to call it).
 
@@ -261,7 +261,7 @@ Must be unique within the tools array.
 optional needsApproval: boolean;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:594](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L594)
+Defined in: [packages/typescript/ai/src/types.ts:595](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L595)
 
 If true, tool execution requires user approval before running. Works with both server and client tools.
 
@@ -277,7 +277,7 @@ If true, tool execution requires user approval before running. Works with both s
 optional outputSchema: TOutput;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:570](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L570)
+Defined in: [packages/typescript/ai/src/types.ts:571](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L571)
 
 Optional schema for validating tool output.
 
diff --git a/docs/reference/interfaces/ToolDefinitionInstance.md b/docs/reference/interfaces/ToolDefinitionInstance.md
index df0cd4e1b..ee0776c9e 100644
--- a/docs/reference/interfaces/ToolDefinitionInstance.md
+++ b/docs/reference/interfaces/ToolDefinitionInstance.md
@@ -49,7 +49,7 @@ Defined in: [packages/typescript/ai/src/activities/chat/tools/tool-definition.ts
 description: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:509](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L509)
+Defined in: [packages/typescript/ai/src/types.ts:510](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L510)
 
 Clear description of what the tool does.
 
@@ -74,7 +74,7 @@ Be specific about what the tool does, what parameters it needs, and what it retu
 optional execute: (args, context?) => any;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:589](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L589)
+Defined in: [packages/typescript/ai/src/types.ts:590](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L590)
 
 Optional function to execute when the model calls this tool.
 
@@ -122,7 +122,7 @@ execute: async (args) => {
 optional inputSchema: TInput;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:549](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L549)
+Defined in: [packages/typescript/ai/src/types.ts:550](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L550)
 
 Schema describing the tool's input parameters.
 
@@ -180,7 +180,7 @@ type({
 optional lazy: boolean;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:597](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L597)
+Defined in: [packages/typescript/ai/src/types.ts:598](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L598)
 
 If true, this tool is lazy and will only be sent to the LLM after being discovered via the lazy tool discovery mechanism. Only meaningful when used with chat().
 
@@ -196,7 +196,7 @@ If true, this tool is lazy and will only be sent to the LLM after being discover
 optional metadata: Record<string, any>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:600](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L600)
+Defined in: [packages/typescript/ai/src/types.ts:601](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L601)
 
 Additional metadata for adapters or custom extensions
 
@@ -212,7 +212,7 @@ Additional metadata for adapters or custom extensions
 name: TName;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:499](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L499)
+Defined in: [packages/typescript/ai/src/types.ts:500](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L500)
 
 Unique name of the tool (used by the model to call it).
 
@@ -237,7 +237,7 @@ Must be unique within the tools array.
 optional needsApproval: boolean;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:594](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L594)
+Defined in: [packages/typescript/ai/src/types.ts:595](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L595)
 
 If true, tool execution requires user approval before running. Works with both server and client tools.
 
@@ -253,7 +253,7 @@ If true, tool execution requires user approval before running. Works with both s
 optional outputSchema: TOutput;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:570](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L570)
+Defined in: [packages/typescript/ai/src/types.ts:571](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L571)
 
 Optional schema for validating tool output.
 
diff --git a/docs/reference/interfaces/ToolExecutionContext.md b/docs/reference/interfaces/ToolExecutionContext.md
index c0563de17..a86c0637e 100644
--- a/docs/reference/interfaces/ToolExecutionContext.md
+++ b/docs/reference/interfaces/ToolExecutionContext.md
@@ -5,7 +5,7 @@ title: ToolExecutionContext
 
 # Interface: ToolExecutionContext
 
-Defined in: [packages/typescript/ai/src/types.ts:449](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L449)
+Defined in: [packages/typescript/ai/src/types.ts:450](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L450)
 
 Context passed to tool execute functions, providing capabilities like
 emitting custom events during execution.
@@ -18,7 +18,7 @@ emitting custom events during execution.
 emitCustomEvent: (eventName, value) => void;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:470](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L470)
+Defined in: [packages/typescript/ai/src/types.ts:471](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L471)
 
 Emit a custom event during tool execution.
 Events are streamed to the client in real-time as AG-UI CUSTOM events.
@@ -61,6 +61,6 @@ const tool = toolDefinition({ ... }).server(async (args, context) => {
 optional toolCallId: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:451](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L451)
+Defined in: [packages/typescript/ai/src/types.ts:452](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L452)
 
 The ID of the tool call being executed
diff --git a/docs/reference/interfaces/ToolInputAvailableEvent.md b/docs/reference/interfaces/ToolInputAvailableEvent.md
index d26793d72..663e08fa2 100644
--- a/docs/reference/interfaces/ToolInputAvailableEvent.md
+++ b/docs/reference/interfaces/ToolInputAvailableEvent.md
@@ -5,7 +5,7 @@ title: ToolInputAvailableEvent
 
 # Interface: ToolInputAvailableEvent
 
-Defined in: [packages/typescript/ai/src/types.ts:1211](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1211)
+Defined in: [packages/typescript/ai/src/types.ts:1212](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1212)
 
 Emitted when a client tool is invoked. The agent loop yields this and
 pauses to let the caller run the tool client-side — `structured-output.complete`
@@ -30,7 +30,7 @@ will not fire for that run. Shape fixed by the agent-loop forwarding in
 optional model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1147](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1147)
+Defined in: [packages/typescript/ai/src/types.ts:1148](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1148)
 
 Model identifier for multi-model support
 
@@ -46,7 +46,7 @@ Model identifier for multi-model support
 name: "tool-input-available";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1212](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1212)
+Defined in: [packages/typescript/ai/src/types.ts:1213](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1213)
 
 #### Overrides
 
@@ -62,7 +62,7 @@ CustomEvent.name
 value: object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1213](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1213)
+Defined in: [packages/typescript/ai/src/types.ts:1214](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1214)
 
 #### input
 
diff --git a/docs/reference/interfaces/ToolResultPart.md b/docs/reference/interfaces/ToolResultPart.md
index 0ec0877de..5833f8985 100644
--- a/docs/reference/interfaces/ToolResultPart.md
+++ b/docs/reference/interfaces/ToolResultPart.md
@@ -5,7 +5,7 @@ title: ToolResultPart
 
 # Interface: ToolResultPart
 
-Defined in: [packages/typescript/ai/src/types.ts:354](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L354)
+Defined in: [packages/typescript/ai/src/types.ts:355](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L355)
 
 ## Properties
 
@@ -15,7 +15,7 @@ Defined in: [packages/typescript/ai/src/types.ts:354](https://github.com/TanStac
 content: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:357](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L357)
+Defined in: [packages/typescript/ai/src/types.ts:358](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L358)
 
 ***
 
@@ -25,7 +25,7 @@ Defined in: [packages/typescript/ai/src/types.ts:357](https://github.com/TanStac
 optional error: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:359](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L359)
+Defined in: [packages/typescript/ai/src/types.ts:360](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L360)
 
 ***
 
@@ -35,7 +35,7 @@ Defined in: [packages/typescript/ai/src/types.ts:359](https://github.com/TanStac
 state: ToolResultState;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:358](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L358)
+Defined in: [packages/typescript/ai/src/types.ts:359](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L359)
 
 ***
 
@@ -45,7 +45,7 @@ Defined in: [packages/typescript/ai/src/types.ts:358](https://github.com/TanStac
 toolCallId: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:356](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L356)
+Defined in: [packages/typescript/ai/src/types.ts:357](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L357)
 
 ***
 
@@ -55,4 +55,4 @@ Defined in: [packages/typescript/ai/src/types.ts:356](https://github.com/TanStac
 type: "tool-result";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:355](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L355)
+Defined in: [packages/typescript/ai/src/types.ts:356](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L356)
diff --git a/docs/reference/interfaces/TranscriptionOptions.md b/docs/reference/interfaces/TranscriptionOptions.md
index 040a3b135..7ba6f7cd1 100644
--- a/docs/reference/interfaces/TranscriptionOptions.md
+++ b/docs/reference/interfaces/TranscriptionOptions.md
@@ -5,7 +5,7 @@ title: TranscriptionOptions
 
 # Interface: TranscriptionOptions\<TProviderOptions\>
 
-Defined in: [packages/typescript/ai/src/types.ts:1664](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1664)
+Defined in: [packages/typescript/ai/src/types.ts:1665](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1665)
 
 Options for audio transcription.
 These are the common options supported across providers.
@@ -24,7 +24,7 @@ These are the common options supported across providers.
 audio: string | File | Blob | ArrayBuffer;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1670](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1670)
+Defined in: [packages/typescript/ai/src/types.ts:1671](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1671)
 
 The audio data to transcribe - can be base64 string, File, Blob, or Buffer
 
@@ -36,7 +36,7 @@ The audio data to transcribe - can be base64 string, File, Blob, or Buffer
 optional language: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1672](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1672)
+Defined in: [packages/typescript/ai/src/types.ts:1673](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1673)
 
 The language of the audio in ISO-639-1 format (e.g., 'en')
 
@@ -48,7 +48,7 @@ The language of the audio in ISO-639-1 format (e.g., 'en')
 logger: InternalLogger;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1684](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1684)
+Defined in: [packages/typescript/ai/src/types.ts:1685](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1685)
 
 Internal logger threaded from the generateTranscription() entry point.
 Adapters must call logger.request() before the SDK call and logger.errors()
@@ -62,7 +62,7 @@ in catch blocks.
 model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1668](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1668)
+Defined in: [packages/typescript/ai/src/types.ts:1669](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1669)
 
 The model to use for transcription
 
@@ -74,7 +74,7 @@ The model to use for transcription
 optional modelOptions: TProviderOptions;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1678](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1678)
+Defined in: [packages/typescript/ai/src/types.ts:1679](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1679)
 
 Model-specific options for transcription
 
@@ -86,7 +86,7 @@ Model-specific options for transcription
 optional prompt: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1674](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1674)
+Defined in: [packages/typescript/ai/src/types.ts:1675](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1675)
 
 An optional prompt to guide the transcription
 
@@ -98,6 +98,6 @@ An optional prompt to guide the transcription
 optional responseFormat: "text" | "json" | "srt" | "verbose_json" | "vtt";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1676](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1676)
+Defined in: [packages/typescript/ai/src/types.ts:1677](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1677)
 
 The format of the transcription output
diff --git a/docs/reference/interfaces/TranscriptionResult.md b/docs/reference/interfaces/TranscriptionResult.md
index e1c5a4f6f..1c4b21118 100644
--- a/docs/reference/interfaces/TranscriptionResult.md
+++ b/docs/reference/interfaces/TranscriptionResult.md
@@ -5,7 +5,7 @@ title: TranscriptionResult
 
 # Interface: TranscriptionResult
 
-Defined in: [packages/typescript/ai/src/types.ts:1720](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1720)
+Defined in: [packages/typescript/ai/src/types.ts:1721](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1721)
 
 Result of audio transcription.
 
@@ -17,7 +17,7 @@ Result of audio transcription.
 optional duration: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1730](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1730)
+Defined in: [packages/typescript/ai/src/types.ts:1731](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1731)
 
 Duration of the audio in seconds
 
@@ -29,7 +29,7 @@ Duration of the audio in seconds
 id: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1722](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1722)
+Defined in: [packages/typescript/ai/src/types.ts:1723](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1723)
 
 Unique identifier for the transcription
 
@@ -41,7 +41,7 @@ Unique identifier for the transcription
 optional language: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1728](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1728)
+Defined in: [packages/typescript/ai/src/types.ts:1729](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1729)
 
 Language detected or specified
 
@@ -53,7 +53,7 @@ Language detected or specified
 model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1724](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1724)
+Defined in: [packages/typescript/ai/src/types.ts:1725](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1725)
 
 Model used for transcription
 
@@ -65,7 +65,7 @@ Model used for transcription
 optional segments: TranscriptionSegment[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1732](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1732)
+Defined in: [packages/typescript/ai/src/types.ts:1733](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1733)
 
 Detailed segments with timing, if available
 
@@ -77,7 +77,7 @@ Detailed segments with timing, if available
 text: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1726](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1726)
+Defined in: [packages/typescript/ai/src/types.ts:1727](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1727)
 
 The full transcribed text
 
@@ -89,6 +89,6 @@ The full transcribed text
 optional words: TranscriptionWord[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1734](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1734)
+Defined in: [packages/typescript/ai/src/types.ts:1735](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1735)
 
 Word-level timestamps, if available
diff --git a/docs/reference/interfaces/TranscriptionSegment.md b/docs/reference/interfaces/TranscriptionSegment.md
index ed01bec92..f67ec35fe 100644
--- a/docs/reference/interfaces/TranscriptionSegment.md
+++ b/docs/reference/interfaces/TranscriptionSegment.md
@@ -5,7 +5,7 @@ title: TranscriptionSegment
 
 # Interface: TranscriptionSegment
 
-Defined in: [packages/typescript/ai/src/types.ts:1690](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1690)
+Defined in: [packages/typescript/ai/src/types.ts:1691](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1691)
 
 A single segment of transcribed audio with timing information.
 
@@ -17,7 +17,7 @@ A single segment of transcribed audio with timing information.
 optional confidence: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1700](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1700)
+Defined in: [packages/typescript/ai/src/types.ts:1701](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1701)
 
 Confidence score (0-1), if available
 
@@ -29,7 +29,7 @@ Confidence score (0-1), if available
 end: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1696](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1696)
+Defined in: [packages/typescript/ai/src/types.ts:1697](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1697)
 
 End time of the segment in seconds
 
@@ -41,7 +41,7 @@ End time of the segment in seconds
 id: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1692](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1692)
+Defined in: [packages/typescript/ai/src/types.ts:1693](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1693)
 
 Unique identifier for the segment
 
@@ -53,7 +53,7 @@ Unique identifier for the segment
 optional speaker: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1702](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1702)
+Defined in: [packages/typescript/ai/src/types.ts:1703](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1703)
 
 Speaker identifier, if diarization is enabled
 
@@ -65,7 +65,7 @@ Speaker identifier, if diarization is enabled
 start: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1694](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1694)
+Defined in: [packages/typescript/ai/src/types.ts:1695](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1695)
 
 Start time of the segment in seconds
 
@@ -77,6 +77,6 @@ Start time of the segment in seconds
 text: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1698](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1698)
+Defined in: [packages/typescript/ai/src/types.ts:1699](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1699)
 
 Transcribed text for this segment
diff --git a/docs/reference/interfaces/TranscriptionWord.md b/docs/reference/interfaces/TranscriptionWord.md
index 28c3983df..58fe5a77c 100644
--- a/docs/reference/interfaces/TranscriptionWord.md
+++ b/docs/reference/interfaces/TranscriptionWord.md
@@ -5,7 +5,7 @@ title: TranscriptionWord
 
 # Interface: TranscriptionWord
 
-Defined in: [packages/typescript/ai/src/types.ts:1708](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1708)
+Defined in: [packages/typescript/ai/src/types.ts:1709](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1709)
 
 A single word with timing information.
 
@@ -17,7 +17,7 @@ A single word with timing information.
 end: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1714](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1714)
+Defined in: [packages/typescript/ai/src/types.ts:1715](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1715)
 
 End time in seconds
 
@@ -29,7 +29,7 @@ End time in seconds
 start: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1712](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1712)
+Defined in: [packages/typescript/ai/src/types.ts:1713](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1713)
 
 Start time in seconds
 
@@ -41,6 +41,6 @@ Start time in seconds
 word: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1710](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1710)
+Defined in: [packages/typescript/ai/src/types.ts:1711](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1711)
 
 The transcribed word
diff --git a/docs/reference/interfaces/UIMessage.md b/docs/reference/interfaces/UIMessage.md
index fcb575f24..89a38f280 100644
--- a/docs/reference/interfaces/UIMessage.md
+++ b/docs/reference/interfaces/UIMessage.md
@@ -5,7 +5,7 @@ title: UIMessage
 
 # Interface: UIMessage\<TData\>
 
-Defined in: [packages/typescript/ai/src/types.ts:423](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L423)
+Defined in: [packages/typescript/ai/src/types.ts:424](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L424)
 
 UIMessage - Domain-specific message format optimized for building chat UIs
 Contains parts that can be text, tool calls, or tool results. Generic over
@@ -27,7 +27,7 @@ consumer side without manual casts.
 optional createdAt: Date;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:427](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L427)
+Defined in: [packages/typescript/ai/src/types.ts:428](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L428)
 
 ***
 
@@ -37,7 +37,7 @@ Defined in: [packages/typescript/ai/src/types.ts:427](https://github.com/TanStac
 id: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:424](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L424)
+Defined in: [packages/typescript/ai/src/types.ts:425](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L425)
 
 ***
 
@@ -47,7 +47,7 @@ Defined in: [packages/typescript/ai/src/types.ts:424](https://github.com/TanStac
 parts: MessagePart<TData>[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:426](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L426)
+Defined in: [packages/typescript/ai/src/types.ts:427](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L427)
 
 ***
 
@@ -57,4 +57,4 @@ Defined in: [packages/typescript/ai/src/types.ts:426](https://github.com/TanStac
 role: "user" | "assistant" | "system";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:425](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L425)
+Defined in: [packages/typescript/ai/src/types.ts:426](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L426)
diff --git a/docs/reference/interfaces/VideoGenerationOptions.md b/docs/reference/interfaces/VideoGenerationOptions.md
index 1e300ac1b..03696e688 100644
--- a/docs/reference/interfaces/VideoGenerationOptions.md
+++ b/docs/reference/interfaces/VideoGenerationOptions.md
@@ -5,7 +5,7 @@ title: VideoGenerationOptions
 
 # Interface: VideoGenerationOptions\<TProviderOptions, TSize\>
 
-Defined in: [packages/typescript/ai/src/types.ts:1546](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1546)
+Defined in: [packages/typescript/ai/src/types.ts:1547](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1547)
 
 **`Experimental`**
 
@@ -32,7 +32,7 @@ These are the common options supported across providers.
 optional duration: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1557](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1557)
+Defined in: [packages/typescript/ai/src/types.ts:1558](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1558)
 
 **`Experimental`**
 
@@ -46,7 +46,7 @@ Video duration in seconds
 logger: InternalLogger;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1564](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1564)
+Defined in: [packages/typescript/ai/src/types.ts:1565](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1565)
 
 **`Experimental`**
 
@@ -61,7 +61,7 @@ call logger.request() before the SDK call and logger.errors() in catch blocks.
 model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1551](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1551)
+Defined in: [packages/typescript/ai/src/types.ts:1552](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1552)
 
 **`Experimental`**
 
@@ -75,7 +75,7 @@ The model to use for video generation
 optional modelOptions: TProviderOptions;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1559](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1559)
+Defined in: [packages/typescript/ai/src/types.ts:1560](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1560)
 
 **`Experimental`**
 
@@ -89,7 +89,7 @@ Model-specific options for video generation
 prompt: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1553](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1553)
+Defined in: [packages/typescript/ai/src/types.ts:1554](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1554)
 
 **`Experimental`**
 
@@ -103,7 +103,7 @@ Text description of the desired video
 optional size: TSize;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1555](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1555)
+Defined in: [packages/typescript/ai/src/types.ts:1556](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1556)
 
 **`Experimental`**
 
diff --git a/docs/reference/interfaces/VideoJobResult.md b/docs/reference/interfaces/VideoJobResult.md
index 47047af3d..da036cc56 100644
--- a/docs/reference/interfaces/VideoJobResult.md
+++ b/docs/reference/interfaces/VideoJobResult.md
@@ -5,7 +5,7 @@ title: VideoJobResult
 
 # Interface: VideoJobResult
 
-Defined in: [packages/typescript/ai/src/types.ts:1572](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1572)
+Defined in: [packages/typescript/ai/src/types.ts:1573](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1573)
 
 **`Experimental`**
 
@@ -21,7 +21,7 @@ Result of creating a video generation job.
 jobId: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1574](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1574)
+Defined in: [packages/typescript/ai/src/types.ts:1575](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1575)
 
 **`Experimental`**
 
@@ -35,7 +35,7 @@ Unique job identifier for polling status
 model: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1576](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1576)
+Defined in: [packages/typescript/ai/src/types.ts:1577](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1577)
 
 **`Experimental`**
 
diff --git a/docs/reference/interfaces/VideoPart.md b/docs/reference/interfaces/VideoPart.md
index 02efcf91e..70f1f5d71 100644
--- a/docs/reference/interfaces/VideoPart.md
+++ b/docs/reference/interfaces/VideoPart.md
@@ -5,7 +5,7 @@ title: VideoPart
 
 # Interface: VideoPart\<TMetadata\>
 
-Defined in: [packages/typescript/ai/src/types.ts:237](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L237)
+Defined in: [packages/typescript/ai/src/types.ts:238](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L238)
 
 Video content part for multimodal messages.
 
@@ -25,7 +25,7 @@ Provider-specific metadata type
 optional metadata: TMetadata;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:242](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L242)
+Defined in: [packages/typescript/ai/src/types.ts:243](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L243)
 
 Provider-specific metadata (e.g., duration, resolution)
 
@@ -37,7 +37,7 @@ Provider-specific metadata (e.g., duration, resolution)
 source: ContentPartSource;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:240](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L240)
+Defined in: [packages/typescript/ai/src/types.ts:241](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L241)
 
 Source of the video content
 
@@ -49,4 +49,4 @@ Source of the video content
 type: "video";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:238](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L238)
+Defined in: [packages/typescript/ai/src/types.ts:239](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L239)
diff --git a/docs/reference/interfaces/VideoStatusResult.md b/docs/reference/interfaces/VideoStatusResult.md
index a7b1c6e4a..46de10fba 100644
--- a/docs/reference/interfaces/VideoStatusResult.md
+++ b/docs/reference/interfaces/VideoStatusResult.md
@@ -5,7 +5,7 @@ title: VideoStatusResult
 
 # Interface: VideoStatusResult
 
-Defined in: [packages/typescript/ai/src/types.ts:1584](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1584)
+Defined in: [packages/typescript/ai/src/types.ts:1585](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1585)
 
 **`Experimental`**
 
@@ -21,7 +21,7 @@ Status of a video generation job.
 optional error: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1592](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1592)
+Defined in: [packages/typescript/ai/src/types.ts:1593](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1593)
 
 **`Experimental`**
 
@@ -35,7 +35,7 @@ Error message if status is 'failed'
 jobId: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1586](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1586)
+Defined in: [packages/typescript/ai/src/types.ts:1587](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1587)
 
 **`Experimental`**
 
@@ -49,7 +49,7 @@ Job identifier
 optional progress: number;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1590](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1590)
+Defined in: [packages/typescript/ai/src/types.ts:1591](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1591)
 
 **`Experimental`**
 
@@ -63,7 +63,7 @@ Progress percentage (0-100), if available
 status: "pending" | "processing" | "completed" | "failed";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1588](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1588)
+Defined in: [packages/typescript/ai/src/types.ts:1589](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1589)
 
 **`Experimental`**
 
diff --git a/docs/reference/interfaces/VideoUrlResult.md b/docs/reference/interfaces/VideoUrlResult.md
index 8e97a1964..4d11c2427 100644
--- a/docs/reference/interfaces/VideoUrlResult.md
+++ b/docs/reference/interfaces/VideoUrlResult.md
@@ -5,7 +5,7 @@ title: VideoUrlResult
 
 # Interface: VideoUrlResult
 
-Defined in: [packages/typescript/ai/src/types.ts:1600](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1600)
+Defined in: [packages/typescript/ai/src/types.ts:1601](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1601)
 
 **`Experimental`**
 
@@ -21,7 +21,7 @@ Result containing the URL to a generated video.
 optional expiresAt: Date;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1606](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1606)
+Defined in: [packages/typescript/ai/src/types.ts:1607](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1607)
 
 **`Experimental`**
 
@@ -35,7 +35,7 @@ When the URL expires, if applicable
 jobId: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1602](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1602)
+Defined in: [packages/typescript/ai/src/types.ts:1603](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1603)
 
 **`Experimental`**
 
@@ -49,7 +49,7 @@ Job identifier
 url: string;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1604](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1604)
+Defined in: [packages/typescript/ai/src/types.ts:1605](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1605)
 
 **`Experimental`**
 
diff --git a/docs/reference/type-aliases/AGUIEvent.md b/docs/reference/type-aliases/AGUIEvent.md
index a18f4c779..88ffb1be4 100644
--- a/docs/reference/type-aliases/AGUIEvent.md
+++ b/docs/reference/type-aliases/AGUIEvent.md
@@ -31,6 +31,6 @@ type AGUIEvent =
   | ReasoningEncryptedValueEvent;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1335](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1335)
+Defined in: [packages/typescript/ai/src/types.ts:1336](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1336)
 
 Union of all AG-UI events.
diff --git a/docs/reference/type-aliases/AGUIEventType.md b/docs/reference/type-aliases/AGUIEventType.md
index 4548f511e..369b22b45 100644
--- a/docs/reference/type-aliases/AGUIEventType.md
+++ b/docs/reference/type-aliases/AGUIEventType.md
@@ -9,7 +9,7 @@ title: AGUIEventType
 type AGUIEventType = `${EventType}`;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:875](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L875)
+Defined in: [packages/typescript/ai/src/types.ts:876](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L876)
 
 AG-UI Protocol event types.
 
diff --git a/docs/reference/type-aliases/AgentLoopStrategy.md b/docs/reference/type-aliases/AgentLoopStrategy.md
index fe2cd0a03..bfd56d2a1 100644
--- a/docs/reference/type-aliases/AgentLoopStrategy.md
+++ b/docs/reference/type-aliases/AgentLoopStrategy.md
@@ -9,7 +9,7 @@ title: AgentLoopStrategy
 type AgentLoopStrategy = (state) => boolean;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:723](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L723)
+Defined in: [packages/typescript/ai/src/types.ts:724](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L724)
 
 Strategy function that determines whether the agent loop should continue
 
diff --git a/docs/reference/type-aliases/ConstrainedContent.md b/docs/reference/type-aliases/ConstrainedContent.md
index bbca04e1c..ea401b4fd 100644
--- a/docs/reference/type-aliases/ConstrainedContent.md
+++ b/docs/reference/type-aliases/ConstrainedContent.md
@@ -12,7 +12,7 @@ type ConstrainedContent<TInputModalitiesTypes> =
   | ContentPartForInputModalitiesTypes<TInputModalitiesTypes>[];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:305](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L305)
+Defined in: [packages/typescript/ai/src/types.ts:306](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L306)
 
 Type for message content constrained by supported modalities.
 When modalities is ['text', 'image'], only TextPart and ImagePart are allowed in the array.
diff --git a/docs/reference/type-aliases/ConstrainedModelMessage.md b/docs/reference/type-aliases/ConstrainedModelMessage.md
index c43183db8..f357b0178 100644
--- a/docs/reference/type-aliases/ConstrainedModelMessage.md
+++ b/docs/reference/type-aliases/ConstrainedModelMessage.md
@@ -9,7 +9,7 @@ title: ConstrainedModelMessage
 type ConstrainedModelMessage<TInputModalitiesTypes> = Omit<ModelMessage, "content"> & object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:439](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L439)
+Defined in: [packages/typescript/ai/src/types.ts:440](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L440)
 
 A ModelMessage with content constrained to only allow content parts
 matching the specified input modalities.
diff --git a/docs/reference/type-aliases/ContentPart.md b/docs/reference/type-aliases/ContentPart.md
index b48c9fe1b..4d008313b 100644
--- a/docs/reference/type-aliases/ContentPart.md
+++ b/docs/reference/type-aliases/ContentPart.md
@@ -14,7 +14,7 @@ type ContentPart<TTextMeta, TImageMeta, TAudioMeta, TVideoMeta, TDocumentMeta> =
 | DocumentPart<TDocumentMeta>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:264](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L264)
+Defined in: [packages/typescript/ai/src/types.ts:265](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L265)
 
 Union type for all multimodal content parts.
 
diff --git a/docs/reference/type-aliases/ContentPartForInputModalitiesTypes.md b/docs/reference/type-aliases/ContentPartForInputModalitiesTypes.md
index cd5b7eec2..3555179e8 100644
--- a/docs/reference/type-aliases/ContentPartForInputModalitiesTypes.md
+++ b/docs/reference/type-aliases/ContentPartForInputModalitiesTypes.md
@@ -11,7 +11,7 @@ type ContentPartForInputModalitiesTypes<TInputModalitiesTypes> = Extract<Content
 }>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:281](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L281)
+Defined in: [packages/typescript/ai/src/types.ts:282](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L282)
 
 Helper type to filter ContentPart union to only include specific modalities.
 Used to constrain message content based on model capabilities.
diff --git a/docs/reference/type-aliases/ContentPartSource.md b/docs/reference/type-aliases/ContentPartSource.md
index b6b4bae06..e5ca93b8f 100644
--- a/docs/reference/type-aliases/ContentPartSource.md
+++ b/docs/reference/type-aliases/ContentPartSource.md
@@ -11,7 +11,7 @@ type ContentPartSource =
   | ContentPartUrlSource;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:207](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L207)
+Defined in: [packages/typescript/ai/src/types.ts:208](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L208)
 
 Source specification for multimodal content.
 Discriminated union supporting both inline data (base64) and URL-based content.
diff --git a/docs/reference/type-aliases/DeepPartial.md b/docs/reference/type-aliases/DeepPartial.md
index e89237cf3..b5ed55504 100644
--- a/docs/reference/type-aliases/DeepPartial.md
+++ b/docs/reference/type-aliases/DeepPartial.md
@@ -9,7 +9,7 @@ title: DeepPartial
 type DeepPartial<T> = T extends ReadonlyArray<infer U> ? DeepPartial<U>[] : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:376](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L376)
+Defined in: [packages/typescript/ai/src/types.ts:377](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L377)
 
 Recursive `Partial` — every nested field becomes optional. Used as the
 `partial` type on a streaming structured-output part since the progressive
diff --git a/docs/reference/type-aliases/GeneratedAudio.md b/docs/reference/type-aliases/GeneratedAudio.md
index a7fd36e3b..5f744ef9d 100644
--- a/docs/reference/type-aliases/GeneratedAudio.md
+++ b/docs/reference/type-aliases/GeneratedAudio.md
@@ -9,7 +9,7 @@ title: GeneratedAudio
 type GeneratedAudio = GeneratedMediaSource & object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1511](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1511)
+Defined in: [packages/typescript/ai/src/types.ts:1512](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1512)
 
 A single generated audio output
 
diff --git a/docs/reference/type-aliases/GeneratedImage.md b/docs/reference/type-aliases/GeneratedImage.md
index 263078e81..dff804e42 100644
--- a/docs/reference/type-aliases/GeneratedImage.md
+++ b/docs/reference/type-aliases/GeneratedImage.md
@@ -9,7 +9,7 @@ title: GeneratedImage
 type GeneratedImage = GeneratedMediaSource & object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1458](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1458)
+Defined in: [packages/typescript/ai/src/types.ts:1459](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1459)
 
 A single generated image
 
diff --git a/docs/reference/type-aliases/GeneratedMediaSource.md b/docs/reference/type-aliases/GeneratedMediaSource.md
index a4eb69d9c..288dc4b15 100644
--- a/docs/reference/type-aliases/GeneratedMediaSource.md
+++ b/docs/reference/type-aliases/GeneratedMediaSource.md
@@ -17,7 +17,7 @@ type GeneratedMediaSource =
 };
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1443](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1443)
+Defined in: [packages/typescript/ai/src/types.ts:1444](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1444)
 
 Source of a generated media asset. Exactly one of `url` or `b64Json` is
 present; the other is absent. Modeled as a mutually-exclusive union so the
diff --git a/docs/reference/type-aliases/InferSchemaType.md b/docs/reference/type-aliases/InferSchemaType.md
index 18def9a4d..5f52c2894 100644
--- a/docs/reference/type-aliases/InferSchemaType.md
+++ b/docs/reference/type-aliases/InferSchemaType.md
@@ -9,7 +9,7 @@ title: InferSchemaType
 type InferSchemaType<T> = T extends StandardJSONSchemaV1<infer TInput, unknown> ? TInput : T extends StandardSchemaV1<infer TInput, unknown> ? TInput : unknown;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:128](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L128)
+Defined in: [packages/typescript/ai/src/types.ts:129](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L129)
 
 Infer the TypeScript type from a schema.
 For Standard JSON Schema compliant schemas, extracts the input type.
diff --git a/docs/reference/type-aliases/InputModalitiesTypes.md b/docs/reference/type-aliases/InputModalitiesTypes.md
index 2ee0c10d8..f67bf8e78 100644
--- a/docs/reference/type-aliases/InputModalitiesTypes.md
+++ b/docs/reference/type-aliases/InputModalitiesTypes.md
@@ -9,7 +9,7 @@ title: InputModalitiesTypes
 type InputModalitiesTypes = object;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:430](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L430)
+Defined in: [packages/typescript/ai/src/types.ts:431](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L431)
 
 ## Properties
 
@@ -19,7 +19,7 @@ Defined in: [packages/typescript/ai/src/types.ts:430](https://github.com/TanStac
 inputModalities: ReadonlyArray<Modality>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:431](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L431)
+Defined in: [packages/typescript/ai/src/types.ts:432](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L432)
 
 ***
 
@@ -29,4 +29,4 @@ Defined in: [packages/typescript/ai/src/types.ts:431](https://github.com/TanStac
 messageMetadataByModality: DefaultMessageMetadataByModality;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:432](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L432)
+Defined in: [packages/typescript/ai/src/types.ts:433](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L433)
diff --git a/docs/reference/type-aliases/MessagePart.md b/docs/reference/type-aliases/MessagePart.md
index 0599f324c..19a9eadc3 100644
--- a/docs/reference/type-aliases/MessagePart.md
+++ b/docs/reference/type-aliases/MessagePart.md
@@ -18,7 +18,7 @@ type MessagePart<TData> =
 | StructuredOutputPart<TData>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:405](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L405)
+Defined in: [packages/typescript/ai/src/types.ts:406](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L406)
 
 ## Type Parameters
 
diff --git a/docs/reference/type-aliases/ModalitiesArrayToUnion.md b/docs/reference/type-aliases/ModalitiesArrayToUnion.md
index 66112dadd..f3e11364a 100644
--- a/docs/reference/type-aliases/ModalitiesArrayToUnion.md
+++ b/docs/reference/type-aliases/ModalitiesArrayToUnion.md
@@ -9,7 +9,7 @@ title: ModalitiesArrayToUnion
 type ModalitiesArrayToUnion<T> = T[number];
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:298](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L298)
+Defined in: [packages/typescript/ai/src/types.ts:299](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L299)
 
 Helper type to convert a readonly array of modalities to a union type.
 e.g., readonly ['text', 'image'] -> 'text' | 'image'
diff --git a/docs/reference/type-aliases/Modality.md b/docs/reference/type-aliases/Modality.md
index f71059b1a..121a9b5d8 100644
--- a/docs/reference/type-aliases/Modality.md
+++ b/docs/reference/type-aliases/Modality.md
@@ -9,7 +9,7 @@ title: Modality
 type Modality = "text" | "image" | "audio" | "video" | "document";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:160](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L160)
+Defined in: [packages/typescript/ai/src/types.ts:161](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L161)
 
 Supported input modality types for multimodal content.
 - 'text': Plain text content
diff --git a/docs/reference/type-aliases/SchemaInput.md b/docs/reference/type-aliases/SchemaInput.md
index 465237e48..15570fba7 100644
--- a/docs/reference/type-aliases/SchemaInput.md
+++ b/docs/reference/type-aliases/SchemaInput.md
@@ -12,7 +12,7 @@ type SchemaInput =
   | JSONSchema;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:115](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L115)
+Defined in: [packages/typescript/ai/src/types.ts:116](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L116)
 
 Union type for schema input - can be any Standard Schema compliant validator,
 any Standard JSON Schema compliant schema, or a plain JSONSchema object.
diff --git a/docs/reference/type-aliases/StreamChunk.md b/docs/reference/type-aliases/StreamChunk.md
index 7491c3837..8ab1ffccd 100644
--- a/docs/reference/type-aliases/StreamChunk.md
+++ b/docs/reference/type-aliases/StreamChunk.md
@@ -9,7 +9,7 @@ title: StreamChunk
 type StreamChunk = AGUIEvent;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1363](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1363)
+Defined in: [packages/typescript/ai/src/types.ts:1364](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1364)
 
 Chunk returned by the SDK during streaming chat completions.
 Uses the AG-UI protocol event format.
diff --git a/docs/reference/type-aliases/StreamChunkType.md b/docs/reference/type-aliases/StreamChunkType.md
index 105769336..62b33b74f 100644
--- a/docs/reference/type-aliases/StreamChunkType.md
+++ b/docs/reference/type-aliases/StreamChunkType.md
@@ -9,7 +9,7 @@ title: StreamChunkType
 type StreamChunkType = AGUIEventType;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:881](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L881)
+Defined in: [packages/typescript/ai/src/types.ts:882](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L882)
 
 Stream chunk/event types (AG-UI protocol).
 
diff --git a/docs/reference/type-aliases/StructuredOutputStream.md b/docs/reference/type-aliases/StructuredOutputStream.md
index 40ad238f7..441333f55 100644
--- a/docs/reference/type-aliases/StructuredOutputStream.md
+++ b/docs/reference/type-aliases/StructuredOutputStream.md
@@ -14,7 +14,7 @@ type StructuredOutputStream<T> = AsyncIterable<
 | ToolInputAvailableEvent>;
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:1250](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1250)
+Defined in: [packages/typescript/ai/src/types.ts:1251](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1251)
 
 Public type for streams returned by `chat({ outputSchema, stream: true })`.
 
diff --git a/docs/reference/type-aliases/ToolCallState.md b/docs/reference/type-aliases/ToolCallState.md
index 3bae5441d..fcd672915 100644
--- a/docs/reference/type-aliases/ToolCallState.md
+++ b/docs/reference/type-aliases/ToolCallState.md
@@ -11,7 +11,8 @@ type ToolCallState =
   | "input-streaming"
   | "input-complete"
   | "approval-requested"
-  | "approval-responded";
+  | "approval-responded"
+  | "complete";
 ```
 
 Defined in: [packages/typescript/ai/src/types.ts:37](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L37)
diff --git a/docs/reference/type-aliases/ToolResultState.md b/docs/reference/type-aliases/ToolResultState.md
index 6877ca823..6b6b1f0b7 100644
--- a/docs/reference/type-aliases/ToolResultState.md
+++ b/docs/reference/type-aliases/ToolResultState.md
@@ -9,6 +9,6 @@ title: ToolResultState
 type ToolResultState = "streaming" | "complete" | "error";
 ```
 
-Defined in: [packages/typescript/ai/src/types.ts:47](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L47)
+Defined in: [packages/typescript/ai/src/types.ts:48](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L48)
 
 Tool result states - track the lifecycle of a tool result

From 18be2e2413aa783fea037bda24da50b27e49f3bf Mon Sep 17 00:00:00 2001
From: Tom Beckenham <34339192+tombeckenham@users.noreply.github.com>
Date: Tue, 26 May 2026 14:20:18 +1000
Subject: [PATCH 09/10] feat(ai,ai-fal): per-model typed durations for video
 generation (#534)

Adds a fifth generic `TModelDurationByName` to `VideoAdapter` plus two
introspection methods on the base class:

- `availableDurations()` returns a `DurationOptions` tagged union
  (`discrete | range | mixed | none`) describing the durations the
  current model accepts.
- `snapDuration(seconds)` coerces raw seconds to the closest valid
  duration for the current model.

`generateVideo({ duration })` is now typed via
`VideoDurationForAdapter<TAdapter>`. The FAL adapter derives its
per-model duration type from the SDK's `EndpointTypeMap`, so e.g.
`falVideo('fal-ai/kling-video/v1.6/standard/text-to-video')` types
`duration` as `'5' | '10'`; `falVideo('fal-ai/veo3')` types it as
`'4s' | '6s' | '8s'`; `falVideo('fal-ai/minimax/video-01')` rejects
the field entirely.

Adapters that have not yet declared their per-model duration map get
sensible defaults (`{ kind: 'none' }`, `undefined`) so existing video
adapters keep working without changes.

Built on top of #622 (`@tanstack/ai-schemas`); once that PR's FAL
pipeline syncs runtime constraint data, the hand-curated map in
`packages/typescript/ai-fal/src/video/video-provider-options.ts` can
be replaced with schema-derived lookups. Follow-up issue #634 covers
building the Gemini Veo adapter directly on this contract.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .changeset/typed-video-duration.md            | 34 +++++++
 .../typescript/ai-fal/src/adapters/video.ts   | 38 ++++++-
 packages/typescript/ai-fal/src/model-meta.ts  | 25 +++++
 .../src/video/video-provider-options.ts       | 54 ++++++++++
 .../ai-fal/tests/video-adapter.test.ts        | 62 +++++++++++-
 .../src/activities/generateVideo/adapter.ts   | 75 +++++++++++++-
 .../ai/src/activities/generateVideo/index.ts  | 50 +++++++---
 .../ai/src/activities/generateVideo/snap.ts   | 99 +++++++++++++++++++
 .../typescript/ai/src/activities/index.ts     |  2 +
 packages/typescript/ai/src/types.ts           | 10 +-
 packages/typescript/ai/tests/snap.test.ts     | 38 +++++++
 .../ai/tests/stream-generation.test.ts        |  3 +
 12 files changed, 463 insertions(+), 27 deletions(-)
 create mode 100644 .changeset/typed-video-duration.md
 create mode 100644 packages/typescript/ai/src/activities/generateVideo/snap.ts
 create mode 100644 packages/typescript/ai/tests/snap.test.ts

diff --git a/.changeset/typed-video-duration.md b/.changeset/typed-video-duration.md
new file mode 100644
index 000000000..fb6618348
--- /dev/null
+++ b/.changeset/typed-video-duration.md
@@ -0,0 +1,34 @@
+---
+'@tanstack/ai': major
+'@tanstack/ai-fal': major
+---
+
+Add per-model typed durations for video generation.
+
+`VideoAdapter` gains a fifth generic, `TModelDurationByName`, plus two
+introspection methods on every adapter:
+
+- `availableDurations()` — returns a `DurationOptions` tagged union
+  (`discrete | range | mixed | none`) describing the durations the current
+  model accepts.
+- `snapDuration(seconds)` — coerces raw seconds to the closest valid duration
+  for the current model.
+
+The `duration` field on `generateVideo({ adapter, ... })` is now per-model
+typed via `VideoDurationForAdapter<TAdapter>`. For FAL, the type is derived
+from `@fal-ai/client`'s `EndpointTypeMap`, so:
+
+- `falVideo('fal-ai/kling-video/v1.6/standard/text-to-video')` → `duration?: '5' | '10'`
+- `falVideo('fal-ai/veo3')` → `duration?: '4s' | '6s' | '8s'`
+- `falVideo('fal-ai/minimax/video-01')` → `duration` not accepted
+
+**Breaking**: callers passing `duration: <number>` to FAL video models must
+either pass the typed string union directly or call
+`adapter.snapDuration(seconds)`. Adapters that have not yet declared their
+per-model duration map get a sensible default (`{ kind: 'none' }`,
+`undefined`) so existing behaviour is preserved.
+
+Builds on `@tanstack/ai-schemas` (#622); once that PR's FAL pipeline syncs
+runtime constraint data, the hand-curated map in
+`packages/typescript/ai-fal/src/video/video-provider-options.ts` will be
+replaced with schema-derived lookups.
diff --git a/packages/typescript/ai-fal/src/adapters/video.ts b/packages/typescript/ai-fal/src/adapters/video.ts
index 662b4f60f..c47685676 100644
--- a/packages/typescript/ai-fal/src/adapters/video.ts
+++ b/packages/typescript/ai-fal/src/adapters/video.ts
@@ -1,7 +1,11 @@
 import { fal } from '@fal-ai/client'
-import { BaseVideoAdapter } from '@tanstack/ai/adapters'
+import { BaseVideoAdapter, snapToDurationOption } from '@tanstack/ai/adapters'
 import { configureFalClient, generateId as utilGenerateId } from '../utils'
-import { mapVideoSizeToFalFormat } from '../video/video-provider-options'
+import {
+  getFalVideoDurationOptions,
+  mapVideoSizeToFalFormat,
+} from '../video/video-provider-options'
+import type { DurationOptions } from '@tanstack/ai/adapters'
 import type {
   VideoGenerationOptions,
   VideoJobResult,
@@ -11,6 +15,7 @@ import type {
 import type {
   FalModel,
   FalModelInput,
+  FalModelVideoDuration,
   FalModelVideoSize,
   FalVideoProviderOptions,
 } from '../model-meta'
@@ -64,7 +69,8 @@ export class FalVideoAdapter<TModel extends FalModel> extends BaseVideoAdapter<
   TModel,
   FalVideoProviderOptions<TModel>,
   Record<TModel, FalVideoProviderOptions<TModel>>,
-  Record<TModel, FalModelVideoSize<TModel>>
+  Record<TModel, FalModelVideoSize<TModel>>,
+  Record<TModel, FalModelVideoDuration<TModel>>
 > {
   override readonly kind = 'video' as const
   readonly name = 'fal' as const
@@ -77,7 +83,8 @@ export class FalVideoAdapter<TModel extends FalModel> extends BaseVideoAdapter<
   async createVideoJob(
     options: VideoGenerationOptions<
       FalVideoProviderOptions<TModel>,
-      FalModelVideoSize<TModel>
+      FalModelVideoSize<TModel>,
+      FalModelVideoDuration<TModel>
     >,
   ): Promise<VideoJobResult> {
     const { prompt, size, duration, modelOptions, logger } = options
@@ -90,11 +97,17 @@ export class FalVideoAdapter<TModel extends FalModel> extends BaseVideoAdapter<
     try {
       const sizeParams = mapVideoSizeToFalFormat(size)
 
+      // Omit `duration` for models whose API doesn't accept it (kind: 'none').
+      // For models with discrete/range constraints, duration was already typed
+      // to a valid value via VideoDurationForAdapter, so pass through as-is.
+      const supportsDuration =
+        getFalVideoDurationOptions(this.model).kind !== 'none'
+
       const input = {
         ...modelOptions,
         ...sizeParams,
         prompt,
-        ...(duration ? { duration } : {}),
+        ...(supportsDuration && duration !== undefined ? { duration } : {}),
       } as FalModelInput<TModel>
 
       // Submit to queue and get request ID
@@ -115,6 +128,21 @@ export class FalVideoAdapter<TModel extends FalModel> extends BaseVideoAdapter<
     }
   }
 
+  override availableDurations(): DurationOptions<FalModelVideoDuration<TModel>> {
+    return getFalVideoDurationOptions(this.model) as DurationOptions<
+      FalModelVideoDuration<TModel>
+    >
+  }
+
+  override snapDuration(
+    seconds: number,
+  ): FalModelVideoDuration<TModel> | undefined {
+    return snapToDurationOption(
+      seconds,
+      this.availableDurations(),
+    ) as FalModelVideoDuration<TModel> | undefined
+  }
+
   async getVideoStatus(jobId: string): Promise<VideoStatusResult> {
     const statusResponse = (await fal.queue.status(this.model, {
       requestId: jobId,
diff --git a/packages/typescript/ai-fal/src/model-meta.ts b/packages/typescript/ai-fal/src/model-meta.ts
index 5aa5367ca..2f1c15fa8 100644
--- a/packages/typescript/ai-fal/src/model-meta.ts
+++ b/packages/typescript/ai-fal/src/model-meta.ts
@@ -127,6 +127,31 @@ export type FalVideoProviderOptions<TModel extends string> =
     ? Omit<FalModelInput<TModel>, 'prompt'>
     : Record<string, unknown>
 
+/**
+ * Extract the `duration` field type from a fal video model's input.
+ * Falls back to `string | number | undefined` for unknown models.
+ *
+ * Shapes seen in the wild:
+ *  - `'5' | '10'` (Kling, Pika): discrete numeric strings
+ *  - `'5s' | '9s'` (Luma): keyword strings with unit
+ *  - `'4s' | '6s' | '8s'` (Veo3 via FAL): keyword strings
+ *  - `'2' | … | '15'` (WAN-25): discrete-range numeric strings
+ *  - never (Minimax, Hunyuan): no duration field
+ */
+export type FalModelVideoDuration<TModel extends string> =
+  TModel extends keyof EndpointTypeMap
+    ? 'duration' extends keyof EndpointTypeMap[TModel]['input']
+      ? Extract<
+          NonNullable<
+            EndpointTypeMap[TModel]['input'] extends { duration?: infer D }
+              ? D
+              : never
+          >,
+          string | number
+        >
+      : undefined
+    : string | number | undefined
+
 /**
  * Provider options for TTS, excluding fields TanStack AI handles.
  * Use this for the `modelOptions` parameter in speech generation.
diff --git a/packages/typescript/ai-fal/src/video/video-provider-options.ts b/packages/typescript/ai-fal/src/video/video-provider-options.ts
index 799168446..a8c2d3816 100644
--- a/packages/typescript/ai-fal/src/video/video-provider-options.ts
+++ b/packages/typescript/ai-fal/src/video/video-provider-options.ts
@@ -1,3 +1,4 @@
+import type { DurationOptions } from '@tanstack/ai/adapters'
 import type { FalModelVideoSize, FalModelVideoSizeInput } from '../model-meta'
 
 export function mapVideoSizeToFalFormat<TModel extends string>(
@@ -22,3 +23,56 @@ export function mapVideoSizeToFalFormat<TModel extends string>(
 
   return { resolution: size } as FalModelVideoSizeInput<TModel>
 }
+
+/**
+ * Curated map of per-model duration options for popular fal.ai video models.
+ * Values were sourced from the fal.ai client's EndpointTypeMap input types.
+ *
+ * Models not listed here fall back to `{ kind: 'none' }` — honest "we don't
+ * know" rather than guessing. The type-level `FalModelVideoDuration<TModel>`
+ * still derives from the SDK types so autocomplete works for unknown models.
+ *
+ * When `@tanstack/ai-schemas` ships FAL endpoint coverage (post-#622 with
+ * `FAL_KEY` configured in CI), we can replace this map with a schema-derived
+ * lookup. The public API doesn't change.
+ */
+const FAL_VIDEO_DURATIONS: Readonly<
+  Record<string, DurationOptions<string | number | undefined>>
+> = {
+  'fal-ai/kling-video/v1.6/standard/text-to-video': {
+    kind: 'discrete',
+    values: ['5', '10'],
+  },
+  'fal-ai/kling-video/v1.6/pro/text-to-video': {
+    kind: 'discrete',
+    values: ['5', '10'],
+  },
+  'fal-ai/pika/v2.2/text-to-video': {
+    kind: 'discrete',
+    values: ['5', '10'],
+  },
+  'fal-ai/luma-dream-machine/ray-2': {
+    kind: 'discrete',
+    values: ['5s', '9s'],
+  },
+  'fal-ai/veo3': {
+    kind: 'discrete',
+    values: ['4s', '6s', '8s'],
+  },
+  'fal-ai/veo3/image-to-video': {
+    kind: 'discrete',
+    values: ['4s', '6s', '8s'],
+  },
+  'fal-ai/wan-25-preview/text-to-video': {
+    kind: 'discrete',
+    values: ['2', '3', '4', '5', '6', '7', '8', '9', '10', '11', '12', '13', '14', '15'],
+  },
+  'fal-ai/minimax/video-01': { kind: 'none' },
+  'fal-ai/hunyuan-video-v1.5/text-to-video': { kind: 'none' },
+}
+
+export function getFalVideoDurationOptions(
+  model: string,
+): DurationOptions<string | number | undefined> {
+  return FAL_VIDEO_DURATIONS[model] ?? { kind: 'none' }
+}
diff --git a/packages/typescript/ai-fal/tests/video-adapter.test.ts b/packages/typescript/ai-fal/tests/video-adapter.test.ts
index 08e1cec06..4a2a528eb 100644
--- a/packages/typescript/ai-fal/tests/video-adapter.test.ts
+++ b/packages/typescript/ai-fal/tests/video-adapter.test.ts
@@ -86,7 +86,7 @@ describe('Fal Video Adapter', () => {
       })
     })
 
-    it('includes duration option', async () => {
+    it('includes duration option using the model-typed keyword', async () => {
       mockQueueSubmit.mockResolvedValueOnce({
         request_id: 'job-789',
       })
@@ -96,7 +96,9 @@ describe('Fal Video Adapter', () => {
       await generateVideo({
         adapter: adapter,
         prompt: 'A time lapse of a sunset',
-        duration: 10,
+        // veo3/image-to-video accepts '4s' | '6s' | '8s' — passing a raw
+        // number is now a type error.
+        duration: '8s',
         modelOptions: {
           image_url: 'https://example.com/sunset.jpg',
         },
@@ -104,10 +106,64 @@ describe('Fal Video Adapter', () => {
 
       const [, options] = mockQueueSubmit.mock.calls[0]!
       expect(options.input).toMatchObject({
-        duration: 10,
+        duration: '8s',
       })
     })
 
+    it('omits duration for kind: none models (Minimax)', async () => {
+      mockQueueSubmit.mockResolvedValueOnce({
+        request_id: 'job-mini',
+      })
+
+      const adapter = falVideo('fal-ai/minimax/video-01', { apiKey: 'test' })
+
+      await generateVideo({
+        adapter,
+        prompt: 'A fox running through snow',
+      })
+
+      const [, options] = mockQueueSubmit.mock.calls[0]!
+      expect(options.input).not.toHaveProperty('duration')
+    })
+  })
+
+  describe('availableDurations / snapDuration', () => {
+    it('returns discrete keyword durations for Veo3', () => {
+      const adapter = falVideo('fal-ai/veo3', { apiKey: 'test' })
+      expect(adapter.availableDurations()).toEqual({
+        kind: 'discrete',
+        values: ['4s', '6s', '8s'],
+      })
+      expect(adapter.snapDuration(7)).toBe('6s')
+      expect(adapter.snapDuration(9)).toBe('8s')
+    })
+
+    it('returns discrete numeric durations for Kling', () => {
+      const adapter = falVideo(
+        'fal-ai/kling-video/v1.6/standard/text-to-video',
+        { apiKey: 'test' },
+      )
+      expect(adapter.availableDurations()).toEqual({
+        kind: 'discrete',
+        values: ['5', '10'],
+      })
+      expect(adapter.snapDuration(7)).toBe('5')
+      expect(adapter.snapDuration(8)).toBe('10')
+    })
+
+    it('returns kind: none for Minimax (no duration field)', () => {
+      const adapter = falVideo('fal-ai/minimax/video-01', { apiKey: 'test' })
+      expect(adapter.availableDurations()).toEqual({ kind: 'none' })
+      expect(adapter.snapDuration(7)).toBeUndefined()
+    })
+
+    it('falls back to kind: none for uncurated models', () => {
+      const adapter = falVideo('fal-ai/some-unknown-video-model', {
+        apiKey: 'test',
+      })
+      expect(adapter.availableDurations()).toEqual({ kind: 'none' })
+    })
+
     it('converts size with aspect_ratio and resolution', async () => {
       mockQueueSubmit.mockResolvedValueOnce({
         request_id: 'job-ar',
diff --git a/packages/typescript/ai/src/activities/generateVideo/adapter.ts b/packages/typescript/ai/src/activities/generateVideo/adapter.ts
index a0b4b4389..00bd6b58a 100644
--- a/packages/typescript/ai/src/activities/generateVideo/adapter.ts
+++ b/packages/typescript/ai/src/activities/generateVideo/adapter.ts
@@ -5,6 +5,25 @@ import type {
   VideoUrlResult,
 } from '../../types'
 
+/**
+ * Structured description of the durations a video model accepts.
+ *
+ * Tagged union so the same shape can express discrete enums (OpenAI Sora,
+ * Kling), continuous ranges, mixed shapes, and models with no duration field
+ * (Minimax). Consumed by `VideoAdapter.availableDurations()`.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export type DurationOptions<T extends string | number | undefined> =
+  | { kind: 'discrete'; values: ReadonlyArray<NonNullable<T>> }
+  | { kind: 'range'; min: number; max: number; step?: number; unit: 'seconds' }
+  | {
+      kind: 'mixed'
+      values: ReadonlyArray<NonNullable<T>>
+      range?: { min: number; max: number; step?: number }
+    }
+  | { kind: 'none' }
+
 /**
  * Configuration for video adapter instances
  *
@@ -40,6 +59,10 @@ export interface VideoAdapter<
     string,
     string
   >,
+  TModelDurationByName extends Record<
+    string,
+    string | number | undefined
+  > = Record<string, string | number | undefined>,
 > {
   /** Discriminator for adapter kind - used to determine API shape */
   readonly kind: 'video'
@@ -55,6 +78,7 @@ export interface VideoAdapter<
     providerOptions: TProviderOptions
     modelProviderOptionsByName: TModelProviderOptionsByName
     modelSizeByName: TModelSizeByName
+    modelDurationByName: TModelDurationByName
   }
 
   /**
@@ -62,7 +86,11 @@ export interface VideoAdapter<
    * Returns a job ID that can be used to poll for status and retrieve the video.
    */
   createVideoJob: (
-    options: VideoGenerationOptions<TProviderOptions, TModelSizeByName[TModel]>,
+    options: VideoGenerationOptions<
+      TProviderOptions,
+      TModelSizeByName[TModel],
+      TModelDurationByName[TModel]
+    >,
   ) => Promise<VideoJobResult>
 
   /**
@@ -75,13 +103,26 @@ export interface VideoAdapter<
    * Should only be called after status is 'completed'.
    */
   getVideoUrl: (jobId: string) => Promise<VideoUrlResult>
+
+  /**
+   * Describe the durations this adapter's model accepts. Returns a tagged
+   * union so consumers can render UI / coerce input without provider-specific
+   * knowledge.
+   */
+  availableDurations: () => DurationOptions<TModelDurationByName[TModel]>
+
+  /**
+   * Coerce a raw seconds value to the closest valid duration for this model.
+   * Returns `undefined` for models with no duration field.
+   */
+  snapDuration: (seconds: number) => TModelDurationByName[TModel] | undefined
 }
 
 /**
  * A VideoAdapter with any/unknown type parameters.
  * Useful as a constraint in generic functions and interfaces.
  */
-export type AnyVideoAdapter = VideoAdapter<any, any, any, any>
+export type AnyVideoAdapter = VideoAdapter<any, any, any, any, any>
 
 /**
  * Abstract base class for video generation adapters.
@@ -99,11 +140,16 @@ export abstract class BaseVideoAdapter<
     string,
     string
   >,
+  TModelDurationByName extends Record<
+    string,
+    string | number | undefined
+  > = Record<string, string | number | undefined>,
 > implements VideoAdapter<
   TModel,
   TProviderOptions,
   TModelProviderOptionsByName,
-  TModelSizeByName
+  TModelSizeByName,
+  TModelDurationByName
 > {
   readonly kind = 'video' as const
   abstract readonly name: string
@@ -114,6 +160,7 @@ export abstract class BaseVideoAdapter<
     providerOptions: TProviderOptions
     modelProviderOptionsByName: TModelProviderOptionsByName
     modelSizeByName: TModelSizeByName
+    modelDurationByName: TModelDurationByName
   }
 
   protected config: VideoAdapterConfig
@@ -124,13 +171,33 @@ export abstract class BaseVideoAdapter<
   }
 
   abstract createVideoJob(
-    options: VideoGenerationOptions<TProviderOptions, TModelSizeByName[TModel]>,
+    options: VideoGenerationOptions<
+      TProviderOptions,
+      TModelSizeByName[TModel],
+      TModelDurationByName[TModel]
+    >,
   ): Promise<VideoJobResult>
 
   abstract getVideoStatus(jobId: string): Promise<VideoStatusResult>
 
   abstract getVideoUrl(jobId: string): Promise<VideoUrlResult>
 
+  /**
+   * Default implementation returns `{ kind: 'none' }`. Adapters that have
+   * declared their per-model duration map should override this.
+   */
+  availableDurations(): DurationOptions<TModelDurationByName[TModel]> {
+    return { kind: 'none' }
+  }
+
+  /**
+   * Default implementation returns `undefined`. Adapters that have declared
+   * their per-model duration map should override.
+   */
+  snapDuration(_seconds: number): TModelDurationByName[TModel] | undefined {
+    return undefined
+  }
+
   protected generateId(): string {
     return `${this.name}-${Date.now()}-${Math.random().toString(36).substring(7)}`
   }
diff --git a/packages/typescript/ai/src/activities/generateVideo/index.ts b/packages/typescript/ai/src/activities/generateVideo/index.ts
index cee2339f7..cdd38d01c 100644
--- a/packages/typescript/ai/src/activities/generateVideo/index.ts
+++ b/packages/typescript/ai/src/activities/generateVideo/index.ts
@@ -43,12 +43,30 @@ export type VideoProviderOptions<TAdapter> =
  * Extract the size type for a VideoAdapter's model via ~types.
  */
 export type VideoSizeForAdapter<TAdapter> =
-  TAdapter extends VideoAdapter<infer TModel, any, any, infer TSizeMap>
+  TAdapter extends VideoAdapter<infer TModel, any, any, infer TSizeMap, any>
     ? TModel extends keyof TSizeMap
       ? TSizeMap[TModel]
       : string
     : string
 
+/**
+ * Extract the duration type for a VideoAdapter's model via ~types.
+ * Mirrors `VideoSizeForAdapter`. Falls back to `number | string | undefined`
+ * for adapters that haven't declared per-model duration constraints.
+ */
+export type VideoDurationForAdapter<TAdapter> =
+  TAdapter extends VideoAdapter<
+    infer TModel,
+    any,
+    any,
+    any,
+    infer TDurationMap
+  >
+    ? TModel extends keyof TDurationMap
+      ? TDurationMap[TModel]
+      : string | number | undefined
+    : string | number | undefined
+
 // ===========================
 // Activity Options Types
 
@@ -62,7 +80,7 @@ function createId(prefix: string): string {
  * The model is extracted from the adapter's model property.
  */
 interface VideoActivityBaseOptions<
-  TAdapter extends VideoAdapter<string, any, any, any>,
+  TAdapter extends VideoAdapter<string, any, any, any, any>,
 > {
   /** The video adapter to use (must be created with a model) */
   adapter: TAdapter & { kind: typeof kind }
@@ -78,7 +96,7 @@ interface VideoActivityBaseOptions<
  * @experimental Video generation is an experimental feature and may change.
  */
 export type VideoCreateOptions<
-  TAdapter extends VideoAdapter<string, any, any, any>,
+  TAdapter extends VideoAdapter<string, any, any, any, any>,
   TStream extends boolean = false,
 > = VideoActivityBaseOptions<TAdapter> & {
   /** Request type - create a new job (default if not specified) */
@@ -87,8 +105,12 @@ export type VideoCreateOptions<
   prompt: string
   /** Video size — format depends on the provider (e.g., "16:9", "1280x720") */
   size?: VideoSizeForAdapter<TAdapter>
-  /** Video duration in seconds */
-  duration?: number
+  /**
+   * Video duration — exact shape is per-model and may be a number, a string
+   * enum like '4' | '8' | '12' (Sora), or a keyword like '8s' (Veo via FAL).
+   * Pass `adapter.snapDuration(seconds)` to coerce raw seconds to a valid value.
+   */
+  duration?: VideoDurationForAdapter<TAdapter>
   /**
    * Whether to stream the video generation lifecycle.
    * When true, returns an AsyncIterable<StreamChunk> that handles the full
@@ -124,7 +146,7 @@ export type VideoCreateOptions<
  * @experimental Video generation is an experimental feature and may change.
  */
 export interface VideoStatusOptions<
-  TAdapter extends VideoAdapter<string, any, any, any>,
+  TAdapter extends VideoAdapter<string, any, any, any, any>,
 > extends VideoActivityBaseOptions<TAdapter> {
   /** Request type - get job status */
   request: 'status'
@@ -138,7 +160,7 @@ export interface VideoStatusOptions<
  * @experimental Video generation is an experimental feature and may change.
  */
 export interface VideoUrlOptions<
-  TAdapter extends VideoAdapter<string, any, any, any>,
+  TAdapter extends VideoAdapter<string, any, any, any, any>,
 > extends VideoActivityBaseOptions<TAdapter> {
   /** Request type - get video URL */
   request: 'url'
@@ -153,7 +175,7 @@ export interface VideoUrlOptions<
  * @experimental Video generation is an experimental feature and may change.
  */
 export type VideoActivityOptions<
-  TAdapter extends VideoAdapter<string, any, any, any>,
+  TAdapter extends VideoAdapter<string, any, any, any, any>,
   TRequest extends 'create' | 'status' | 'url' = 'create',
   TStream extends boolean = false,
 > = TRequest extends 'status'
@@ -229,7 +251,7 @@ export type VideoActivityResult<
  * ```
  */
 export function generateVideo<
-  TAdapter extends VideoAdapter<string, any, any, any>,
+  TAdapter extends VideoAdapter<string, any, any, any, any>,
   TStream extends boolean = false,
 >(
   options: VideoCreateOptions<TAdapter, TStream>,
@@ -247,7 +269,7 @@ export function generateVideo<
  * Internal implementation of non-streaming video job creation.
  */
 async function runCreateVideoJob<
-  TAdapter extends VideoAdapter<string, any, any, any>,
+  TAdapter extends VideoAdapter<string, any, any, any, any>,
 >(options: VideoCreateOptions<TAdapter, boolean>): Promise<VideoJobResult> {
   const { adapter, prompt, size, duration, modelOptions } = options
   const model = adapter.model
@@ -294,7 +316,7 @@ function sleep(ms: number): Promise<void> {
  * Handles the full job lifecycle: create job → poll for status → stream updates → yield final result.
  */
 async function* runStreamingVideoGeneration<
-  TAdapter extends VideoAdapter<string, any, any, any>,
+  TAdapter extends VideoAdapter<string, any, any, any, any>,
 >(options: VideoCreateOptions<TAdapter, true>): AsyncIterable<StreamChunk> {
   const { adapter, prompt, size, duration, modelOptions } = options
   const model = adapter.model
@@ -445,7 +467,7 @@ async function* runStreamingVideoGeneration<
  * ```
  */
 export async function getVideoJobStatus<
-  TAdapter extends VideoAdapter<string, any, any, any>,
+  TAdapter extends VideoAdapter<string, any, any, any, any>,
 >(options: {
   adapter: TAdapter & { kind: typeof kind }
   jobId: string
@@ -545,7 +567,7 @@ export async function getVideoJobStatus<
  * Create typed options for the generateVideo() function without executing.
  */
 export function createVideoOptions<
-  TAdapter extends VideoAdapter<string, any, any, any>,
+  TAdapter extends VideoAdapter<string, any, any, any, any>,
   TStream extends boolean = false,
 >(
   options: VideoCreateOptions<TAdapter, TStream>,
@@ -558,5 +580,7 @@ export type {
   VideoAdapter,
   VideoAdapterConfig,
   AnyVideoAdapter,
+  DurationOptions,
 } from './adapter'
 export { BaseVideoAdapter } from './adapter'
+export { snapToDurationOption } from './snap'
diff --git a/packages/typescript/ai/src/activities/generateVideo/snap.ts b/packages/typescript/ai/src/activities/generateVideo/snap.ts
new file mode 100644
index 000000000..0ba1646e4
--- /dev/null
+++ b/packages/typescript/ai/src/activities/generateVideo/snap.ts
@@ -0,0 +1,99 @@
+import type { DurationOptions } from './adapter'
+
+/**
+ * Extract a numeric seconds value from a `DurationOptions` entry. Returns
+ * `null` for entries that don't parse as a number — e.g. `'auto'`.
+ *
+ * Handles the keyword-with-unit form FAL uses for Luma/Veo (`'8s'`, `'9s'`)
+ * by stripping a trailing `s`. Pure-numeric strings (`'5'`, `'10'`) parse via
+ * Number(). Numbers pass through.
+ */
+function entryToSeconds(entry: string | number): number | null {
+  if (typeof entry === 'number') {
+    return Number.isFinite(entry) ? entry : null
+  }
+  const stripped = entry.endsWith('s') ? entry.slice(0, -1) : entry
+  const parsed = Number(stripped)
+  return Number.isFinite(parsed) ? parsed : null
+}
+
+/**
+ * Snap a raw seconds value to the closest valid duration for a model's
+ * `DurationOptions`.
+ *
+ * - `none`            → `undefined`
+ * - `discrete`        → closest numeric-parseable entry; if none parse,
+ *                       returns `values[0]` (keyword-only models like 'auto')
+ * - `range`           → clamped to [min, max] and rounded to `step` (default 1)
+ * - `mixed`           → closest of (discrete numerics ∪ range values)
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export function snapToDurationOption<T extends string | number | undefined>(
+  seconds: number,
+  options: DurationOptions<T>,
+): T | undefined {
+  switch (options.kind) {
+    case 'none':
+      return undefined
+
+    case 'discrete': {
+      return pickClosestDiscrete(seconds, options.values) as T
+    }
+
+    case 'range': {
+      const step = options.step ?? 1
+      const clamped = Math.min(options.max, Math.max(options.min, seconds))
+      const snapped = Math.round((clamped - options.min) / step) * step + options.min
+      return Math.min(options.max, Math.max(options.min, snapped)) as T
+    }
+
+    case 'mixed': {
+      const discreteCandidate = pickClosestDiscrete(seconds, options.values)
+      if (!options.range) return discreteCandidate as T
+
+      const { min, max, step = 1 } = options.range
+      const clamped = Math.min(max, Math.max(min, seconds))
+      const rangeValue = Math.min(
+        max,
+        Math.max(min, Math.round((clamped - min) / step) * step + min),
+      )
+
+      // Compare distance; range value is numeric, discrete may have non-numeric
+      // first-entry fallback (return distance Infinity for non-numerics).
+      const discreteSeconds =
+        typeof discreteCandidate === 'number'
+          ? discreteCandidate
+          : discreteCandidate !== undefined
+            ? (entryToSeconds(discreteCandidate as string | number) ?? Infinity)
+            : Infinity
+
+      return Math.abs(discreteSeconds - seconds) <=
+        Math.abs(rangeValue - seconds)
+        ? (discreteCandidate as T)
+        : (rangeValue as T)
+    }
+  }
+}
+
+function pickClosestDiscrete<T extends string | number>(
+  seconds: number,
+  values: ReadonlyArray<T>,
+): T | undefined {
+  if (values.length === 0) return undefined
+
+  let best: T | undefined
+  let bestDistance = Infinity
+  for (const value of values) {
+    const v = entryToSeconds(value)
+    if (v === null) continue
+    const distance = Math.abs(v - seconds)
+    if (distance < bestDistance) {
+      bestDistance = distance
+      best = value
+    }
+  }
+
+  // Keyword-only set (no numeric-parseable entries) — fall back to first entry.
+  return best ?? values[0]
+}
diff --git a/packages/typescript/ai/src/activities/index.ts b/packages/typescript/ai/src/activities/index.ts
index 69d06be22..0aab73bd1 100644
--- a/packages/typescript/ai/src/activities/index.ts
+++ b/packages/typescript/ai/src/activities/index.ts
@@ -126,7 +126,9 @@ export {
   type VideoAdapter,
   type VideoAdapterConfig,
   type AnyVideoAdapter,
+  type DurationOptions,
 } from './generateVideo/adapter'
+export { snapToDurationOption } from './generateVideo/snap'
 
 // ===========================
 // TTS Activity
diff --git a/packages/typescript/ai/src/types.ts b/packages/typescript/ai/src/types.ts
index 9566cb32f..cedb7a769 100644
--- a/packages/typescript/ai/src/types.ts
+++ b/packages/typescript/ai/src/types.ts
@@ -1547,6 +1547,7 @@ export interface AudioGenerationResult {
 export interface VideoGenerationOptions<
   TProviderOptions extends object = object,
   TSize extends string | undefined = string,
+  TDuration extends string | number | undefined = string | number | undefined,
 > {
   /** The model to use for video generation */
   model: string
@@ -1554,8 +1555,13 @@ export interface VideoGenerationOptions<
   prompt: string
   /** Video size — format depends on the provider (e.g., "16:9", "1280x720") */
   size?: TSize
-  /** Video duration in seconds */
-  duration?: number
+  /**
+   * Video duration — exact shape is per-model and may be a number of seconds,
+   * a string enum like '4' | '8' | '12', or a keyword like '8s' depending on
+   * the adapter. Use `adapter.snapDuration(seconds)` to coerce raw seconds to
+   * a valid value.
+   */
+  duration?: TDuration
   /** Model-specific options for video generation */
   modelOptions?: TProviderOptions
   /**
diff --git a/packages/typescript/ai/tests/snap.test.ts b/packages/typescript/ai/tests/snap.test.ts
new file mode 100644
index 000000000..f09a4028c
--- /dev/null
+++ b/packages/typescript/ai/tests/snap.test.ts
@@ -0,0 +1,38 @@
+import { describe, expect, it } from 'vitest'
+import { snapToDurationOption } from '../src/activities/generateVideo/snap'
+
+describe('snapToDurationOption', () => {
+  it('returns undefined for kind: none', () => {
+    expect(snapToDurationOption(7, { kind: 'none' })).toBeUndefined()
+  })
+
+  it('picks closest discrete numeric-string entry (Kling: 5 | 10)', () => {
+    const opts = { kind: 'discrete', values: ['5', '10'] } as const
+    expect(snapToDurationOption(7, opts)).toBe('5')
+    expect(snapToDurationOption(8, opts)).toBe('10')
+  })
+
+  it('preserves the keyword-with-unit form (Veo3: 4s | 6s | 8s)', () => {
+    const opts = { kind: 'discrete', values: ['4s', '6s', '8s'] } as const
+    expect(snapToDurationOption(7, opts)).toBe('6s')
+    expect(snapToDurationOption(9, opts)).toBe('8s')
+  })
+
+  it('clamps + rounds to step on kind: range', () => {
+    const opts = {
+      kind: 'range',
+      min: 2,
+      max: 15,
+      step: 1,
+      unit: 'seconds',
+    } as const
+    expect(snapToDurationOption(7, opts)).toBe(7)
+    expect(snapToDurationOption(100, opts)).toBe(15)
+    expect(snapToDurationOption(0, opts)).toBe(2)
+  })
+
+  it('falls back to first entry for keyword-only discrete sets', () => {
+    const opts = { kind: 'discrete', values: ['auto'] } as const
+    expect(snapToDurationOption(7, opts)).toBe('auto')
+  })
+})
diff --git a/packages/typescript/ai/tests/stream-generation.test.ts b/packages/typescript/ai/tests/stream-generation.test.ts
index 155b10d65..e530f8c23 100644
--- a/packages/typescript/ai/tests/stream-generation.test.ts
+++ b/packages/typescript/ai/tests/stream-generation.test.ts
@@ -203,6 +203,9 @@ describe('generateVideo({ stream: true })', () => {
         url: 'https://example.com/video.mp4',
         expiresAt: new Date('2030-01-01'),
       })),
+
+      availableDurations: () => ({ kind: 'none' as const }),
+      snapDuration: (_seconds: number) => undefined,
     }
   }
 

From a4ed1b6e94df9167e16932b0ff7827190f4a8b1d Mon Sep 17 00:00:00 2001
From: "autofix-ci[bot]" <114827586+autofix-ci[bot]@users.noreply.github.com>
Date: Tue, 26 May 2026 04:24:29 +0000
Subject: [PATCH 10/10] ci: apply automated fixes

---
 .../typescript/ai-fal/src/adapters/video.ts     | 11 ++++++-----
 .../ai-fal/src/video/video-provider-options.ts  | 17 ++++++++++++++++-
 .../ai/src/activities/generateVideo/adapter.ts  | 12 ++++--------
 .../ai/src/activities/generateVideo/index.ts    |  8 +-------
 .../ai/src/activities/generateVideo/snap.ts     |  3 ++-
 5 files changed, 29 insertions(+), 22 deletions(-)

diff --git a/packages/typescript/ai-fal/src/adapters/video.ts b/packages/typescript/ai-fal/src/adapters/video.ts
index c47685676..7bb5cff9e 100644
--- a/packages/typescript/ai-fal/src/adapters/video.ts
+++ b/packages/typescript/ai-fal/src/adapters/video.ts
@@ -128,7 +128,9 @@ export class FalVideoAdapter<TModel extends FalModel> extends BaseVideoAdapter<
     }
   }
 
-  override availableDurations(): DurationOptions<FalModelVideoDuration<TModel>> {
+  override availableDurations(): DurationOptions<
+    FalModelVideoDuration<TModel>
+  > {
     return getFalVideoDurationOptions(this.model) as DurationOptions<
       FalModelVideoDuration<TModel>
     >
@@ -137,10 +139,9 @@ export class FalVideoAdapter<TModel extends FalModel> extends BaseVideoAdapter<
   override snapDuration(
     seconds: number,
   ): FalModelVideoDuration<TModel> | undefined {
-    return snapToDurationOption(
-      seconds,
-      this.availableDurations(),
-    ) as FalModelVideoDuration<TModel> | undefined
+    return snapToDurationOption(seconds, this.availableDurations()) as
+      | FalModelVideoDuration<TModel>
+      | undefined
   }
 
   async getVideoStatus(jobId: string): Promise<VideoStatusResult> {
diff --git a/packages/typescript/ai-fal/src/video/video-provider-options.ts b/packages/typescript/ai-fal/src/video/video-provider-options.ts
index a8c2d3816..7344c5c7f 100644
--- a/packages/typescript/ai-fal/src/video/video-provider-options.ts
+++ b/packages/typescript/ai-fal/src/video/video-provider-options.ts
@@ -65,7 +65,22 @@ const FAL_VIDEO_DURATIONS: Readonly<
   },
   'fal-ai/wan-25-preview/text-to-video': {
     kind: 'discrete',
-    values: ['2', '3', '4', '5', '6', '7', '8', '9', '10', '11', '12', '13', '14', '15'],
+    values: [
+      '2',
+      '3',
+      '4',
+      '5',
+      '6',
+      '7',
+      '8',
+      '9',
+      '10',
+      '11',
+      '12',
+      '13',
+      '14',
+      '15',
+    ],
   },
   'fal-ai/minimax/video-01': { kind: 'none' },
   'fal-ai/hunyuan-video-v1.5/text-to-video': { kind: 'none' },
diff --git a/packages/typescript/ai/src/activities/generateVideo/adapter.ts b/packages/typescript/ai/src/activities/generateVideo/adapter.ts
index 00bd6b58a..af2dda32e 100644
--- a/packages/typescript/ai/src/activities/generateVideo/adapter.ts
+++ b/packages/typescript/ai/src/activities/generateVideo/adapter.ts
@@ -59,10 +59,8 @@ export interface VideoAdapter<
     string,
     string
   >,
-  TModelDurationByName extends Record<
-    string,
-    string | number | undefined
-  > = Record<string, string | number | undefined>,
+  TModelDurationByName extends Record<string, string | number | undefined> =
+    Record<string, string | number | undefined>,
 > {
   /** Discriminator for adapter kind - used to determine API shape */
   readonly kind: 'video'
@@ -140,10 +138,8 @@ export abstract class BaseVideoAdapter<
     string,
     string
   >,
-  TModelDurationByName extends Record<
-    string,
-    string | number | undefined
-  > = Record<string, string | number | undefined>,
+  TModelDurationByName extends Record<string, string | number | undefined> =
+    Record<string, string | number | undefined>,
 > implements VideoAdapter<
   TModel,
   TProviderOptions,
diff --git a/packages/typescript/ai/src/activities/generateVideo/index.ts b/packages/typescript/ai/src/activities/generateVideo/index.ts
index cdd38d01c..e19500bb6 100644
--- a/packages/typescript/ai/src/activities/generateVideo/index.ts
+++ b/packages/typescript/ai/src/activities/generateVideo/index.ts
@@ -55,13 +55,7 @@ export type VideoSizeForAdapter<TAdapter> =
  * for adapters that haven't declared per-model duration constraints.
  */
 export type VideoDurationForAdapter<TAdapter> =
-  TAdapter extends VideoAdapter<
-    infer TModel,
-    any,
-    any,
-    any,
-    infer TDurationMap
-  >
+  TAdapter extends VideoAdapter<infer TModel, any, any, any, infer TDurationMap>
     ? TModel extends keyof TDurationMap
       ? TDurationMap[TModel]
       : string | number | undefined
diff --git a/packages/typescript/ai/src/activities/generateVideo/snap.ts b/packages/typescript/ai/src/activities/generateVideo/snap.ts
index 0ba1646e4..1c8fb39ab 100644
--- a/packages/typescript/ai/src/activities/generateVideo/snap.ts
+++ b/packages/typescript/ai/src/activities/generateVideo/snap.ts
@@ -44,7 +44,8 @@ export function snapToDurationOption<T extends string | number | undefined>(
     case 'range': {
       const step = options.step ?? 1
       const clamped = Math.min(options.max, Math.max(options.min, seconds))
-      const snapped = Math.round((clamped - options.min) / step) * step + options.min
+      const snapped =
+        Math.round((clamped - options.min) / step) * step + options.min
       return Math.min(options.max, Math.max(options.min, snapped)) as T
     }