@tanstack/ai-svelte 0.6.6 → 0.6.7

package/dist/create-chat.svelte.js

@@ -38,6 +38,9 @@ export function createChat(options) {
     let isLoading = $state(false);
     let error = $state(undefined);
     let status = $state('ready');
+    let isSubscribed = $state(false);
+    let connectionStatus = $state('disconnected');
+    let sessionGenerating = $state(false);
     // Create ChatClient instance
     const client = new ChatClient({
         connection: options.connection,
@@ -67,7 +70,19 @@ export function createChat(options) {
         onErrorChange: (newError) => {
             error = newError;
         },
+        onSubscriptionChange: (nextIsSubscribed) => {
+            isSubscribed = nextIsSubscribed;
+        },
+        onConnectionStatusChange: (nextStatus) => {
+            connectionStatus = nextStatus;
+        },
+        onSessionGeneratingChange: (isGenerating) => {
+            sessionGenerating = isGenerating;
+        },
     });
+    if (options.live) {
+        client.subscribe();
+    }
     // Note: Cleanup is handled by calling stop() 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.
@@ -115,6 +130,15 @@ export function createChat(options) {
         get status() {
             return status;
         },
+        get isSubscribed() {
+            return isSubscribed;
+        },
+        get connectionStatus() {
+            return connectionStatus;
+        },
+        get sessionGenerating() {
+            return sessionGenerating;
+        },
         sendMessage,
         append,
         reload,

package/dist/create-generate-image.svelte.d.ts

@@ -1,18 +1,18 @@
 import type { ImageGenerationResult, StreamChunk } from '@tanstack/ai';
-import type { ConnectionAdapter, GenerationClientState, GenerationFetcher, ImageGenerateInput, InferGenerationOutput } from '@tanstack/ai-client';
+import type { ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, ImageGenerateInput, InferGenerationOutput } from '@tanstack/ai-client';
 /**
  * Options for the createGenerateImage function.
  *
  * @template TOutput - The output type after optional transform (defaults to ImageGenerationResult)
  */
 export interface CreateGenerateImageOptions<TOutput = ImageGenerationResult> {
-    /** Connection adapter for streaming transport (SSE, HTTP stream, custom) */
-    connection?: ConnectionAdapter;
+    /** Connect-based adapter for streaming transport (SSE, HTTP stream, custom) */
+    connection?: ConnectConnectionAdapter;
     /** Direct async function for image generation */
     fetcher?: GenerationFetcher<ImageGenerateInput, ImageGenerationResult>;
     /** Unique identifier for this generation instance */
     id?: string;
-    /** Additional body parameters to send with ConnectionAdapter requests */
+    /** Additional body parameters to send with connect-based adapter requests */
     body?: Record<string, any>;
     /**
      * Callback when images are generated. Can optionally return a transformed value.
@@ -26,7 +26,7 @@ export interface CreateGenerateImageOptions<TOutput = ImageGenerationResult> {
     onError?: (error: Error) => void;
     /** Callback when progress is reported (0-100) */
     onProgress?: (progress: number, message?: string) => void;
-    /** Callback for each stream chunk (ConnectionAdapter mode only) */
+    /** Callback for each stream chunk (connect-based adapter mode only) */
     onChunk?: (chunk: StreamChunk) => void;
 }
 /**
@@ -56,7 +56,7 @@ export interface CreateGenerateImageReturn<TOutput = ImageGenerationResult> {
  * Creates a reactive image generation instance for Svelte 5.
  *
  * Supports two transport modes:
- * - **ConnectionAdapter** -- Streaming transport (SSE, HTTP stream, custom)
+ * - **ConnectConnectionAdapter** -- Streaming transport (SSE, HTTP stream, custom)
  * - **Fetcher** -- Direct async function call
  *
  * @example

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

@@ -3,7 +3,7 @@ import { createGeneration } from './create-generation.svelte';
  * Creates a reactive image generation instance for Svelte 5.
  *
  * Supports two transport modes:
- * - **ConnectionAdapter** -- Streaming transport (SSE, HTTP stream, custom)
+ * - **ConnectConnectionAdapter** -- Streaming transport (SSE, HTTP stream, custom)
  * - **Fetcher** -- Direct async function call
  *
  * @example

package/dist/create-generate-speech.svelte.d.ts

@@ -1,18 +1,18 @@
 import type { StreamChunk, TTSResult } from '@tanstack/ai';
-import type { ConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput, SpeechGenerateInput } from '@tanstack/ai-client';
+import type { ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput, SpeechGenerateInput } from '@tanstack/ai-client';
 /**
  * Options for the createGenerateSpeech function.
  *
  * @template TOutput - The output type after optional transform (defaults to TTSResult)
  */
 export interface CreateGenerateSpeechOptions<TOutput = TTSResult> {
-    /** Connection adapter for streaming transport (SSE, HTTP stream, custom) */
-    connection?: ConnectionAdapter;
+    /** Connect-based adapter for streaming transport (SSE, HTTP stream, custom) */
+    connection?: ConnectConnectionAdapter;
     /** Direct async function for speech generation */
     fetcher?: GenerationFetcher<SpeechGenerateInput, TTSResult>;
     /** Unique identifier for this generation instance */
     id?: string;
-    /** Additional body parameters to send with ConnectionAdapter requests */
+    /** Additional body parameters to send with connect-based adapter requests */
     body?: Record<string, any>;
     /**
      * Callback when speech is generated. Can optionally return a transformed value.
@@ -26,7 +26,7 @@ export interface CreateGenerateSpeechOptions<TOutput = TTSResult> {
     onError?: (error: Error) => void;
     /** Callback when progress is reported (0-100) */
     onProgress?: (progress: number, message?: string) => void;
-    /** Callback for each stream chunk (ConnectionAdapter mode only) */
+    /** Callback for each stream chunk (connect-based adapter mode only) */
     onChunk?: (chunk: StreamChunk) => void;
 }
 /**

package/dist/create-generate-video.svelte.d.ts

@@ -1,18 +1,18 @@
 import type { StreamChunk } from '@tanstack/ai';
-import type { ConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput, VideoGenerateInput, VideoGenerateResult, VideoStatusInfo } from '@tanstack/ai-client';
+import type { ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput, VideoGenerateInput, VideoGenerateResult, VideoStatusInfo } from '@tanstack/ai-client';
 /**
  * Options for the createGenerateVideo function.
  *
  * @template TOutput - The output type after optional transform (defaults to VideoGenerateResult)
  */
 export interface CreateGenerateVideoOptions<TOutput = VideoGenerateResult> {
-    /** Connection adapter for streaming transport (server handles polling) */
-    connection?: ConnectionAdapter;
+    /** Connect-based adapter for streaming transport (server handles polling) */
+    connection?: ConnectConnectionAdapter;
     /** Direct async function that returns a completed video result */
     fetcher?: GenerationFetcher<VideoGenerateInput, VideoGenerateResult>;
     /** Unique identifier for this generation instance */
     id?: string;
-    /** Additional body parameters to send with ConnectionAdapter requests */
+    /** Additional body parameters to send with connect-based adapter requests */
     body?: Record<string, any>;
     /**
      * Callback when video generation completes. Can optionally return a transformed value.
@@ -30,7 +30,7 @@ export interface CreateGenerateVideoOptions<TOutput = VideoGenerateResult> {
     onJobCreated?: (jobId: string) => void;
     /** Callback on each status update */
     onStatusUpdate?: (status: VideoStatusInfo) => void;
-    /** Callback for each stream chunk (ConnectionAdapter mode only) */
+    /** Callback for each stream chunk (connect-based adapter mode only) */
     onChunk?: (chunk: StreamChunk) => void;
 }
 /**

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

@@ -1,5 +1,5 @@
 import type { StreamChunk } from '@tanstack/ai';
-import type { ConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput } from '@tanstack/ai-client';
+import type { ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput } from '@tanstack/ai-client';
 /**
  * Options for the createGeneration function.
  *
@@ -10,13 +10,13 @@ import type { ConnectionAdapter, GenerationClientState, GenerationFetcher, Infer
  * @template TOutput - The output type after optional transform (defaults to TResult)
  */
 export interface CreateGenerationOptions<TInput, TResult, TOutput = TResult> {
-    /** Connection adapter for streaming transport (SSE, HTTP stream, custom) */
-    connection?: ConnectionAdapter;
+    /** Connect-based adapter for streaming transport (SSE, HTTP stream, custom) */
+    connection?: ConnectConnectionAdapter;
     /** Direct async function for one-shot generation (no streaming protocol needed) */
     fetcher?: GenerationFetcher<TInput, TResult>;
     /** Unique identifier for this generation instance */
     id?: string;
-    /** Additional body parameters to send with ConnectionAdapter requests */
+    /** Additional body parameters to send with connect-based adapter requests */
     body?: Record<string, any>;
     /**
      * Callback when a result is received. Can optionally return a transformed value.
@@ -30,7 +30,7 @@ export interface CreateGenerationOptions<TInput, TResult, TOutput = TResult> {
     onError?: (error: Error) => void;
     /** Callback when progress is reported (0-100) */
     onProgress?: (progress: number, message?: string) => void;
-    /** Callback for each stream chunk (ConnectionAdapter mode only) */
+    /** Callback for each stream chunk (connect-based adapter mode only) */
     onChunk?: (chunk: StreamChunk) => void;
 }
 /**

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

@@ -1,18 +1,18 @@
 import type { StreamChunk, SummarizationResult } from '@tanstack/ai';
-import type { ConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput, SummarizeGenerateInput } from '@tanstack/ai-client';
+import type { ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput, 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> {
-    /** Connection adapter for streaming transport (SSE, HTTP stream, custom) */
-    connection?: ConnectionAdapter;
+    /** 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 */
     id?: string;
-    /** Additional body parameters to send with ConnectionAdapter requests */
+    /** Additional body parameters to send with connect-based adapter requests */
     body?: Record<string, any>;
     /**
      * Callback when summarization is complete. Can optionally return a transformed value.
@@ -26,7 +26,7 @@ export interface CreateSummarizeOptions<TOutput = SummarizationResult> {
     onError?: (error: Error) => void;
     /** Callback when progress is reported (0-100) */
     onProgress?: (progress: number, message?: string) => void;
-    /** Callback for each stream chunk (ConnectionAdapter mode only) */
+    /** Callback for each stream chunk (connect-based adapter mode only) */
     onChunk?: (chunk: StreamChunk) => void;
 }
 /**

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

@@ -1,18 +1,18 @@
 import type { StreamChunk, TranscriptionResult } from '@tanstack/ai';
-import type { ConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput, TranscriptionGenerateInput } from '@tanstack/ai-client';
+import type { ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput, 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> {
-    /** Connection adapter for streaming transport (SSE, HTTP stream, custom) */
-    connection?: ConnectionAdapter;
+    /** 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 */
     id?: string;
-    /** Additional body parameters to send with ConnectionAdapter requests */
+    /** Additional body parameters to send with connect-based adapter requests */
     body?: Record<string, any>;
     /**
      * Callback when transcription is complete. Can optionally return a transformed value.
@@ -26,7 +26,7 @@ export interface CreateTranscriptionOptions<TOutput = TranscriptionResult> {
     onError?: (error: Error) => void;
     /** Callback when progress is reported (0-100) */
     onProgress?: (progress: number, message?: string) => void;
-    /** Callback for each stream chunk (ConnectionAdapter mode only) */
+    /** Callback for each stream chunk (connect-based adapter mode only) */
     onChunk?: (chunk: StreamChunk) => void;
 }
 /**

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import type { AnyClientTool, ModelMessage } from '@tanstack/ai';
-import type { ChatClientOptions, ChatClientState, ChatRequestBody, MultimodalContent, UIMessage } from '@tanstack/ai-client';
+import type { ChatClientOptions, ChatClientState, ChatRequestBody, ConnectionStatus, MultimodalContent, UIMessage } from '@tanstack/ai-client';
 export type { ChatRequestBody, MultimodalContent, UIMessage };
 /**
  * Options for the createChat function.
@@ -17,7 +17,9 @@ export type { ChatRequestBody, MultimodalContent, UIMessage };
  * 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> = Omit<ChatClientOptions<TTools>, 'onMessagesChange' | 'onLoadingChange' | 'onErrorChange' | 'onStatusChange'>;
+export type CreateChatOptions<TTools extends ReadonlyArray<AnyClientTool> = any> = Omit<ChatClientOptions<TTools>, 'onMessagesChange' | 'onLoadingChange' | 'onErrorChange' | 'onStatusChange' | 'onSubscriptionChange' | 'onConnectionStatusChange' | 'onSessionGeneratingChange'> & {
+    live?: boolean;
+};
 export interface CreateChatReturn<TTools extends ReadonlyArray<AnyClientTool> = any> {
     /**
      * Current messages in the conversation (reactive getter)
@@ -77,6 +79,21 @@ export interface CreateChatReturn<TTools extends ReadonlyArray<AnyClientTool> =
      * Current generation status (reactive getter)
      */
     readonly status: ChatClientState;
+    /**
+     * Whether the subscription loop is currently active (reactive getter)
+     */
+    readonly isSubscribed: boolean;
+    /**
+     * Current connection lifecycle status (reactive getter)
+     */
+    readonly connectionStatus: ConnectionStatus;
+    /**
+     * Whether the shared session is actively generating (reactive getter).
+     * Derived from stream run events (RUN_STARTED / RUN_FINISHED / RUN_ERROR).
+     * Unlike `isLoading` (request-local), this reflects shared generation
+     * activity visible to all subscribers (e.g. across tabs/devices).
+     */
+    readonly sessionGenerating: boolean;
     /**
      * Update the body sent with requests (e.g., for changing model selection)
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-svelte",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "description": "Svelte bindings for TanStack AI",
   "author": "",
   "license": "MIT",
@@ -33,11 +33,11 @@
     "streaming"
   ],
   "dependencies": {
-    "@tanstack/ai-client": "0.7.1"
+    "@tanstack/ai-client": "0.7.2"
   },
   "peerDependencies": {
     "svelte": "^5.0.0",
-    "@tanstack/ai": "^0.8.0"
+    "@tanstack/ai": "^0.8.1"
   },
   "devDependencies": {
     "@sveltejs/package": "^2.3.10",
@@ -49,7 +49,7 @@
     "svelte-check": "^4.2.0",
     "typescript": "5.9.3",
     "vite": "^7.2.7",
-    "@tanstack/ai": "0.8.0"
+    "@tanstack/ai": "0.8.1"
   },
   "scripts": {
     "clean": "rm -rf ./dist",

package/src/create-chat.svelte.ts

@@ -1,5 +1,5 @@
 import { ChatClient } from '@tanstack/ai-client'
-import type { ChatClientState } from '@tanstack/ai-client'
+import type { ChatClientState, ConnectionStatus } from '@tanstack/ai-client'
 import type { AnyClientTool, ModelMessage } from '@tanstack/ai'
 import type {
   CreateChatOptions,
@@ -51,6 +51,9 @@ export function createChat<TTools extends ReadonlyArray<AnyClientTool> = any>(
   let isLoading = $state(false)
   let error = $state<Error | undefined>(undefined)
   let status = $state<ChatClientState>('ready')
+  let isSubscribed = $state(false)
+  let connectionStatus = $state<ConnectionStatus>('disconnected')
+  let sessionGenerating = $state(false)
 
   // Create ChatClient instance
   const client = new ChatClient({
@@ -81,8 +84,21 @@ export function createChat<TTools extends ReadonlyArray<AnyClientTool> = any>(
     onErrorChange: (newError: Error | undefined) => {
       error = newError
     },
+    onSubscriptionChange: (nextIsSubscribed: boolean) => {
+      isSubscribed = nextIsSubscribed
+    },
+    onConnectionStatusChange: (nextStatus: ConnectionStatus) => {
+      connectionStatus = nextStatus
+    },
+    onSessionGeneratingChange: (isGenerating: boolean) => {
+      sessionGenerating = isGenerating
+    },
   })
 
+  if (options.live) {
+    client.subscribe()
+  }
+
   // Note: Cleanup is handled by calling stop() 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.
@@ -149,6 +165,15 @@ export function createChat<TTools extends ReadonlyArray<AnyClientTool> = any>(
     get status() {
       return status
     },
+    get isSubscribed() {
+      return isSubscribed
+    },
+    get connectionStatus() {
+      return connectionStatus
+    },
+    get sessionGenerating() {
+      return sessionGenerating
+    },
     sendMessage,
     append,
     reload,

package/src/create-generate-image.svelte.ts

@@ -1,7 +1,7 @@
 import { createGeneration } from './create-generation.svelte'
 import type { ImageGenerationResult, StreamChunk } from '@tanstack/ai'
 import type {
-  ConnectionAdapter,
+  ConnectConnectionAdapter,
   GenerationClientState,
   GenerationFetcher,
   ImageGenerateInput,
@@ -14,13 +14,13 @@ import type {
  * @template TOutput - The output type after optional transform (defaults to ImageGenerationResult)
  */
 export interface CreateGenerateImageOptions<TOutput = ImageGenerationResult> {
-  /** Connection adapter for streaming transport (SSE, HTTP stream, custom) */
-  connection?: ConnectionAdapter
+  /** Connect-based adapter for streaming transport (SSE, HTTP stream, custom) */
+  connection?: ConnectConnectionAdapter
   /** Direct async function for image generation */
   fetcher?: GenerationFetcher<ImageGenerateInput, ImageGenerationResult>
   /** Unique identifier for this generation instance */
   id?: string
-  /** Additional body parameters to send with ConnectionAdapter requests */
+  /** Additional body parameters to send with connect-based adapter requests */
   body?: Record<string, any>
   /**
    * Callback when images are generated. Can optionally return a transformed value.
@@ -34,7 +34,7 @@ export interface CreateGenerateImageOptions<TOutput = ImageGenerationResult> {
   onError?: (error: Error) => void
   /** Callback when progress is reported (0-100) */
   onProgress?: (progress: number, message?: string) => void
-  /** Callback for each stream chunk (ConnectionAdapter mode only) */
+  /** Callback for each stream chunk (connect-based adapter mode only) */
   onChunk?: (chunk: StreamChunk) => void
 }
 
@@ -66,7 +66,7 @@ export interface CreateGenerateImageReturn<TOutput = ImageGenerationResult> {
  * Creates a reactive image generation instance for Svelte 5.
  *
  * Supports two transport modes:
- * - **ConnectionAdapter** -- Streaming transport (SSE, HTTP stream, custom)
+ * - **ConnectConnectionAdapter** -- Streaming transport (SSE, HTTP stream, custom)
  * - **Fetcher** -- Direct async function call
  *
  * @example

package/src/create-generate-speech.svelte.ts

@@ -1,7 +1,7 @@
 import { createGeneration } from './create-generation.svelte'
 import type { StreamChunk, TTSResult } from '@tanstack/ai'
 import type {
-  ConnectionAdapter,
+  ConnectConnectionAdapter,
   GenerationClientState,
   GenerationFetcher,
   InferGenerationOutput,
@@ -14,13 +14,13 @@ import type {
  * @template TOutput - The output type after optional transform (defaults to TTSResult)
  */
 export interface CreateGenerateSpeechOptions<TOutput = TTSResult> {
-  /** Connection adapter for streaming transport (SSE, HTTP stream, custom) */
-  connection?: ConnectionAdapter
+  /** Connect-based adapter for streaming transport (SSE, HTTP stream, custom) */
+  connection?: ConnectConnectionAdapter
   /** Direct async function for speech generation */
   fetcher?: GenerationFetcher<SpeechGenerateInput, TTSResult>
   /** Unique identifier for this generation instance */
   id?: string
-  /** Additional body parameters to send with ConnectionAdapter requests */
+  /** Additional body parameters to send with connect-based adapter requests */
   body?: Record<string, any>
   /**
    * Callback when speech is generated. Can optionally return a transformed value.
@@ -34,7 +34,7 @@ export interface CreateGenerateSpeechOptions<TOutput = TTSResult> {
   onError?: (error: Error) => void
   /** Callback when progress is reported (0-100) */
   onProgress?: (progress: number, message?: string) => void
-  /** Callback for each stream chunk (ConnectionAdapter mode only) */
+  /** Callback for each stream chunk (connect-based adapter mode only) */
   onChunk?: (chunk: StreamChunk) => void
 }
 

package/src/create-generate-video.svelte.ts

@@ -1,7 +1,7 @@
 import { VideoGenerationClient } from '@tanstack/ai-client'
 import type { StreamChunk } from '@tanstack/ai'
 import type {
-  ConnectionAdapter,
+  ConnectConnectionAdapter,
   GenerationClientState,
   GenerationFetcher,
   InferGenerationOutput,
@@ -16,13 +16,13 @@ import type {
  * @template TOutput - The output type after optional transform (defaults to VideoGenerateResult)
  */
 export interface CreateGenerateVideoOptions<TOutput = VideoGenerateResult> {
-  /** Connection adapter for streaming transport (server handles polling) */
-  connection?: ConnectionAdapter
+  /** Connect-based adapter for streaming transport (server handles polling) */
+  connection?: ConnectConnectionAdapter
   /** Direct async function that returns a completed video result */
   fetcher?: GenerationFetcher<VideoGenerateInput, VideoGenerateResult>
   /** Unique identifier for this generation instance */
   id?: string
-  /** Additional body parameters to send with ConnectionAdapter requests */
+  /** Additional body parameters to send with connect-based adapter requests */
   body?: Record<string, any>
   /**
    * Callback when video generation completes. Can optionally return a transformed value.
@@ -40,7 +40,7 @@ export interface CreateGenerateVideoOptions<TOutput = VideoGenerateResult> {
   onJobCreated?: (jobId: string) => void
   /** Callback on each status update */
   onStatusUpdate?: (status: VideoStatusInfo) => void
-  /** Callback for each stream chunk (ConnectionAdapter mode only) */
+  /** Callback for each stream chunk (connect-based adapter mode only) */
   onChunk?: (chunk: StreamChunk) => void
 }
 

package/src/create-generation.svelte.ts

@@ -1,7 +1,7 @@
 import { GenerationClient } from '@tanstack/ai-client'
 import type { StreamChunk } from '@tanstack/ai'
 import type {
-  ConnectionAdapter,
+  ConnectConnectionAdapter,
   GenerationClientOptions,
   GenerationClientState,
   GenerationFetcher,
@@ -18,13 +18,13 @@ import type {
  * @template TOutput - The output type after optional transform (defaults to TResult)
  */
 export interface CreateGenerationOptions<TInput, TResult, TOutput = TResult> {
-  /** Connection adapter for streaming transport (SSE, HTTP stream, custom) */
-  connection?: ConnectionAdapter
+  /** Connect-based adapter for streaming transport (SSE, HTTP stream, custom) */
+  connection?: ConnectConnectionAdapter
   /** Direct async function for one-shot generation (no streaming protocol needed) */
   fetcher?: GenerationFetcher<TInput, TResult>
   /** Unique identifier for this generation instance */
   id?: string
-  /** Additional body parameters to send with ConnectionAdapter requests */
+  /** Additional body parameters to send with connect-based adapter requests */
   body?: Record<string, any>
   /**
    * Callback when a result is received. Can optionally return a transformed value.
@@ -38,7 +38,7 @@ export interface CreateGenerationOptions<TInput, TResult, TOutput = TResult> {
   onError?: (error: Error) => void
   /** Callback when progress is reported (0-100) */
   onProgress?: (progress: number, message?: string) => void
-  /** Callback for each stream chunk (ConnectionAdapter mode only) */
+  /** Callback for each stream chunk (connect-based adapter mode only) */
   onChunk?: (chunk: StreamChunk) => void
 }
 

package/src/create-summarize.svelte.ts

@@ -1,7 +1,7 @@
 import { createGeneration } from './create-generation.svelte'
 import type { StreamChunk, SummarizationResult } from '@tanstack/ai'
 import type {
-  ConnectionAdapter,
+  ConnectConnectionAdapter,
   GenerationClientState,
   GenerationFetcher,
   InferGenerationOutput,
@@ -14,13 +14,13 @@ import type {
  * @template TOutput - The output type after optional transform (defaults to SummarizationResult)
  */
 export interface CreateSummarizeOptions<TOutput = SummarizationResult> {
-  /** Connection adapter for streaming transport (SSE, HTTP stream, custom) */
-  connection?: ConnectionAdapter
+  /** 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 */
   id?: string
-  /** Additional body parameters to send with ConnectionAdapter requests */
+  /** Additional body parameters to send with connect-based adapter requests */
   body?: Record<string, any>
   /**
    * Callback when summarization is complete. Can optionally return a transformed value.
@@ -34,7 +34,7 @@ export interface CreateSummarizeOptions<TOutput = SummarizationResult> {
   onError?: (error: Error) => void
   /** Callback when progress is reported (0-100) */
   onProgress?: (progress: number, message?: string) => void
-  /** Callback for each stream chunk (ConnectionAdapter mode only) */
+  /** Callback for each stream chunk (connect-based adapter mode only) */
   onChunk?: (chunk: StreamChunk) => void
 }
 

package/src/create-transcription.svelte.ts

@@ -1,7 +1,7 @@
 import { createGeneration } from './create-generation.svelte'
 import type { StreamChunk, TranscriptionResult } from '@tanstack/ai'
 import type {
-  ConnectionAdapter,
+  ConnectConnectionAdapter,
   GenerationClientState,
   GenerationFetcher,
   InferGenerationOutput,
@@ -14,13 +14,13 @@ import type {
  * @template TOutput - The output type after optional transform (defaults to TranscriptionResult)
  */
 export interface CreateTranscriptionOptions<TOutput = TranscriptionResult> {
-  /** Connection adapter for streaming transport (SSE, HTTP stream, custom) */
-  connection?: ConnectionAdapter
+  /** 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 */
   id?: string
-  /** Additional body parameters to send with ConnectionAdapter requests */
+  /** Additional body parameters to send with connect-based adapter requests */
   body?: Record<string, any>
   /**
    * Callback when transcription is complete. Can optionally return a transformed value.
@@ -34,7 +34,7 @@ export interface CreateTranscriptionOptions<TOutput = TranscriptionResult> {
   onError?: (error: Error) => void
   /** Callback when progress is reported (0-100) */
   onProgress?: (progress: number, message?: string) => void
-  /** Callback for each stream chunk (ConnectionAdapter mode only) */
+  /** Callback for each stream chunk (connect-based adapter mode only) */
   onChunk?: (chunk: StreamChunk) => void
 }
 

package/src/types.ts

@@ -3,6 +3,7 @@ import type {
   ChatClientOptions,
   ChatClientState,
   ChatRequestBody,
+  ConnectionStatus,
   MultimodalContent,
   UIMessage,
 } from '@tanstack/ai-client'
@@ -30,8 +31,16 @@ export type CreateChatOptions<
   TTools extends ReadonlyArray<AnyClientTool> = any,
 > = Omit<
   ChatClientOptions<TTools>,
-  'onMessagesChange' | 'onLoadingChange' | 'onErrorChange' | 'onStatusChange'
->
+  | 'onMessagesChange'
+  | 'onLoadingChange'
+  | 'onErrorChange'
+  | 'onStatusChange'
+  | 'onSubscriptionChange'
+  | 'onConnectionStatusChange'
+  | 'onSessionGeneratingChange'
+> & {
+  live?: boolean
+}
 
 export interface CreateChatReturn<
   TTools extends ReadonlyArray<AnyClientTool> = any,
@@ -105,6 +114,21 @@ export interface CreateChatReturn<
    * Current generation status (reactive getter)
    */
   readonly status: ChatClientState
+  /**
+   * Whether the subscription loop is currently active (reactive getter)
+   */
+  readonly isSubscribed: boolean
+  /**
+   * Current connection lifecycle status (reactive getter)
+   */
+  readonly connectionStatus: ConnectionStatus
+  /**
+   * Whether the shared session is actively generating (reactive getter).
+   * Derived from stream run events (RUN_STARTED / RUN_FINISHED / RUN_ERROR).
+   * Unlike `isLoading` (request-local), this reflects shared generation
+   * activity visible to all subscribers (e.g. across tabs/devices).
+   */
+  readonly sessionGenerating: boolean
   /**
    * Update the body sent with requests (e.g., for changing model selection)
    */