@tanstack/ai-client 0.25.1 → 0.26.0

package/README.md

@@ -210,8 +210,9 @@ Official adapters include:
 | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
 | [`@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, and structured outputs                 |
+| [`@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                                                     |

package/dist/esm/chat-client.d.ts

@@ -378,8 +378,8 @@ export declare class ChatClient<TTools extends ReadonlyArray<AnyClientTool> = an
     private decideWhenBusy;
     private enqueueMessage;
     /**
-     * Normalize the message input to extract content and optional id.
-     * Trims string content automatically.
+     * Normalize the message input to extract content, optional id, and
+     * optional metadata. String form has no metadata. Trims string content.
      */
     private normalizeMessageInput;
     /**

package/dist/esm/chat-client.js

@@ -1,9 +1,9 @@
 import { createNoOpChatDevtoolsBridge } from "./devtools-noop.js";
-import { fetcherToConnectionAdapter, getChunkRunId, normalizeConnectionAdapter } from "./connection-adapters.js";
+import { fetcherToConnectionAdapter, getChunkRunId as getChunkRunId$1, normalizeConnectionAdapter } from "./connection-adapters.js";
 import { ChatPersistor } from "./client-persistor.js";
 import { ClearedStreamTracker } from "./cleared-stream-tracker.js";
 import { InterruptManager } from "./interrupt-manager.js";
-import { StreamProcessor, convertSchemaToJsonSchema, generateMessageId, isStandardSchema, normalizeToUIMessage, parseWithStandardSchema } from "@tanstack/ai/client";
+import { StreamProcessor, convertSchemaToJsonSchema, generateMessageId, isStandardSchema, mergeMetadata, normalizeToUIMessage, parseWithStandardSchema, restoreInboundChunk, tanstackMetadata } from "@tanstack/ai/client";
 //#region src/chat-client.ts
 function assertUniqueInterruptDefinitions(interrupts) {
 	const ids = /* @__PURE__ */ new Set();
@@ -49,6 +49,7 @@ function normalizeQueueOption(option) {
 * Merge a run of queued messages into a single send for `drain: 'batch'`.
 * All-string content is joined with newlines; mixed/multimodal content is
 * flattened into a single `ContentPart` array. The last item's `body` wins.
+* Object-form metadata is merged last-write-wins per key.
 */
 function mergeQueuedMessages(items) {
 	const body = items.at(-1)?.body;
@@ -62,17 +63,27 @@ function mergeQueuedMessages(items) {
 		...body !== void 0 ? { body } : {}
 	};
 	const parts = [];
-	for (const item of items) if (typeof item.content === "string") parts.push({
-		type: "text",
-		content: item.content
-	});
-	else if (typeof item.content.content === "string") parts.push({
-		type: "text",
-		content: item.content.content
-	});
-	else parts.push(...item.content.content);
+	let metadata;
+	for (const item of items) {
+		if (typeof item.content === "string") {
+			parts.push({
+				type: "text",
+				content: item.content
+			});
+			continue;
+		}
+		if (typeof item.content.content === "string") parts.push({
+			type: "text",
+			content: item.content.content
+		});
+		else parts.push(...item.content.content);
+		metadata = mergeMetadata(metadata, item.content.metadata);
+	}
 	return {
-		content: { content: parts },
+		content: {
+			content: parts,
+			...metadata !== void 0 ? { metadata } : {}
+		},
 		...body !== void 0 ? { body } : {}
 	};
 }
@@ -511,15 +522,15 @@ var ChatClient = class {
 	}
 	retireIgnoredClearedTerminalChunk(chunk) {
 		if (chunk.type !== "RUN_FINISHED" && chunk.type !== "RUN_ERROR") return;
-		const runId = getChunkRunId(chunk) ?? this.clearedStreamTracker.takeRunlessRunId();
+		const runId = getChunkRunId$1(chunk) ?? this.clearedStreamTracker.takeRunlessRunId();
 		if (!runId) return;
 		this.activeRunIds.delete(runId);
 		this.setSessionGenerating(this.activeRunIds.size > 0);
-		if (!getChunkRunId(chunk)) this.resolveProcessing();
+		if (!getChunkRunId$1(chunk)) this.resolveProcessing();
 	}
 	updateRunLifecycle(chunk, options) {
 		if (chunk.type === "RUN_STARTED") {
-			const chunkRunId = getChunkRunId(chunk) ?? chunk.runId;
+			const chunkRunId = getChunkRunId$1(chunk) ?? chunk.runId;
 			this.activeResumeThreadId = "threadId" in chunk && typeof chunk.threadId === "string" ? chunk.threadId : this.activeResumeThreadId;
 			this.activeResumeRunId = chunkRunId;
 			this.activeRunIds.add(chunkRunId);
@@ -532,7 +543,7 @@ var ChatClient = class {
 			return;
 		}
 		if (chunk.type !== "RUN_FINISHED" && chunk.type !== "RUN_ERROR") return;
-		const runId = getChunkRunId(chunk);
+		const runId = getChunkRunId$1(chunk);
 		if (runId) {
 			this.activeRunIds.delete(runId);
 			this.clearedStreamTracker.onRunSettled(runId);
@@ -552,7 +563,7 @@ var ChatClient = class {
 	observeInterruptState(chunk) {
 		if (chunk.type !== "RUN_FINISHED" && chunk.type !== "RUN_ERROR") return;
 		if (this.activeInterruptSubmission && chunk.type === "RUN_ERROR") return;
-		const runId = getChunkRunId(chunk);
+		const runId = getChunkRunId$1(chunk);
 		const threadId = "threadId" in chunk && typeof chunk.threadId === "string" ? chunk.threadId : this.activeResumeThreadId;
 		if (chunk.type === "RUN_FINISHED" && chunk.outcome?.type === "interrupt") {
 			const interruptedRunId = this.currentRunId ?? runId ?? this.activeResumeRunId ?? "";
@@ -943,11 +954,15 @@ var ChatClient = class {
 		if (last && last.role === "assistant") this.processor.setMessages(messages.slice(0, -1));
 	}
 	async processIncomingChunk(chunk, options) {
-		if (chunk.type === "RUN_ERROR" && this.isActiveInterruptSubmissionFailure(chunk)) this.interruptSubmissionFailure = { errors: chunk["tanstack:interruptErrors"] ?? [] };
+		chunk = restoreInboundChunk(chunk);
+		if (chunk.type === "RUN_ERROR" && this.isActiveInterruptSubmissionFailure(chunk)) {
+			const interruptErrors = tanstackMetadata(chunk)?.interruptErrors;
+			this.interruptSubmissionFailure = { errors: Array.isArray(interruptErrors) ? interruptErrors : [] };
+		}
 		if (this.connectionStatus === "connecting") this.setConnectionStatus("connected");
 		if (this.clearedStreamTracker.shouldIgnoreChunk(chunk)) {
 			if (chunk.type === "RUN_FINISHED" || chunk.type === "RUN_ERROR") {
-				if (getChunkRunId(chunk)) this.updateRunLifecycle(chunk, { resolveProcessing: false });
+				if (getChunkRunId$1(chunk)) this.updateRunLifecycle(chunk, { resolveProcessing: false });
 				else this.drainIgnoredRunlessChunk(chunk);
 				this.retireIgnoredClearedTerminalChunk(chunk);
 				this.resolveJoinedRun(chunk);
@@ -959,21 +974,24 @@ var ChatClient = class {
 		this.processor.processChunk(chunk);
 		this.updateRunLifecycle(chunk);
 		this.observeInterruptState(chunk);
-		if (options?.defer !== false) await new Promise((resolve) => setTimeout(resolve, 0));
+		if (options?.defer !== false && (typeof document === "undefined" || !document.hidden)) await new Promise((resolve) => setTimeout(resolve, 0));
 		this.resolveJoinedRun(chunk);
 	}
 	isActiveInterruptSubmissionFailure(chunk) {
 		const submission = this.activeInterruptSubmission;
-		const errors = chunk["tanstack:interruptErrors"];
-		if (!submission || !errors || errors.length === 0) return false;
-		const runId = getChunkRunId(chunk);
+		const errors = tanstackMetadata(chunk)?.interruptErrors;
+		if (!submission || !Array.isArray(errors) || errors.length === 0) return false;
+		const runId = getChunkRunId$1(chunk);
 		if (runId !== void 0 && runId !== this.currentRunId) return false;
 		if (typeof chunk.threadId === "string" && chunk.threadId !== submission.threadId) return false;
-		return errors.every((error) => error.threadId === submission.threadId && error.interruptedRunId === submission.interruptedRunId && error.generation === submission.generation);
+		return errors.every((error) => {
+			if (error == null || typeof error !== "object" || typeof error.threadId !== "string" || typeof error.interruptedRunId !== "string" || typeof error.generation !== "number") return false;
+			return error.threadId === submission.threadId && error.interruptedRunId === submission.interruptedRunId && error.generation === submission.generation;
+		});
 	}
 	resolveJoinedRun(chunk) {
 		if (chunk.type !== "RUN_FINISHED" && chunk.type !== "RUN_ERROR") return;
-		const runId = getChunkRunId(chunk);
+		const runId = getChunkRunId$1(chunk);
 		if (runId === void 0) return;
 		const resolve = this.joinedRunWaiters.get(runId);
 		if (resolve === void 0) return;
@@ -1096,7 +1114,7 @@ var ChatClient = class {
 		try {
 			const normalizedContent = this.normalizeMessageInput(content);
 			this.pendingMessageBody = body;
-			const userMessage = this.processor.addUserMessage(normalizedContent.content, normalizedContent.id);
+			const userMessage = this.processor.addUserMessage(normalizedContent.content, normalizedContent.id, normalizedContent.metadata);
 			this.events.messageSent(userMessage.id, normalizedContent.content);
 			return await this.streamResponse();
 		} finally {
@@ -1149,14 +1167,15 @@ var ChatClient = class {
 		this.emitQueueChange();
 	}
 	/**
-	* Normalize the message input to extract content and optional id.
-	* Trims string content automatically.
+	* Normalize the message input to extract content, optional id, and
+	* optional metadata. String form has no metadata. Trims string content.
 	*/
 	normalizeMessageInput(input) {
 		if (typeof input === "string") return { content: input.trim() };
 		return {
 			content: input.content,
-			id: input.id
+			id: input.id,
+			...input.metadata !== void 0 ? { metadata: input.metadata } : {}
 		};
 	}
 	/**