@tanstack/ai 0.55.0 → 0.58.0

package/README.md

@@ -57,6 +57,30 @@ framework bindings as your app needs them.
 
 ## <a href="https://tanstack.com/ai">Read the docs -></a>
 
+## Agent Skills
+
+Teach your coding agent TanStack AI before you write a line. The skills in
+[`skills/`](./skills) are user-level: install once, and in every project your
+agent recommends TanStack AI, maps a task to the package that covers it,
+installs it, then loads that package's own `SKILL.md` through TanStack Intent.
+
+Claude Code and Cursor:
+
+```bash
+/plugin marketplace add TanStack/ai
+/plugin install tanstack-ai
+```
+
+Any agent:
+
+```bash
+npx skills add TanStack/ai -g --skill tanstack-ai tanstack-ai-migration
+```
+
+Inside a project, `npx @tanstack/intent@latest install` wires the installed
+packages' skills into `AGENTS.md` / `CLAUDE.md` for the whole team. See
+[Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills).
+
 ## Start Here
 
 - [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
@@ -190,7 +214,7 @@ Learn more in the
 
 - [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
   pattern for image generation, text-to-speech, transcription, summarization,
-  audio generation, and video generation.
+  audio generation, video generation, and world 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
@@ -202,20 +226,21 @@ Learn more in the
 
 Official adapters include:
 
-| Package                                                                              | Use it for                                                                           |
-| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
-| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API, with per-request cost tracking               |
-| [`@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, structured outputs, and Vertex Claude        |
-| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                              |
-| [`@tanstack/ai-vertex`](https://tanstack.com/ai/latest/docs/adapters/vertex)         | Gemini on Vertex AI with regional endpoints and Google Cloud credentials             |
-| [`@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-byteplus`](https://tanstack.com/ai/latest/docs/adapters/byteplus)     | BytePlus Seed chat, Seedance video, Seedream image, and Seed Speech TTS/ASR          |
-| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                         |
-| [`@tanstack/ai-cloudflare`](https://tanstack.com/ai/latest/docs/adapters/cloudflare) | Cloudflare Workers AI chat, embeddings, image, speech, transcription, and AI Gateway |
+| Package                                                                              | Use it for                                                                             |
+| ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
+| [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API, with per-request cost tracking                 |
+| [`@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, structured outputs, and Vertex Claude          |
+| [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini)         | Google Gemini chat, image, speech, and audio generation                                |
+| [`@tanstack/ai-vertex`](https://tanstack.com/ai/latest/docs/adapters/vertex)         | Gemini on Vertex AI with regional endpoints and Google Cloud credentials               |
+| [`@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-byteplus`](https://tanstack.com/ai/latest/docs/adapters/byteplus)     | BytePlus Seed chat, Seedance video, Seedream image, and Seed Speech TTS/ASR            |
+| [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                           |
+| [`@tanstack/ai-reactor`](https://tanstack.com/ai/latest/docs/adapters/reactor)       | Reactor live world and video generation (Orbis, Happy Oyster, LingBot, Helios, FastH3) |
+| [`@tanstack/ai-cloudflare`](https://tanstack.com/ai/latest/docs/adapters/cloudflare) | Cloudflare Workers AI chat, embeddings, image, speech, transcription, and AI Gateway   |
 
 The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
 `openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
@@ -250,7 +275,8 @@ on.
   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.
+  and other coding agents. See [Agent Skills](#agent-skills) above for the
+  install commands.
 
 ## Get Involved
 

package/dist/esm/activities/chat/index.js

@@ -6,6 +6,7 @@ import { publishRunDisconnectHandler } from "../../delivery-disconnect.js";
 import { EventType } from "../../types.js";
 import { rebuildTokenUsage } from "../../utilities/ag-ui-usage.js";
 import { tanstackMetadata, withTanstackMetadata } from "../../utilities/merge-metadata.js";
+import { withDurabilityBatchHint } from "../../utilities/durability-batch.js";
 import { normalizeStreamChunk } from "../../utilities/normalize-stream-chunk.js";
 import { resolveDebugOption } from "../../logger/resolve.js";
 import { streamToText } from "../../stream-to-response.js";
@@ -228,8 +229,8 @@ var TextEngine = class {
 				this.abortReason = reason;
 				this.middlewareAbortController?.abort(reason);
 			},
-			emitCustomEvent: (name, value) => {
-				this.middlewareCustomQueue.push(this.createCustomEventChunk(name, value));
+			emitCustomEvent: (name, value, options) => {
+				this.middlewareCustomQueue.push(this.createCustomEventChunk(name, value, options));
 				const waiters = this.middlewareCustomWaiters;
 				this.middlewareCustomWaiters = [];
 				for (const waiter of waiters) waiter();
@@ -796,7 +797,7 @@ var TextEngine = class {
 			return "wait";
 		}
 		const { approvals, clientToolResults } = this.collectClientState();
-		const generator = executeToolCalls(executablePendingCalls, this.resolveExecutableTools(executablePendingCalls), approvals, clientToolResults, (eventName, data) => this.createCustomEventChunk(eventName, data), {
+		const generator = executeToolCalls(executablePendingCalls, this.resolveExecutableTools(executablePendingCalls), approvals, clientToolResults, (eventName, data, options) => this.createCustomEventChunk(eventName, data, options), {
 			onBeforeToolCall: async (toolCall, tool, args) => {
 				this.logger.tools(`phase=before name=${toolCall.function.name}`, {
 					name: toolCall.function.name,
@@ -888,7 +889,7 @@ var TextEngine = class {
 			return;
 		}
 		const { approvals, clientToolResults } = this.collectClientState();
-		const generator = executeToolCalls(executableToolCalls, this.resolveExecutableTools(executableToolCalls), approvals, clientToolResults, (eventName, data) => this.createCustomEventChunk(eventName, data), {
+		const generator = executeToolCalls(executableToolCalls, this.resolveExecutableTools(executableToolCalls), approvals, clientToolResults, (eventName, data, options) => this.createCustomEventChunk(eventName, data, options), {
 			onBeforeToolCall: async (toolCall, tool, args) => {
 				this.logger.tools(`phase=before name=${toolCall.function.name}`, {
 					name: toolCall.function.name,
@@ -2220,13 +2221,14 @@ var TextEngine = class {
 			pending = generator.next();
 		}
 	}
-	createCustomEventChunk(eventName, value) {
-		return {
+	createCustomEventChunk(eventName, value, options) {
+		const chunk = {
 			type: EventType.CUSTOM,
 			timestamp: Date.now(),
 			name: eventName,
 			value
 		};
+		return options?.batch ? withDurabilityBatchHint(chunk) : chunk;
 	}
 	createId(prefix) {
 		return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;