@tanstack/ai-svelte 0.15.1 → 0.16.0

package/dist/create-generate-video.svelte.js

@@ -34,8 +34,7 @@ import { createVideoDevtoolsBridge } from '@tanstack/ai-client/devtools';
 // parameter is typed as `VideoGenerateResult` and `result` narrows to the
 // transform's return. See issue #848.
 export function createGenerateVideo(options) {
-    const clientId = options.id ||
-        `video-${Date.now()}-${Math.random().toString(36).substring(7)}`;
+    const fallbackId = `video-${Date.now()}-${Math.random().toString(36).substring(7)}`;
     // Create reactive state using Svelte 5 runes
     let result = $state(null);
     let jobId = $state(null);
@@ -43,13 +42,25 @@ export function createGenerateVideo(options) {
     let isLoading = $state(false);
     let error = $state(undefined);
     let status = $state('idle');
+    let runId = $state(null);
+    let disposed = false;
     // `body` uses a conditional spread because `VideoGenerationClientOptions.body`
     // is declared `body?: Record<string, any>` (absent vs. present) under
     // `exactOptionalPropertyTypes`. The optional caller `options.body` may be
     // undefined, in which case we want the key to be absent on the target.
+    // Identity: pass `threadId` alone when set (never also pass deprecated `id`).
     const baseOptions = {
-        id: clientId,
         body: options.body,
+        ...(options.threadId !== undefined
+            ? { threadId: options.threadId }
+            : { id: options.id ?? fallbackId }),
+        ...(options.persistence !== undefined && {
+            persistence: options.persistence,
+        }),
+        ...(options.hydrateGeneration !== undefined && {
+            hydrateGeneration: options.hydrateGeneration,
+        }),
+        ...(options.joinRun !== undefined && { joinRun: options.joinRun }),
         devtoolsBridgeFactory: createVideoDevtoolsBridge,
         devtools: {
             ...options.devtools,
@@ -61,29 +72,61 @@ export function createGenerateVideo(options) {
         // (`TOutput`, with null/void/undefined stripped) are identical at runtime;
         // the cast bridges the relationship that the conditional type hides.
         onResult: ((r) => options.onResult?.(r)),
-        onError: (e) => options.onError?.(e),
-        onProgress: (p, m) => options.onProgress?.(p, m),
-        onChunk: (c) => options.onChunk?.(c),
-        onJobCreated: (id) => options.onJobCreated?.(id),
-        onStatusUpdate: (s) => options.onStatusUpdate?.(s),
+        onError: (e) => {
+            if (!disposed)
+                options.onError?.(e);
+        },
+        onProgress: (p, m) => {
+            if (!disposed)
+                options.onProgress?.(p, m);
+        },
+        onChunk: (c) => {
+            if (!disposed)
+                options.onChunk?.(c);
+        },
+        onJobCreated: (id) => {
+            if (!disposed)
+                options.onJobCreated?.(id);
+        },
+        onStatusUpdate: (s) => {
+            if (!disposed)
+                options.onStatusUpdate?.(s);
+        },
         onResultChange: (r) => {
+            if (disposed)
+                return;
             result = r;
         },
         onLoadingChange: (l) => {
+            if (disposed)
+                return;
             isLoading = l;
         },
         onErrorChange: (e) => {
+            if (disposed)
+                return;
             error = e;
         },
         onStatusChange: (s) => {
+            if (disposed)
+                return;
             status = s;
         },
         onJobIdChange: (id) => {
+            if (disposed)
+                return;
             jobId = id;
         },
         onVideoStatusChange: (s) => {
+            if (disposed)
+                return;
             videoStatus = s;
         },
+        onResumeStateChange: (rs) => {
+            if (disposed)
+                return;
+            runId = rs?.runId ?? null;
+        },
     };
     let client;
     if (options.connection) {
@@ -101,12 +144,20 @@ export function createGenerateVideo(options) {
     else {
         throw new Error('createGenerateVideo requires either a connection or fetcher option');
     }
+    // Mount devtools only. Generation runs are never auto-started on setup —
+    // persisted state is read-only for display.
     client.mountDevtools();
     // Note: Cleanup is handled by calling dispose() directly when needed.
     // Unlike React/Vue/Solid, Svelte 5 runes like $effect can only be used
     // during component initialization, so we don't add automatic cleanup here.
     // Users should call video.dispose() in their component's cleanup if needed.
     const generate = async (input) => {
+        // Svelte has no remount effect to revive a disposed client (the other
+        // frameworks revive via mountDevtools() in their mount effects), so an
+        // explicit generate() after dispose() is the Svelte revive path: bring
+        // the client and the reactive bindings back together.
+        disposed = false;
+        client.mountDevtools();
         await client.generate(input);
     };
     const stop = () => {
@@ -116,6 +167,7 @@ export function createGenerateVideo(options) {
         client.reset();
     };
     const dispose = () => {
+        disposed = true;
         client.dispose();
     };
     const updateBody = (newBody) => {
@@ -145,5 +197,8 @@ export function createGenerateVideo(options) {
         reset,
         dispose,
         updateBody,
+        get runId() {
+            return runId;
+        },
     };
 }

package/dist/create-generation.svelte.d.ts

@@ -1,5 +1,5 @@
 import type { StreamChunk } from '@tanstack/ai';
-import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutputFromReturn } from '@tanstack/ai-client';
+import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, GenerationPersistenceOptions, GenerationRestoredResult, InferGenerationOutputFromReturn } from '@tanstack/ai-client';
 /**
  * Options for the createGeneration function.
  *
@@ -14,12 +14,51 @@ export interface CreateGenerationOptions<TInput, TResult, TOutput = TResult> {
     connection?: ConnectConnectionAdapter;
     /** Direct async function for one-shot generation (no streaming protocol needed) */
     fetcher?: GenerationFetcher<TInput, TResult>;
-    /** Unique identifier for this generation instance */
+    /**
+     * @deprecated Prefer `threadId`. Only allowed when `threadId` is omitted (see `GenerationPersistenceOptions`).
+     */
     id?: string;
     /** Additional body parameters to send with connect-based adapter requests */
     body?: Record<string, any>;
     /** Display options for TanStack AI Devtools. */
     devtools?: AIDevtoolsDisplayOptions;
+    /**
+     * How this generation persists across reloads.
+     * - Omit / `false`: ephemeral, in-memory only.
+     * - `true`: server-driven — on mount the client hydrates the last generation
+     *   for its `threadId` from the server (needs a connection with a
+     *   `hydrateGeneration` handler) and repaints it; it never auto-starts a run.
+     */
+    persistence?: boolean;
+    /**
+     * The **scope** this generation belongs to: a stable, app-chosen name for the
+     * slot successive runs fill — not a link to a chat conversation.
+     *
+     * The hook starts empty and produces many runs over its life; each gets its
+     * own `runId`, but all belong to one scope. Persistence keys on this, so
+     * derive it from your own domain and keep it identical across reloads (e.g.
+     * `` `video-${videoId}-start-frame` ``). It is also sent as the AG-UI thread
+     * id on the wire, which the protocol requires.
+     *
+     * **Required whenever `persistence` is set** — an app that cannot name the
+     * scope has nothing to restore to. Optional for ephemeral generations, where
+     * it falls back to `id` purely to satisfy the wire.
+     */
+    threadId?: string;
+    /**
+     * Server-driven hydration handler for `persistence: true` when the
+     * connection doesn't carry one (e.g. alongside `fetcher`, or a `stream()` /
+     * `rpcStream()` adapter built without handlers) — typically a one-line
+     * server-function call. The connection's own handler takes precedence.
+     */
+    hydrateGeneration?: ConnectConnectionAdapter['hydrateGeneration'];
+    /**
+     * Re-attach handler that replays a run still generating to completion on
+     * mount, when the connection doesn't carry one. Without it, a restored
+     * `running` snapshot surfaces as an (interrupted) error. The connection's
+     * own handler takes precedence.
+     */
+    joinRun?: ConnectConnectionAdapter['joinRun'];
     /**
      * Callback when a result is received. Can optionally return a transformed value.
      *
@@ -34,13 +73,20 @@ export interface CreateGenerationOptions<TInput, TResult, TOutput = TResult> {
     onProgress?: (progress: number, message?: string) => void;
     /** Callback for each stream chunk (connect-based adapter mode only) */
     onChunk?: (chunk: StreamChunk) => void;
+    /**
+     * @internal Rebuild a typed result from a restored snapshot, injected by each
+     * specialized function (image / speech / audio / transcription / summarize).
+     * Forwarded to the client so a server-hydrate restore repaints `result`.
+     */
+    reconstructResult?: (restored: GenerationRestoredResult) => TResult | null;
 }
 /**
  * Return type for the createGeneration function.
  *
  * @template TOutput - The output type (after optional transform)
+ * @template TInput - The input type accepted by `generate` (defaults to any object)
  */
-export interface CreateGenerationReturn<TOutput> {
+export interface CreateGenerationReturn<TOutput, TInput extends Record<string, any> = Record<string, any>> {
     /** The generation result, or null if not yet generated */
     readonly result: TOutput | null;
     /** Whether a generation is currently in progress */
@@ -50,7 +96,7 @@ export interface CreateGenerationReturn<TOutput> {
     /** Current state of the generation client */
     readonly status: GenerationClientState;
     /** Trigger a generation request */
-    generate: (input: Record<string, any>) => Promise<void>;
+    generate: (input: TInput) => Promise<void>;
     /** Abort the current generation */
     stop: () => void;
     /** Clear result, error, and return to idle */
@@ -59,6 +105,13 @@ export interface CreateGenerationReturn<TOutput> {
     dispose: () => void;
     /** Update additional body parameters */
     updateBody: (body: Record<string, any>) => void;
+    /**
+     * The id of the generation job currently running, or `null` when nothing is in
+     * flight. Each call to `generate` is one job with its own id. Pass it to your
+     * own endpoint to cancel or poll the provider job — `stop()` only aborts the
+     * local stream, it does not stop work already running on the provider.
+     */
+    readonly runId: string | null;
 }
 /**
  * Creates a reactive generation instance for Svelte 5.
@@ -91,6 +144,6 @@ export interface CreateGenerationReturn<TOutput> {
  * </div>
  * ```
  */
-export declare function createGeneration<TInput extends Record<string, any>, TResult, TTransformed = void>(options: Omit<CreateGenerationOptions<TInput, TResult>, 'onResult'> & {
+export declare function createGeneration<TInput extends Record<string, any>, TResult, TTransformed = void>(options: Omit<CreateGenerationOptions<TInput, TResult>, 'onResult' | 'persistence' | 'threadId' | 'id'> & {
     onResult?: (result: TResult) => TTransformed;
-}): CreateGenerationReturn<InferGenerationOutputFromReturn<TResult, TTransformed>>;
+} & GenerationPersistenceOptions): CreateGenerationReturn<InferGenerationOutputFromReturn<TResult, TTransformed>, TInput>;

package/dist/create-generation.svelte.js

@@ -38,20 +38,35 @@ import { createGenerationDevtoolsBridge } from '@tanstack/ai-client/devtools';
 // default, leaving the parameter `any` — a hard error under `strict`. See
 // issue #848.
 export function createGeneration(options) {
-    const clientId = options.id || `gen-${Date.now()}-${Math.random().toString(36).substring(7)}`;
+    const fallbackId = `gen-${Date.now()}-${Math.random().toString(36).substring(7)}`;
     // Create reactive state using Svelte 5 runes
     let result = $state(null);
     let isLoading = $state(false);
     let error = $state(undefined);
     let status = $state('idle');
+    let runId = $state(null);
+    let disposed = false;
     // `body` uses a conditional spread because `GenerationClientOptions.body`
     // is declared `body?: Record<string, any>` (absent vs. present) under
     // `exactOptionalPropertyTypes`. Assigning `undefined` directly would be
     // rejected — the optional caller `options.body` may be undefined, in which
     // case we want the key to be absent.
+    // Identity: pass `threadId` alone when set (never also pass deprecated `id`).
     const clientOptions = {
-        id: clientId,
         body: options.body,
+        ...(options.threadId !== undefined
+            ? { threadId: options.threadId }
+            : { id: options.id ?? fallbackId }),
+        ...(options.persistence !== undefined && {
+            persistence: options.persistence,
+        }),
+        ...(options.hydrateGeneration !== undefined && {
+            hydrateGeneration: options.hydrateGeneration,
+        }),
+        ...(options.joinRun !== undefined && { joinRun: options.joinRun }),
+        ...(options.reconstructResult
+            ? { reconstructResult: options.reconstructResult }
+            : {}),
         devtoolsBridgeFactory: createGenerationDevtoolsBridge,
         devtools: {
             ...options.devtools,
@@ -62,21 +77,43 @@ export function createGeneration(options) {
         // (`TOutput`, with null/void/undefined stripped) are identical at runtime;
         // the cast bridges the relationship that the conditional type hides.
         onResult: ((r) => options.onResult?.(r)),
-        onError: (e) => options.onError?.(e),
-        onProgress: (p, m) => options.onProgress?.(p, m),
-        onChunk: (c) => options.onChunk?.(c),
+        onError: (e) => {
+            if (!disposed)
+                options.onError?.(e);
+        },
+        onProgress: (p, m) => {
+            if (!disposed)
+                options.onProgress?.(p, m);
+        },
+        onChunk: (c) => {
+            if (!disposed)
+                options.onChunk?.(c);
+        },
         onResultChange: (r) => {
+            if (disposed)
+                return;
             result = r;
         },
         onLoadingChange: (l) => {
+            if (disposed)
+                return;
             isLoading = l;
         },
         onErrorChange: (e) => {
+            if (disposed)
+                return;
             error = e;
         },
         onStatusChange: (s) => {
+            if (disposed)
+                return;
             status = s;
         },
+        onResumeStateChange: (rs) => {
+            if (disposed)
+                return;
+            runId = rs?.runId ?? null;
+        },
     };
     let client;
     if (options.connection) {
@@ -94,12 +131,20 @@ export function createGeneration(options) {
     else {
         throw new Error('createGeneration requires either a connection or fetcher option');
     }
+    // Mount devtools only. Generation runs are never auto-started on setup —
+    // persisted state is read-only for display.
     client.mountDevtools();
     // Note: Cleanup is handled by calling dispose() directly when needed.
     // Unlike React/Vue/Solid, Svelte 5 runes like $effect can only be used
     // during component initialization, so we don't add automatic cleanup here.
     // Users should call gen.dispose() in their component's cleanup if needed.
     const generate = async (input) => {
+        // Svelte has no remount effect to revive a disposed client (the other
+        // frameworks revive via mountDevtools() in their mount effects), so an
+        // explicit generate() after dispose() is the Svelte revive path: bring
+        // the client and the reactive bindings back together.
+        disposed = false;
+        client.mountDevtools();
         await client.generate(input);
     };
     const stop = () => {
@@ -109,6 +154,7 @@ export function createGeneration(options) {
         client.reset();
     };
     const dispose = () => {
+        disposed = true;
         client.dispose();
     };
     const updateBody = (newBody) => {
@@ -127,10 +173,13 @@ export function createGeneration(options) {
         get status() {
             return status;
         },
-        generate: generate,
+        generate,
         stop,
         reset,
         dispose,
         updateBody,
+        get runId() {
+            return runId;
+        },
     };
 }

package/dist/create-summarize.svelte.d.ts

@@ -1,16 +1,19 @@
+import type { CreateGenerationOptions, CreateGenerationReturn } from './create-generation.svelte';
 import type { StreamChunk, SummarizationResult } from '@tanstack/ai';
-import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutputFromReturn, SummarizeGenerateInput } from '@tanstack/ai-client';
+import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, GenerationPersistenceOptions, InferGenerationOutputFromReturn, SummarizeGenerateInput } from '@tanstack/ai-client';
 /**
  * Options for the createSummarize function.
  *
  * @template TOutput - The output type after optional transform (defaults to SummarizationResult)
  */
-export interface CreateSummarizeOptions<TOutput = SummarizationResult> {
+export interface CreateSummarizeOptions<TOutput = SummarizationResult> extends Pick<CreateGenerationOptions<SummarizeGenerateInput, SummarizationResult, TOutput>, 'persistence' | 'threadId' | 'hydrateGeneration' | 'joinRun'> {
     /** Connect-based adapter for streaming transport (SSE, HTTP stream, custom) */
     connection?: ConnectConnectionAdapter;
     /** Direct async function for summarization */
     fetcher?: GenerationFetcher<SummarizeGenerateInput, SummarizationResult>;
-    /** Unique identifier for this generation instance */
+    /**
+     * @deprecated Prefer `threadId`. Only allowed when `threadId` is omitted (see `GenerationPersistenceOptions`).
+     */
     id?: string;
     /** Additional body parameters to send with connect-based adapter requests */
     body?: Record<string, any>;
@@ -36,7 +39,7 @@ export interface CreateSummarizeOptions<TOutput = SummarizationResult> {
  *
  * @template TOutput - The output type (after optional transform)
  */
-export interface CreateSummarizeReturn<TOutput = SummarizationResult> {
+export interface CreateSummarizeReturn<TOutput = SummarizationResult> extends Omit<CreateGenerationReturn<TOutput>, 'generate'> {
     /** The summarization result, or null */
     readonly result: TOutput | null;
     /** Whether summarization is in progress */
@@ -47,12 +50,6 @@ export interface CreateSummarizeReturn<TOutput = SummarizationResult> {
     readonly status: GenerationClientState;
     /** Trigger summarization */
     generate: (input: SummarizeGenerateInput) => Promise<void>;
-    /** Abort the current summarization */
-    stop: () => void;
-    /** Clear result, error, and return to idle */
-    reset: () => void;
-    /** Update additional body parameters */
-    updateBody: (body: Record<string, any>) => void;
 }
 /**
  * Creates a reactive text summarization instance for Svelte 5.
@@ -84,6 +81,6 @@ export interface CreateSummarizeReturn<TOutput = SummarizationResult> {
  * </div>
  * ```
  */
-export declare function createSummarize<TTransformed = void>(options: Omit<CreateSummarizeOptions, 'onResult'> & {
+export declare function createSummarize<TTransformed = void>(options: Omit<CreateSummarizeOptions, 'onResult' | 'persistence' | 'threadId' | 'id'> & {
     onResult?: (result: SummarizationResult) => TTransformed;
-}): CreateSummarizeReturn<InferGenerationOutputFromReturn<SummarizationResult, TTransformed>>;
+} & GenerationPersistenceOptions): CreateSummarizeReturn<InferGenerationOutputFromReturn<SummarizationResult, TTransformed>>;

package/dist/create-summarize.svelte.js

@@ -1,4 +1,5 @@
 import { createGeneration } from './create-generation.svelte';
+import { reconstructSummarizeResult } from '@tanstack/ai-client';
 /**
  * Creates a reactive text summarization instance for Svelte 5.
  *
@@ -39,6 +40,7 @@ export function createSummarize(options) {
     const gen = createGeneration({
         ...options,
         devtools,
+        reconstructResult: reconstructSummarizeResult,
     });
     return {
         get result() {
@@ -57,5 +59,9 @@ export function createSummarize(options) {
         stop: gen.stop,
         reset: gen.reset,
         updateBody: gen.updateBody,
+        dispose: gen.dispose,
+        get runId() {
+            return gen.runId;
+        },
     };
 }

package/dist/create-transcription.svelte.d.ts

@@ -1,16 +1,19 @@
+import type { CreateGenerationOptions, CreateGenerationReturn } from './create-generation.svelte';
 import type { StreamChunk, TranscriptionResult } from '@tanstack/ai';
-import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutputFromReturn, TranscriptionGenerateInput } from '@tanstack/ai-client';
+import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, GenerationPersistenceOptions, InferGenerationOutputFromReturn, TranscriptionGenerateInput } from '@tanstack/ai-client';
 /**
  * Options for the createTranscription function.
  *
  * @template TOutput - The output type after optional transform (defaults to TranscriptionResult)
  */
-export interface CreateTranscriptionOptions<TOutput = TranscriptionResult> {
+export interface CreateTranscriptionOptions<TOutput = TranscriptionResult> extends Pick<CreateGenerationOptions<TranscriptionGenerateInput, TranscriptionResult, TOutput>, 'persistence' | 'threadId' | 'hydrateGeneration' | 'joinRun'> {
     /** Connect-based adapter for streaming transport (SSE, HTTP stream, custom) */
     connection?: ConnectConnectionAdapter;
     /** Direct async function for transcription */
     fetcher?: GenerationFetcher<TranscriptionGenerateInput, TranscriptionResult>;
-    /** Unique identifier for this generation instance */
+    /**
+     * @deprecated Prefer `threadId`. Only allowed when `threadId` is omitted (see `GenerationPersistenceOptions`).
+     */
     id?: string;
     /** Additional body parameters to send with connect-based adapter requests */
     body?: Record<string, any>;
@@ -36,7 +39,7 @@ export interface CreateTranscriptionOptions<TOutput = TranscriptionResult> {
  *
  * @template TOutput - The output type (after optional transform)
  */
-export interface CreateTranscriptionReturn<TOutput = TranscriptionResult> {
+export interface CreateTranscriptionReturn<TOutput = TranscriptionResult> extends Omit<CreateGenerationReturn<TOutput>, 'generate'> {
     /** The transcription result, or null */
     readonly result: TOutput | null;
     /** Whether transcription is in progress */
@@ -47,12 +50,6 @@ export interface CreateTranscriptionReturn<TOutput = TranscriptionResult> {
     readonly status: GenerationClientState;
     /** Trigger transcription */
     generate: (input: TranscriptionGenerateInput) => Promise<void>;
-    /** Abort the current transcription */
-    stop: () => void;
-    /** Clear result, error, and return to idle */
-    reset: () => void;
-    /** Update additional body parameters */
-    updateBody: (body: Record<string, any>) => void;
 }
 /**
  * Creates a reactive audio transcription instance for Svelte 5.
@@ -89,6 +86,6 @@ export interface CreateTranscriptionReturn<TOutput = TranscriptionResult> {
  * </div>
  * ```
  */
-export declare function createTranscription<TTransformed = void>(options: Omit<CreateTranscriptionOptions, 'onResult'> & {
+export declare function createTranscription<TTransformed = void>(options: Omit<CreateTranscriptionOptions, 'onResult' | 'persistence' | 'threadId' | 'id'> & {
     onResult?: (result: TranscriptionResult) => TTransformed;
-}): CreateTranscriptionReturn<InferGenerationOutputFromReturn<TranscriptionResult, TTransformed>>;
+} & GenerationPersistenceOptions): CreateTranscriptionReturn<InferGenerationOutputFromReturn<TranscriptionResult, TTransformed>>;

package/dist/create-transcription.svelte.js

@@ -1,4 +1,5 @@
 import { createGeneration } from './create-generation.svelte';
+import { reconstructTranscriptionResult } from '@tanstack/ai-client';
 /**
  * Creates a reactive audio transcription instance for Svelte 5.
  *
@@ -44,6 +45,7 @@ export function createTranscription(options) {
     const gen = createGeneration({
         ...options,
         devtools,
+        reconstructResult: reconstructTranscriptionResult,
     });
     return {
         get result() {
@@ -62,5 +64,9 @@ export function createTranscription(options) {
         stop: gen.stop,
         reset: gen.reset,
         updateBody: gen.updateBody,
+        dispose: gen.dispose,
+        get runId() {
+            return gen.runId;
+        },
     };
 }

package/dist/index.d.ts

@@ -16,4 +16,4 @@ export { createGenerateVideo } from './create-generate-video.svelte';
 export type { CreateGenerateVideoOptions, CreateGenerateVideoReturn, } from './create-generate-video.svelte';
 export { createAudioRecorder } from './create-audio-recorder.svelte';
 export type { CreateAudioRecorderOptions, CreateAudioRecorderReturn, } from './create-audio-recorder.svelte';
-export { fetchServerSentEvents, fetchHttpStream, xhrServerSentEvents, xhrHttpStream, stream, rpcStream, createChatClientOptions, clientTools, type ConnectionAdapter, type ConnectConnectionAdapter, type SubscribeConnectionAdapter, type RunAgentInputContext, type FetchConnectionOptions, type XhrConnectionOptions, type InferChatMessages, type GenerationClientState, type ImageGenerateInput, type AudioGenerateInput, type SpeechGenerateInput, type TranscriptionGenerateInput, type SummarizeGenerateInput, type VideoGenerateInput, type VideoGenerateResult, type VideoStatusInfo, } from '@tanstack/ai-client';
+export { fetchServerSentEvents, localStoragePersistence, sessionStoragePersistence, indexedDBPersistence, StorageUnavailableError, type ChatClientPersistence, type ChatPersistedState, type ChatPersistenceOption, type ChatStorageAdapter, type WebStoragePersistenceOptions, type IndexedDBPersistenceOptions, fetchHttpStream, xhrServerSentEvents, xhrHttpStream, stream, rpcStream, createChatClientOptions, clientTools, type ConnectionAdapter, type ConnectConnectionAdapter, type SubscribeConnectionAdapter, type RunAgentInputContext, type FetchConnectionOptions, type XhrConnectionOptions, type InferChatMessages, type GenerationClientState, type ImageGenerateInput, type AudioGenerateInput, type SpeechGenerateInput, type TranscriptionGenerateInput, type SummarizeGenerateInput, type VideoGenerateInput, type VideoGenerateResult, type VideoStatusInfo, } from '@tanstack/ai-client';

package/dist/index.js

@@ -9,4 +9,4 @@ export { createSummarize } from './create-summarize.svelte';
 export { createGenerateVideo } from './create-generate-video.svelte';
 export { createAudioRecorder } from './create-audio-recorder.svelte';
 // Re-export from ai-client for convenience
-export { fetchServerSentEvents, fetchHttpStream, xhrServerSentEvents, xhrHttpStream, stream, rpcStream, createChatClientOptions, clientTools, } from '@tanstack/ai-client';
+export { fetchServerSentEvents, localStoragePersistence, sessionStoragePersistence, indexedDBPersistence, StorageUnavailableError, fetchHttpStream, xhrServerSentEvents, xhrHttpStream, stream, rpcStream, createChatClientOptions, clientTools, } from '@tanstack/ai-client';

package/dist/types.d.ts

@@ -1,5 +1,5 @@
-import type { AnyClientTool, InferSchemaType, ModelMessage, SchemaInput } from '@tanstack/ai';
-import type { AIDevtoolsDisplayOptions, ChatClientOptions, ChatClientState, ChatRequestBody, ClientContextOptionFromTools, ConnectionStatus, DistributedOmit, InferredClientContext, MultimodalContent, QueueConfig, QueueOption, QueueStrategy, QueuedMessage, SendMessageOptions, UIMessage, WhenBusy } from '@tanstack/ai-client';
+import type { AnyClientTool, InferSchemaType, ModelMessage, RunAgentResumeItem, SchemaInput } from '@tanstack/ai';
+import type { AIDevtoolsDisplayOptions, BoundInterrupts, ChatClientOptions, ChatClientState, ChatInterrupt, ChatInterruptState, ChatRequestBody, ChatResumeState, 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
@@ -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' | 'onQueueChange' | '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' | 'onResumeStateChange' | 'onRunIdChange' | 'context' | 'devtools' | 'id'> & {
     live?: boolean;
     /** Display options for TanStack AI Devtools. */
     devtools?: AIDevtoolsDisplayOptions;
@@ -100,6 +100,32 @@ interface BaseCreateChatReturn<TTools extends ReadonlyArray<AnyClientTool> = any
         id: string;
         approved: boolean;
     }) => Promise<void>;
+    /**
+     * The id of the run this client has in flight — one it started or rejoined —
+     * or `null` when there is none (including while a run sits paused on an
+     * interrupt, waiting on approval).
+     *
+     * A run is one turn of the conversation, so this changes from turn to turn. A
+     * whole tool loop stays inside one run, while resuming after an interrupt
+     * continues the turn under a new id — so one user message can produce several
+     * run ids. Use it to talk to your own server about that run (cancel it, poll
+     * it, correlate a log line).
+     */
+    readonly runId: string | null;
+    readonly interrupts: BoundInterrupts<TTools>;
+    /** @deprecated Use `interrupts`. */
+    readonly pendingInterrupts: BoundInterrupts<TTools>;
+    readonly interruptErrors: ChatInterruptState<TTools>['interruptErrors'];
+    readonly resuming: boolean;
+    resolveInterrupts: {
+        (approved: boolean): void;
+        (resolver: (interrupt: ChatInterrupt<TTools>) => undefined): void;
+    };
+    cancelInterrupts: () => void;
+    retryInterrupts: () => void;
+    resumeInterruptsUnsafe: (resume: Array<RunAgentResumeItem>, state?: ChatResumeState) => Promise<boolean>;
+    /** @deprecated Use bound interrupt methods or `resumeInterruptsUnsafe`. */
+    resumeInterrupts: (resume: Array<RunAgentResumeItem>, state?: ChatResumeState) => Promise<boolean>;
     /**
      * Reload the last assistant message
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-svelte",
-  "version": "0.15.1",
+  "version": "0.16.0",
   "description": "Svelte 5 bindings for TanStack AI streaming chat, structured outputs, and media generation.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -46,11 +46,11 @@
     "media-generation"
   ],
   "dependencies": {
-    "@tanstack/ai-client": "0.22.1"
+    "@tanstack/ai-client": "0.23.0"
   },
   "peerDependencies": {
     "svelte": "^5.0.0",
-    "@tanstack/ai": "^0.42.0"
+    "@tanstack/ai": "^0.43.0"
   },
   "devDependencies": {
     "@standard-schema/spec": "^1.1.0",
@@ -62,13 +62,13 @@
     "svelte": "^5.20.0",
     "svelte-check": "^4.2.0",
     "typescript": "5.9.3",
-    "vite": "^7.3.3",
-    "@tanstack/ai": "0.42.0"
+    "vite": "^8.1.4",
+    "@tanstack/ai": "0.43.0"
   },
   "scripts": {
     "clean": "rm -rf ./dist",
-    "lint:fix": "eslint ./src --fix",
-    "test:eslint": "eslint ./src",
+    "lint:fix": "oxlint src --type-aware --fix",
+    "test:oxlint": "oxlint src --type-aware",
     "test:lib": "vitest run",
     "test:lib:dev": "pnpm test:lib --watch",
     "test:types": "svelte-check",