@tanstack/ai-client 0.23.3 → 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

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",