@tanstack/ai 0.45.0 → 0.46.0

package/README.md

@@ -36,6 +36,14 @@
   </a>
 </div>
 
+<br />
+
+<div align="center">
+  <a href="https://tanstack.com/blog/tanstack-open-source-awards-2026">
+    <img src="https://raw.githubusercontent.com/TanStack/ai/16826d81cade868956df240d6239a671e689193c/media/js-open-source-award-2026-ai-project-of-the-year.svg" alt="Winner of the 2026 JavaScript Open Source Award for AI Project of the Year" width="250" />
+  </a>
+</div>
+
 # TanStack AI
 
 Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
@@ -191,7 +199,7 @@ Learn more in the
   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) -
+- [Code Mode with Snippets](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-snippets) -
   give Code Mode reusable runtime capabilities.
 
 ## Providers
@@ -208,6 +216,7 @@ Official adapters include:
 | [`@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                   |
 
 The adapter system is tree-shakeable by activity. Import `openaiText` for chat,

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

@@ -15,9 +15,10 @@ import { INTERRUPT_BINDING_METADATA_KEY, InterruptResumeValidationError, readUno
 import { normalizeToolResult } from "../../utilities/tool-result.js";
 import { isProviderExecutedToolCall } from "../../utilities/provider-executed.js";
 import { LazyToolManager } from "./tools/lazy-tool-manager.js";
+import { assertUniqueToolNames } from "./tools/unique-tool-names.js";
 import { MiddlewareAbortError, ToolCallManager, executeToolCalls } from "./tools/tool-calls.js";
 import { maxIterations } from "./agent-loop-strategies.js";
-import { convertMessagesToModelMessages, generateMessageId } from "./messages.js";
+import { convertMessagesToModelMessages, generateMessageId, modelMessageToUIMessage } from "./messages.js";
 import { MiddlewareRunner } from "./middleware/compose.js";
 import { provideSandboxRuntime } from "./middleware/sandbox-runtime.js";
 import { provideRunDisconnect } from "./middleware/run-disconnect.js";
@@ -148,9 +149,11 @@ var TextEngine = class {
 	accumulatedThinking = [];
 	currentThinkingContent = "";
 	currentThinkingSignature = "";
+	hasSeenReasoningEvents = false;
 	eventOptions;
 	eventToolNames;
 	finishedEvent = null;
+	streamedToolErrorResults = /* @__PURE__ */ new Map();
 	deferredToolCallRunFinishedChunks = [];
 	earlyTermination = false;
 	toolPhase = "continue";
@@ -201,6 +204,7 @@ var TextEngine = class {
 		this.initialApprovals = approvals;
 		this.initialClientToolResults = clientToolResults;
 		this.messages = convertMessagesToModelMessages(config.params.messages);
+		assertUniqueToolNames(config.params.tools || []);
 		this.lazyToolManager = new LazyToolManager(config.params.tools || [], this.messages, config.params.lazyToolsConfig);
 		this.tools = this.lazyToolManager.getActiveTools();
 		this.toolCallManager = new ToolCallManager(this.tools);
@@ -354,6 +358,7 @@ var TextEngine = class {
 						duration: Date.now() - this.streamStartTime
 					});
 				} else {
+					this.addTerminalReasoningMessage();
 					this.terminalHookCalled = true;
 					await this.middlewareRunner.runOnFinish(this.middlewareCtx, {
 						finishReason: this.lastFinishReason,
@@ -457,7 +462,9 @@ var TextEngine = class {
 		this.accumulatedThinking = [];
 		this.currentThinkingContent = "";
 		this.currentThinkingSignature = "";
+		this.hasSeenReasoningEvents = false;
 		this.finishedEvent = null;
+		this.streamedToolErrorResults.clear();
 		this.middlewareCtx.currentMessageId = this.currentMessageId;
 		this.middlewareCtx.accumulatedContent = "";
 		await this.middlewareRunner.runOnIteration(this.middlewareCtx, {
@@ -591,7 +598,10 @@ var TextEngine = class {
 			case "STEP_STARTED":
 				this.handleStepStartedEvent();
 				break;
-			case "STEP_FINISHED": this.handleStepFinishedEvent(chunk);
+			case "STEP_FINISHED":
+				this.handleStepFinishedEvent(chunk);
+				break;
+			case "REASONING_MESSAGE_CONTENT": this.handleReasoningMessageContentEvent(chunk);
 		}
 	}
 	handleTextMessageContentEvent(chunk) {
@@ -616,6 +626,16 @@ var TextEngine = class {
 	}
 	handleToolCallEndEvent(chunk) {
 		this.toolCallManager.completeToolCall(chunk);
+		if (chunk.state !== "output-error" || chunk.result === void 0) return;
+		const toolCall = this.toolCallManager.getToolCalls().find((candidate) => candidate.id === chunk.toolCallId);
+		if (!toolCall) return;
+		this.streamedToolErrorResults.set(chunk.toolCallId, {
+			toolCallId: chunk.toolCallId,
+			toolName: toolCall.function.name,
+			result: chunk.result,
+			...chunk.input !== void 0 && { input: chunk.input },
+			state: "output-error"
+		});
 	}
 	handleRunFinishedEvent(chunk) {
 		this.finishedEvent = chunk;
@@ -645,9 +665,19 @@ var TextEngine = class {
 		this.finalizeCurrentThinkingStep();
 	}
 	handleStepFinishedEvent(chunk) {
-		if (chunk.delta) this.currentThinkingContent += chunk.delta;
+		if (!this.hasSeenReasoningEvents) {
+			if (chunk.delta) this.currentThinkingContent += chunk.delta;
+			else if (chunk.content) {
+				if (chunk.content.startsWith(this.currentThinkingContent)) this.currentThinkingContent = chunk.content;
+				else if (!this.currentThinkingContent.startsWith(chunk.content)) this.currentThinkingContent += chunk.content;
+			}
+		}
 		if (chunk.signature) this.currentThinkingSignature = chunk.signature;
 	}
+	handleReasoningMessageContentEvent(chunk) {
+		this.hasSeenReasoningEvents = true;
+		this.currentThinkingContent += chunk.delta;
+	}
 	/**
 	* Tools available for execution this turn. The discovery tool is dropped
 	* from the advertised set (`this.tools`) once every lazy tool is discovered,
@@ -751,6 +781,7 @@ var TextEngine = class {
 		this.addAssistantToolCallMessage(toolCalls);
 		const undiscoveredLazyResults = [];
 		const executableToolCalls = toolCalls.filter((tc) => {
+			if (this.streamedToolErrorResults.has(tc.id)) return false;
 			if (this.lazyToolManager.isUndiscoveredLazyTool(tc.function.name)) {
 				undiscoveredLazyResults.push({
 					toolCallId: tc.id,
@@ -762,7 +793,7 @@ var TextEngine = class {
 			}
 			return true;
 		});
-		const deferredErrorResults = [...undiscoveredLazyResults];
+		const deferredErrorResults = [...this.streamedToolErrorResults.values(), ...undiscoveredLazyResults];
 		if (executableToolCalls.length === 0) {
 			yield* this.flushDeferredToolCallRunFinishedChunks();
 			if (deferredErrorResults.length > 0) for (const chunk of this.buildToolResultChunks(deferredErrorResults, finishEvent)) yield* this.pipeThroughMiddleware(chunk);
@@ -858,6 +889,20 @@ var TextEngine = class {
 		}];
 		this.middlewareCtx.messages = this.messages;
 	}
+	addTerminalReasoningMessage() {
+		this.finalizeCurrentThinkingStep();
+		if (this.accumulatedThinking.length === 0) return;
+		const messages = this.middlewareCtx.messages;
+		if (messages.some((message) => message.role === "assistant" && message.id === this.currentMessageId)) return;
+		this.messages = [...messages, {
+			role: "assistant",
+			content: this.accumulatedContent || null,
+			id: this.currentMessageId ?? void 0,
+			createdAt: this.currentMessageCreatedAt ?? void 0,
+			thinking: this.accumulatedThinking
+		}];
+		this.middlewareCtx.messages = this.messages;
+	}
 	/**
 	* Extract client state (approvals and client tool results) from original messages.
 	* This is called in the constructor BEFORE converting to ModelMessage format,
@@ -967,10 +1012,13 @@ var TextEngine = class {
 	buildMessagesSnapshotChunk() {
 		const messages = this.messages.map((message, index) => {
 			const content = typeof message.content === "string" ? message.content : message.content === null ? void 0 : JSON.stringify(message.content);
+			const id = message.id || `snapshot_${this.runIdOverride ?? this.requestId}_${index}`;
+			const parts = message.role === "assistant" && message.thinking?.length ? modelMessageToUIMessage(message, id).parts : void 0;
 			return {
-				id: message.id || `snapshot_${this.runIdOverride ?? this.requestId}_${index}`,
+				id,
 				role: message.role,
 				...content !== void 0 ? { content } : {},
+				...parts ? { parts } : {},
 				..."toolCalls" in message && message.toolCalls ? { toolCalls: message.toolCalls } : {},
 				..."toolCallId" in message && message.toolCallId ? { toolCallId: message.toolCallId } : {}
 			};
@@ -1742,6 +1790,7 @@ var TextEngine = class {
 		this.applyResumeToolState(config.resumeToolState);
 		this.messages = config.messages;
 		this.systemPrompts = config.systemPrompts;
+		assertUniqueToolNames(config.tools);
 		this.tools = config.tools;
 		this.params = {
 			...this.params,
@@ -1866,6 +1915,7 @@ var TextEngine = class {
 */
 function chat(options) {
 	validateCapabilities(options.middleware ?? [], options.adapter);
+	if (options.tools) assertUniqueToolNames(options.tools);
 	const { outputSchema, stream } = options;
 	if (outputSchema && stream === true) return runStreamingStructuredOutput({
 		...options,