@tanstack/ai-svelte 0.14.4 → 0.15.0

package/dist/create-chat.svelte.js

@@ -42,6 +42,7 @@ export function createChat(options) {
     let isSubscribed = $state(false);
     let connectionStatus = $state('disconnected');
     let sessionGenerating = $state(false);
+    let queue = $state([]);
     // Create ChatClient instance.
     // Note: Svelte's createChat runs once per instance and `options` is captured
     // by reference. Callbacks are therefore frozen to whatever the caller passed
@@ -115,6 +116,10 @@ export function createChat(options) {
         onSessionGeneratingChange: (isGenerating) => {
             sessionGenerating = isGenerating;
         },
+        ...(options.queue !== undefined && { queue: options.queue }),
+        onQueueChange: (nextQueue) => {
+            queue = nextQueue;
+        },
     });
     messages = client.getMessages();
     if (options.live) {
@@ -126,9 +131,10 @@ export function createChat(options) {
     // during component initialization, so we don't add automatic cleanup here.
     // Users should call chat.stop() in their component's cleanup if needed.
     // Define methods
-    const sendMessage = async (content) => {
-        await client.sendMessage(content);
+    const sendMessage = async (content, sendOptions) => {
+        await client.sendMessage(content, undefined, sendOptions);
     };
+    const cancelQueued = (id) => client.cancelQueued(id);
     const append = async (message) => {
         await client.append(message);
     };
@@ -226,6 +232,9 @@ export function createChat(options) {
         get sessionGenerating() {
             return sessionGenerating;
         },
+        get queue() {
+            return queue;
+        },
         get partial() {
             return partial;
         },
@@ -233,6 +242,7 @@ export function createChat(options) {
             return final;
         },
         sendMessage,
+        cancelQueued,
         append,
         reload,
         stop,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { createChat } from './create-chat.svelte';
-export type { CreateChatOptions, CreateChatReturn, DeepPartial, UIMessage, ChatRequestBody, } from './types';
+export type { CreateChatOptions, CreateChatReturn, DeepPartial, UIMessage, ChatRequestBody, QueuedMessage, SendMessageOptions, WhenBusy, QueueConfig, QueueStrategy, QueueOption, } from './types';
 export { createGeneration } from './create-generation.svelte';
 export type { CreateGenerationOptions, CreateGenerationReturn, } from './create-generation.svelte';
 export { createGenerateImage } from './create-generate-image.svelte';

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 import type { AnyClientTool, InferSchemaType, ModelMessage, SchemaInput } from '@tanstack/ai';
-import type { AIDevtoolsDisplayOptions, ChatClientOptions, ChatClientState, ChatRequestBody, ClientContextOptionFromTools, ConnectionStatus, DistributedOmit, InferredClientContext, MultimodalContent, UIMessage } from '@tanstack/ai-client';
-export type { ChatRequestBody, MultimodalContent, UIMessage };
+import type { AIDevtoolsDisplayOptions, ChatClientOptions, ChatClientState, ChatRequestBody, ClientContextOptionFromTools, ConnectionStatus, DistributedOmit, InferredClientContext, MultimodalContent, QueueConfig, QueueOption, QueueStrategy, QueuedMessage, SendMessageOptions, UIMessage, WhenBusy } from '@tanstack/ai-client';
+export type { ChatRequestBody, MultimodalContent, QueueConfig, QueuedMessage, QueueOption, QueueStrategy, SendMessageOptions, UIMessage, WhenBusy, };
 /**
  * Recursive partial — every property and every nested array element is
  * optional. Used to type the in-flight `partial` getter while a structured-
@@ -30,7 +30,7 @@ export type DeepPartial<T> = T extends ReadonlyArray<infer U> ? Array<DeepPartia
  * Note: Connection and body changes will recreate the ChatClient instance.
  * To update these options, remount the component or use a key prop.
  */
-export type CreateChatOptions<TTools extends ReadonlyArray<AnyClientTool> = any, TSchema extends SchemaInput | undefined = undefined, TContext = InferredClientContext<TTools>> = DistributedOmit<ChatClientOptions<TTools, TContext>, 'onMessagesChange' | 'onLoadingChange' | 'onErrorChange' | 'onStatusChange' | 'onSubscriptionChange' | 'onConnectionStatusChange' | 'onSessionGeneratingChange' | 'context' | 'devtools'> & {
+export type CreateChatOptions<TTools extends ReadonlyArray<AnyClientTool> = any, TSchema extends SchemaInput | undefined = undefined, TContext = InferredClientContext<TTools>> = DistributedOmit<ChatClientOptions<TTools, TContext>, 'onMessagesChange' | 'onLoadingChange' | 'onErrorChange' | 'onStatusChange' | 'onSubscriptionChange' | 'onConnectionStatusChange' | 'onSessionGeneratingChange' | 'onQueueChange' | 'context' | 'devtools'> & {
     live?: boolean;
     /** Display options for TanStack AI Devtools. */
     devtools?: AIDevtoolsDisplayOptions;
@@ -70,7 +70,15 @@ interface BaseCreateChatReturn<TTools extends ReadonlyArray<AnyClientTool> = any
      * Send a message and get a response.
      * Can be a simple string or multimodal content with images, audio, etc.
      */
-    sendMessage: (content: string | MultimodalContent) => Promise<void>;
+    sendMessage: (content: string | MultimodalContent, options?: SendMessageOptions) => Promise<void>;
+    /**
+     * Pending messages queued while a stream is in flight.
+     */
+    readonly queue: Array<QueuedMessage>;
+    /**
+     * Cancel a queued message before it drains. No-op if already sent.
+     */
+    cancelQueued: (id: string) => void;
     /**
      * Append a message to the conversation
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-svelte",
-  "version": "0.14.4",
+  "version": "0.15.0",
   "description": "Svelte 5 bindings for TanStack AI streaming chat, structured outputs, and media generation.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -46,7 +46,7 @@
     "media-generation"
   ],
   "dependencies": {
-    "@tanstack/ai-client": "0.21.0"
+    "@tanstack/ai-client": "0.22.0"
   },
   "peerDependencies": {
     "svelte": "^5.0.0",

package/src/create-chat.svelte.ts

@@ -4,6 +4,8 @@ import type {
   ChatClientState,
   ConnectionStatus,
   InferredClientContext,
+  QueuedMessage,
+  SendMessageOptions,
   StructuredOutputPart,
 } from '@tanstack/ai-client'
 import type {
@@ -71,6 +73,7 @@ export function createChat<
   let isSubscribed = $state(false)
   let connectionStatus = $state<ConnectionStatus>('disconnected')
   let sessionGenerating = $state(false)
+  let queue = $state<Array<QueuedMessage>>([])
 
   // Structured-output `partial` / `final` are derived from `messages` —
   // specifically from the structured-output part on the latest assistant
@@ -153,6 +156,10 @@ export function createChat<
     onSessionGeneratingChange: (isGenerating: boolean) => {
       sessionGenerating = isGenerating
     },
+    ...(options.queue !== undefined && { queue: options.queue }),
+    onQueueChange: (nextQueue: Array<QueuedMessage>) => {
+      queue = nextQueue
+    },
   })
 
   messages = client.getMessages()
@@ -169,10 +176,15 @@ export function createChat<
   // Users should call chat.stop() in their component's cleanup if needed.
 
   // Define methods
-  const sendMessage = async (content: string | MultimodalContent) => {
-    await client.sendMessage(content)
+  const sendMessage = async (
+    content: string | MultimodalContent,
+    sendOptions?: SendMessageOptions,
+  ) => {
+    await client.sendMessage(content, undefined, sendOptions)
   }
 
+  const cancelQueued = (id: string) => client.cancelQueued(id)
+
   const append = async (message: ModelMessage | UIMessage<TTools>) => {
     await client.append(message)
   }
@@ -293,6 +305,9 @@ export function createChat<
     get sessionGenerating() {
       return sessionGenerating
     },
+    get queue() {
+      return queue
+    },
     get partial() {
       return partial
     },
@@ -300,6 +315,7 @@ export function createChat<
       return final
     },
     sendMessage,
+    cancelQueued,
     append,
     reload,
     stop,

package/src/index.ts

@@ -5,6 +5,12 @@ export type {
   DeepPartial,
   UIMessage,
   ChatRequestBody,
+  QueuedMessage,
+  SendMessageOptions,
+  WhenBusy,
+  QueueConfig,
+  QueueStrategy,
+  QueueOption,
 } from './types'
 
 // Generation hooks

package/src/types.ts

@@ -14,11 +14,27 @@ import type {
   DistributedOmit,
   InferredClientContext,
   MultimodalContent,
+  QueueConfig,
+  QueueOption,
+  QueueStrategy,
+  QueuedMessage,
+  SendMessageOptions,
   UIMessage,
+  WhenBusy,
 } from '@tanstack/ai-client'
 
 // Re-export types from ai-client
-export type { ChatRequestBody, MultimodalContent, UIMessage }
+export type {
+  ChatRequestBody,
+  MultimodalContent,
+  QueueConfig,
+  QueuedMessage,
+  QueueOption,
+  QueueStrategy,
+  SendMessageOptions,
+  UIMessage,
+  WhenBusy,
+}
 
 /**
  * Recursive partial — every property and every nested array element is
@@ -66,6 +82,7 @@ export type CreateChatOptions<
   | 'onSubscriptionChange'
   | 'onConnectionStatusChange'
   | 'onSessionGeneratingChange'
+  | 'onQueueChange'
   | 'context'
   | 'devtools'
 > & {
@@ -126,7 +143,20 @@ interface BaseCreateChatReturn<
    * Send a message and get a response.
    * Can be a simple string or multimodal content with images, audio, etc.
    */
-  sendMessage: (content: string | MultimodalContent) => Promise<void>
+  sendMessage: (
+    content: string | MultimodalContent,
+    options?: SendMessageOptions,
+  ) => Promise<void>
+
+  /**
+   * Pending messages queued while a stream is in flight.
+   */
+  readonly queue: Array<QueuedMessage>
+
+  /**
+   * Cancel a queued message before it drains. No-op if already sent.
+   */
+  cancelQueued: (id: string) => void
 
   /**
    * Append a message to the conversation