Merge branch 'main' into main

Author: AlemTuzlak

.changeset/fix-null-tool-input-normalization.md

@@ -2,6 +2,15 @@
 title: Anthropic
 id: anthropic-adapter
 order: 2
+description: "Use Anthropic Claude models with TanStack AI — Claude Sonnet 4.5, Claude Opus, and more via the @tanstack/ai-anthropic adapter."
+keywords:
+  - tanstack ai
+  - anthropic
+  - claude
+  - claude sonnet 4.5
+  - claude opus
+  - adapter
+  - llm
 ---
 
 The Anthropic adapter provides access to Claude models, including Claude Sonnet 4.5, Claude Opus 4.5, and more.
@@ -228,3 +237,198 @@ Creates an Anthropic summarization adapter with an explicit API key.
 - [Getting Started](../getting-started/quick-start) - Learn the basics
 - [Tools Guide](../tools/tools) - Learn about tools
 - [Other Adapters](./openai) - Explore other providers
+
+## Provider Tools
+
+Anthropic exposes several native tools beyond user-defined function calls.
+Import them from `@tanstack/ai-anthropic/tools` and pass them into
+`chat({ tools: [...] })`.
+
+> For the full concept, a comparison matrix, and type-gating details, see
+> [Provider Tools](../tools/provider-tools.md).
+
+### `webSearchTool`
+
+Enables Claude to run Anthropic's native web search with inline citations.
+Scope the search with `allowed_domains` or `blocked_domains` (mutually
+exclusive); set `max_uses` to cap per-turn cost.
+
+```typescript
+import { chat } from "@tanstack/ai";
+import { anthropicText } from "@tanstack/ai-anthropic";
+import { webSearchTool } from "@tanstack/ai-anthropic/tools";
+
+const stream = chat({
+  adapter: anthropicText("claude-opus-4-6"),
+  messages: [{ role: "user", content: "What's new in AI this week?" }],
+  tools: [
+    webSearchTool({
+      name: "web_search",
+      type: "web_search_20250305",
+      max_uses: 2,
+    }),
+  ],
+});
+```
+
+**Supported models:** every current Claude model. `claude-3-haiku` supports
+only `web_search` (not `web_fetch`). See [Provider Tools](../tools/provider-tools.md#which-models-support-which-tools).
+
+### `webFetchTool`
+
+Lets Claude fetch the contents of a URL directly, useful when you want the
+model to read a specific page rather than run a search. Takes no required
+arguments — pass an optional config object to override defaults.
+
+```typescript
+import { chat } from "@tanstack/ai";
+import { anthropicText } from "@tanstack/ai-anthropic";
+import { webFetchTool } from "@tanstack/ai-anthropic/tools";
+
+const stream = chat({
+  adapter: anthropicText("claude-sonnet-4-5"),
+  messages: [{ role: "user", content: "Summarise https://example.com" }],
+  tools: [webFetchTool()],
+});
+```
+
+**Supported models:** Claude Sonnet 4.x and above. See [Provider Tools](../tools/provider-tools.md#which-models-support-which-tools).
+
+### `codeExecutionTool`
+
+Gives Claude a sandboxed code-execution environment so it can run Python
+snippets, analyse data, and return results inline. Choose the version string
+that matches your desired API revision.
+
+```typescript
+import { chat } from "@tanstack/ai";
+import { anthropicText } from "@tanstack/ai-anthropic";
+import { codeExecutionTool } from "@tanstack/ai-anthropic/tools";
+
+const stream = chat({
+  adapter: anthropicText("claude-sonnet-4-5"),
+  messages: [{ role: "user", content: "Plot a histogram of [1,2,2,3,3,3]" }],
+  tools: [
+    codeExecutionTool({ name: "code_execution", type: "code_execution_20250825" }),
+  ],
+});
+```
+
+**Supported models:** Claude Sonnet 4.x and above. See [Provider Tools](../tools/provider-tools.md#which-models-support-which-tools).
+
+### `computerUseTool`
+
+Allows Claude to observe a virtual desktop (screenshots) and interact with it
+via keyboard and mouse events. Provide the screen resolution so Claude can
+calculate accurate coordinates.
+
+```typescript
+import { chat } from "@tanstack/ai";
+import { anthropicText } from "@tanstack/ai-anthropic";
+import { computerUseTool } from "@tanstack/ai-anthropic/tools";
+
+const stream = chat({
+  adapter: anthropicText("claude-sonnet-4-5"),
+  messages: [{ role: "user", content: "Open the browser and go to example.com" }],
+  tools: [
+    computerUseTool({
+      type: "computer_20250124",
+      name: "computer",
+      display_width_px: 1024,
+      display_height_px: 768,
+    }),
+  ],
+});
+```
+
+**Supported models:** Claude Sonnet 3.5 and above. See [Provider Tools](../tools/provider-tools.md#which-models-support-which-tools).
+
+### `bashTool`
+
+Provides Claude with a persistent bash shell session, letting it run arbitrary
+commands, install packages, or manipulate files on the host. Choose the type
+string that matches your API revision.
+
+```typescript
+import { chat } from "@tanstack/ai";
+import { anthropicText } from "@tanstack/ai-anthropic";
+import { bashTool } from "@tanstack/ai-anthropic/tools";
+
+const stream = chat({
+  adapter: anthropicText("claude-sonnet-4-5"),
+  messages: [{ role: "user", content: "List all TypeScript files in src/" }],
+  tools: [bashTool({ name: "bash", type: "bash_20250124" })],
+});
+```
+
+**Supported models:** Claude Sonnet 3.5 and above. See [Provider Tools](../tools/provider-tools.md#which-models-support-which-tools).
+
+### `textEditorTool`
+
+Gives Claude a structured text-editor interface for viewing and modifying files
+using `str_replace`, `create`, `view`, and `undo_edit` commands. Choose the
+type string for the API revision you target.
+
+```typescript
+import { chat } from "@tanstack/ai";
+import { anthropicText } from "@tanstack/ai-anthropic";
+import { textEditorTool } from "@tanstack/ai-anthropic/tools";
+
+const stream = chat({
+  adapter: anthropicText("claude-sonnet-4-5"),
+  messages: [{ role: "user", content: "Fix the bug in src/index.ts" }],
+  tools: [
+    textEditorTool({ type: "text_editor_20250124", name: "str_replace_editor" }),
+  ],
+});
+```
+
+**Supported models:** Claude Sonnet 3.5 and above. See [Provider Tools](../tools/provider-tools.md#which-models-support-which-tools).
+
+### `memoryTool`
+
+Enables Claude to store and retrieve information across conversation turns
+using Anthropic's managed memory service. Call with no arguments to use
+default configuration.
+
+```typescript
+import { chat } from "@tanstack/ai";
+import { anthropicText } from "@tanstack/ai-anthropic";
+import { memoryTool } from "@tanstack/ai-anthropic/tools";
+
+const stream = chat({
+  adapter: anthropicText("claude-sonnet-4-5"),
+  messages: [{ role: "user", content: "Remember that I prefer metric units" }],
+  tools: [memoryTool()],
+});
+```
+
+**Supported models:** Claude Sonnet 4.x and above. See [Provider Tools](../tools/provider-tools.md#which-models-support-which-tools).
+
+### `customTool`
+
+Creates a tool with an inline JSON Schema input definition instead of going
+through `toolDefinition()`. Useful when you need fine-grained control over the
+schema shape or want to add `cache_control`. Unlike branded provider tools,
+`customTool` returns a plain `Tool` and is accepted by any chat model.
+
+```typescript
+import { chat } from "@tanstack/ai";
+import { anthropicText } from "@tanstack/ai-anthropic";
+import { customTool } from "@tanstack/ai-anthropic/tools";
+import { z } from "zod";
+
+const stream = chat({
+  adapter: anthropicText("claude-sonnet-4-5"),
+  messages: [{ role: "user", content: "Look up user 42" }],
+  tools: [
+    customTool(
+      "lookup_user",
+      "Look up a user by ID and return their profile",
+      z.object({ userId: z.number() }),
+    ),
+  ],
+});
+```
+
+**Supported models:** all current Claude models. See [Provider Tools](../tools/provider-tools.md#which-models-support-which-tools).

.changeset/sync-models.md

@@ -2,6 +2,15 @@
 title: ElevenLabs
 id: elevenlabs-adapter
 order: 9
+description: "Build realtime voice-to-voice conversational AI with ElevenLabs agents in TanStack AI via the @tanstack/ai-elevenlabs adapter."
+keywords:
+  - tanstack ai
+  - elevenlabs
+  - realtime voice ai
+  - conversational ai
+  - voice chat
+  - voice agents
+  - adapter
 ---
 
 The ElevenLabs adapter provides realtime conversational voice AI for TanStack AI. Unlike text-focused adapters, the ElevenLabs adapter is **voice-focused** -- it integrates with TanStack AI's realtime system to enable voice-to-voice conversations. It does not support `chat()`, `embedding()`, or `summarize()`.

docs/adapters/anthropic.md

@@ -1,6 +1,16 @@
 ---
 title: fal.ai
 id: fal-adapter
+description: "Generate images and videos with 600+ models on fal.ai using TanStack AI — Nano Banana Pro, FLUX, and more via the @tanstack/ai-fal adapter."
+keywords:
+  - tanstack ai
+  - fal.ai
+  - fal
+  - image generation
+  - video generation
+  - flux
+  - nano banana
+  - adapter
 ---
 
 The fal.ai adapter provides access to 600+ models on the fal.ai platform for image generation and video generation. Unlike text-focused adapters, the fal adapter is **media-focused** — it supports `generateImage()` and `generateVideo()` but does not support `chat()` or tools. Audio and speech support are coming soon.