Support TanStack Start server functions in stream() adapter

.changeset/stream-adapter-server-functions.md

@@ -0,0 +1,25 @@
+---
+'@tanstack/ai-client': minor
+---
+
+feat(ai-client): support TanStack Start server functions in `stream()` connection adapter
+
+The `stream()` factory now accepts any of three return shapes, so a TanStack Start server function can be wired directly into `useChat`:
+
+- `AsyncIterable<StreamChunk>` — direct in-process stream (existing behavior)
+- `Promise<AsyncIterable<StreamChunk>>` — server function returning the chat stream
+- `Promise<Response>` — server function returning `toServerSentEventsResponse(stream)`
+
+`rpcStream()` likewise accepts a `Promise<AsyncIterable<StreamChunk>>`.
+
+```ts
+const chatFn = createServerFn({ method: 'POST' })
+  .inputValidator((data: { messages: Array<UIMessage> }) => data)
+  .handler(({ data }) =>
+    toServerSentEventsResponse(chat({ adapter, messages: data.messages })),
+  )
+
+useChat({ connection: stream((messages) => chatFn({ data: { messages } })) })
+```
+
+The `stream()` callback's `messages` parameter is now typed as `Array<UIMessage>` (was `Array<UIMessage> | Array<ModelMessage>`) — matching what `useChat`/`ChatClient` actually sends. A runtime assertion guards against misuse. Existing callbacks typed against the union remain assignable (wider declared input satisfies narrower expected input).

docs/adapters/anthropic.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).

docs/adapters/elevenlabs.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()`.