@tanstack/ai-client 0.23.2 → 0.24.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/chat-client.d.ts

@@ -46,8 +46,8 @@ export declare function normalizeQueueOption(option: QueueOption | undefined): N
 export declare class ChatClient<TTools extends ReadonlyArray<AnyClientTool> = any, TContext = unknown> {
     private readonly processor;
     private connection;
-    private readonly uniqueId;
-    private readonly threadId;
+    private uniqueId;
+    private threadId;
     private readonly persistor?;
     private readonly clearedStreamTracker;
     private currentRunId;
@@ -190,6 +190,7 @@ export declare class ChatClient<TTools extends ReadonlyArray<AnyClientTool> = an
      */
     private hydrateFromServer;
     mountDevtools(): void;
+    private ensureThreadId;
     /**
      * Drain a runId-less RUN_ERROR that belongs to a cleared run the client is
      * still tracking. The persistor owns the cleared-run bookkeeping; the client
@@ -352,12 +353,9 @@ export declare class ChatClient<TTools extends ReadonlyArray<AnyClientTool> = an
      * ```
      */
     sendMessage(content: string | MultimodalContent, body?: Record<string, any>, sendOptions?: SendMessageOptions): Promise<void>;
-    /**
-     * True when the client still has user-actionable interrupts (or is mid
-     * resume submission). Staged/submitting items that are already being
-     * continued do not block a later turn once the resume stream has cleared
-     * resume state.
-     */
+    /** True while interrupt descriptors still own continuation. */
+    private hasPendingInterrupts;
+    /** True while an interrupt batch owns the next user turn. */
     private hasBlockingInterrupts;
     /** True while a stream is active, a send is claiming the client, or the queue is draining. */
     private isSendBusy;

package/dist/esm/chat-client.js

@@ -197,13 +197,15 @@ var ChatClient = class {
 	devtoolsMounted = false;
 	callbacksRef;
 	constructor(options) {
-		this.threadId = options.threadId || this.generateUniqueId("thread");
-		this.uniqueId = options.id || this.threadId;
+		this.threadId = options.threadId || "";
+		this.uniqueId = this.threadId;
 		let cachesMessages = true;
-		if (options.persistence === true) cachesMessages = false;
-		else if (options.persistence) {
-			const persistenceKey = options.id ?? this.threadId;
-			this.persistor = new ChatPersistor(options.persistence, persistenceKey, (messages) => this.processor.setMessages(messages), (snapshot) => this.applyPersistedResume(snapshot));
+		if (options.persistence === true) {
+			if (!options.threadId) throw new Error("[TanStack AI] persistence needs a stable `threadId` to key on. Pass a threadId from your app (for example support-42).");
+			cachesMessages = false;
+		} else if (options.persistence) {
+			if (!options.threadId) throw new Error("[TanStack AI] persistence needs a stable `threadId` to key on. Pass a threadId from your app (for example support-42).");
+			this.persistor = new ChatPersistor(options.persistence, options.threadId, (messages) => this.processor.setMessages(messages), (snapshot) => this.applyPersistedResume(snapshot));
 		}
 		this.bodyOption = options.body || {};
 		this.forwardedPropsOption = options.forwardedProps || {};
@@ -367,6 +369,7 @@ var ChatClient = class {
 	*/
 	attach() {
 		if (this.disposed || this.tailing) return;
+		this.ensureThreadId();
 		this.tailing = true;
 		if (this.rejoinRunId) this.maybeRejoinInFlight(this.rejoinRunId);
 		if (!this.cachesMessages && this.connection.hydrate) this.hydrateFromServer();
@@ -474,10 +477,16 @@ var ChatClient = class {
 		})();
 	}
 	mountDevtools() {
+		this.ensureThreadId();
 		if (this.devtoolsMounted) return;
 		this.devtoolsMounted = true;
 		this.devtoolsBridge.mountWithTools(this.processor.getMessages().length);
 	}
+	ensureThreadId() {
+		if (!this.threadId) this.threadId = this.generateUniqueId("thread");
+		this.uniqueId = this.threadId;
+		return this.threadId;
+	}
 	/**
 	* Drain a runId-less RUN_ERROR that belongs to a cleared run the client is
 	* still tracking. The persistor owns the cleared-run bookkeeping; the client
@@ -732,10 +741,17 @@ var ChatClient = class {
 		this.events.errorChanged(error?.message || null);
 	}
 	buildDevtoolsBridgeOptions(devtools) {
+		const client = this;
 		return {
-			hookId: this.uniqueId,
-			clientId: this.uniqueId,
-			threadId: this.threadId,
+			get hookId() {
+				return client.uniqueId;
+			},
+			get clientId() {
+				return client.uniqueId;
+			},
+			get threadId() {
+				return client.threadId;
+			},
 			metadata: {
 				hookName: devtools?.hookName ?? "useChat",
 				outputKind: devtools?.outputKind ?? "chat",
@@ -1038,16 +1054,13 @@ var ChatClient = class {
 			this.sendInFlight = false;
 		}
 	}
-	/**
-	* True when the client still has user-actionable interrupts (or is mid
-	* resume submission). Staged/submitting items that are already being
-	* continued do not block a later turn once the resume stream has cleared
-	* resume state.
-	*/
+	/** True while interrupt descriptors still own continuation. */
+	hasPendingInterrupts() {
+		return this.interruptManager.getDescriptors().length > 0;
+	}
+	/** True while an interrupt batch owns the next user turn. */
 	hasBlockingInterrupts() {
-		if (!this.lastResume && !this.activeInterruptSubmission) return false;
-		if (this.activeInterruptSubmission) return true;
-		return this.interruptManager.getInterrupts().some((item) => item.status === "pending" || item.status === "validating" || item.status === "error" || item.status === "staged");
+		return this.activeInterruptSubmission !== void 0 || this.hasPendingInterrupts();
 	}
 	/** True while a stream is active, a send is claiming the client, or the queue is draining. */
 	isSendBusy() {
@@ -1445,6 +1458,7 @@ var ChatClient = class {
 	* Check if we should continue the flow and do so if needed
 	*/
 	async checkForContinuation() {
+		if (this.hasPendingInterrupts()) return;
 		if (this.continuationPending || this.isLoading) {
 			this.continuationSkipped = true;
 			return;