@tanstack/ai-react 0.15.14 → 0.15.15

package/dist/esm/index.d.ts

@@ -0,0 +1,19 @@
+export { useChat } from './use-chat.js';
+export { useRealtimeChat } from './use-realtime-chat.js';
+export type { DeepPartial, UseChatOptions, UseChatReturn, UIMessage, ChatRequestBody, } from './types.js';
+export type { UseRealtimeChatOptions, UseRealtimeChatReturn, } from './realtime-types.js';
+export { useGeneration } from './use-generation.js';
+export type { UseGenerationOptions, UseGenerationReturn, } from './use-generation.js';
+export { useGenerateImage } from './use-generate-image.js';
+export type { UseGenerateImageOptions, UseGenerateImageReturn, } from './use-generate-image.js';
+export { useGenerateAudio } from './use-generate-audio.js';
+export type { UseGenerateAudioOptions, UseGenerateAudioReturn, } from './use-generate-audio.js';
+export { useGenerateSpeech } from './use-generate-speech.js';
+export type { UseGenerateSpeechOptions, UseGenerateSpeechReturn, } from './use-generate-speech.js';
+export { useTranscription } from './use-transcription.js';
+export type { UseTranscriptionOptions, UseTranscriptionReturn, } from './use-transcription.js';
+export { useSummarize } from './use-summarize.js';
+export type { UseSummarizeOptions, UseSummarizeReturn } from './use-summarize.js';
+export { useGenerateVideo } from './use-generate-video.js';
+export type { UseGenerateVideoOptions, UseGenerateVideoReturn, } from './use-generate-video.js';
+export { fetchServerSentEvents, fetchHttpStream, xhrServerSentEvents, xhrHttpStream, stream, rpcStream, createChatClientOptions, type ChatFetcher, type ChatFetcherInput, type ChatFetcherOptions, 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/esm/index.js

@@ -0,0 +1,29 @@
+import { useChat } from "./use-chat.js";
+import { useRealtimeChat } from "./use-realtime-chat.js";
+import { useGeneration } from "./use-generation.js";
+import { useGenerateImage } from "./use-generate-image.js";
+import { useGenerateAudio } from "./use-generate-audio.js";
+import { useGenerateSpeech } from "./use-generate-speech.js";
+import { useTranscription } from "./use-transcription.js";
+import { useSummarize } from "./use-summarize.js";
+import { useGenerateVideo } from "./use-generate-video.js";
+import { createChatClientOptions, fetchHttpStream, fetchServerSentEvents, rpcStream, stream, xhrHttpStream, xhrServerSentEvents } from "@tanstack/ai-client";
+export {
+  createChatClientOptions,
+  fetchHttpStream,
+  fetchServerSentEvents,
+  rpcStream,
+  stream,
+  useChat,
+  useGenerateAudio,
+  useGenerateImage,
+  useGenerateSpeech,
+  useGenerateVideo,
+  useGeneration,
+  useRealtimeChat,
+  useSummarize,
+  useTranscription,
+  xhrHttpStream,
+  xhrServerSentEvents
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}

package/dist/esm/realtime-types.d.ts

@@ -0,0 +1,109 @@
+import { AnyClientTool, RealtimeMessage, RealtimeMode, RealtimeStatus, RealtimeToken } from '@tanstack/ai';
+import { RealtimeAdapter } from '@tanstack/ai-client';
+/**
+ * Options for the useRealtimeChat hook.
+ */
+export interface UseRealtimeChatOptions {
+    /**
+     * Function to fetch a realtime token from the server.
+     * Called on connect and when token needs refresh.
+     */
+    getToken: () => Promise<RealtimeToken>;
+    /**
+     * The realtime adapter to use (e.g., openaiRealtime())
+     */
+    adapter: RealtimeAdapter;
+    /**
+     * Client-side tools with execution logic
+     */
+    tools?: ReadonlyArray<AnyClientTool>;
+    /**
+     * Auto-play assistant audio (default: true)
+     */
+    autoPlayback?: boolean;
+    /**
+     * Request microphone access on connect (default: true)
+     */
+    autoCapture?: boolean;
+    /**
+     * System instructions for the assistant
+     */
+    instructions?: string;
+    /**
+     * Voice to use for audio output
+     */
+    voice?: string;
+    /**
+     * Voice activity detection mode (default: 'server')
+     */
+    vadMode?: 'server' | 'semantic' | 'manual';
+    /**
+     * Output modalities for responses (e.g., ['audio', 'text'])
+     */
+    outputModalities?: Array<'audio' | 'text'>;
+    /**
+     * Temperature for generation (provider-specific range)
+     */
+    temperature?: number;
+    /**
+     * Maximum number of tokens in a response
+     */
+    maxOutputTokens?: number | 'inf';
+    /**
+     * Eagerness level for semantic VAD ('low', 'medium', 'high')
+     */
+    semanticEagerness?: 'low' | 'medium' | 'high';
+    onConnect?: () => void;
+    onDisconnect?: () => void;
+    onError?: (error: Error) => void;
+    onMessage?: (message: RealtimeMessage) => void;
+    onModeChange?: (mode: RealtimeMode) => void;
+    onInterrupted?: () => void;
+}
+/**
+ * Return type for the useRealtimeChat hook.
+ */
+export interface UseRealtimeChatReturn {
+    /** Current connection status */
+    status: RealtimeStatus;
+    /** Current error, if any */
+    error: Error | null;
+    /** Connect to the realtime session */
+    connect: () => Promise<void>;
+    /** Disconnect from the realtime session */
+    disconnect: () => Promise<void>;
+    /** Current mode (idle, listening, thinking, speaking) */
+    mode: RealtimeMode;
+    /** Conversation messages */
+    messages: Array<RealtimeMessage>;
+    /** User transcript while speaking (before finalized) */
+    pendingUserTranscript: string | null;
+    /** Assistant transcript while speaking (before finalized) */
+    pendingAssistantTranscript: string | null;
+    /** Start listening for voice input (manual VAD mode) */
+    startListening: () => void;
+    /** Stop listening for voice input (manual VAD mode) */
+    stopListening: () => void;
+    /** Interrupt the current assistant response */
+    interrupt: () => void;
+    /** Send a text message instead of voice */
+    sendText: (text: string) => void;
+    /** Send an image to the conversation */
+    sendImage: (imageData: string, mimeType: string) => void;
+    /** Current input (microphone) volume level */
+    inputLevel: number;
+    /** Current output (speaker) volume level */
+    outputLevel: number;
+    /** Get frequency data for input audio visualization */
+    getInputFrequencyData: () => Uint8Array;
+    /** Get frequency data for output audio visualization */
+    getOutputFrequencyData: () => Uint8Array;
+    /** Get time domain data for input waveform */
+    getInputTimeDomainData: () => Uint8Array;
+    /** Get time domain data for output waveform */
+    getOutputTimeDomainData: () => Uint8Array;
+    /** Current VAD mode */
+    vadMode: 'server' | 'semantic' | 'manual';
+    /** Change VAD mode at runtime */
+    setVADMode: (mode: 'server' | 'semantic' | 'manual') => void;
+}

package/dist/esm/types.d.ts

@@ -0,0 +1,150 @@
+import { AnyClientTool, InferSchemaType, ModelMessage, SchemaInput } from '@tanstack/ai/client';
+import { AIDevtoolsDisplayOptions, ChatClientOptions, ChatClientState, ChatRequestBody, ClientContextOptionFromTools, ConnectionStatus, DistributedOmit, InferredClientContext, MultimodalContent, UIMessage } from '@tanstack/ai-client';
+export type { ChatRequestBody, MultimodalContent, UIMessage };
+/**
+ * Recursive partial — every property and every nested array element is optional.
+ * Used to type the in-flight `partial` value the hook exposes while a structured
+ * output stream is still arriving (the JSON has shape but is incomplete).
+ */
+export type DeepPartial<T> = T extends ReadonlyArray<infer U> ? Array<DeepPartial<U>> : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+/**
+ * Options for the useChat hook.
+ *
+ * Pass either `connection` or `fetcher` — the XOR is enforced at the type
+ * level via `ChatTransport`.
+ *
+ * This extends ChatClientOptions but omits the state change callbacks that are
+ * managed internally by React state:
+ * - `onMessagesChange` - Managed by React state (exposed as `messages`)
+ * - `onLoadingChange` - Managed by React state (exposed as `isLoading`)
+ * - `onErrorChange` - Managed by React state (exposed as `error`)
+ * - `onStatusChange` - Managed by React state (exposed as `status`)
+ *
+ * All other callbacks (onResponse, onChunk, onFinish, onError) are
+ * passed through to the underlying ChatClient and can be used for side effects.
+ *
+ * When `outputSchema` is supplied, the hook returns a typed `partial` (live
+ * progressive object, updated from `TEXT_MESSAGE_CONTENT` deltas via
+ * `parsePartialJSON`) and `final` (validated terminal payload from the
+ * `structured-output.complete` event). The schema is used purely for type
+ * inference on the client — server-side validation still runs against the
+ * schema you pass to `chat({ outputSchema })` on the server route.
+ *
+ * Note: Connection and body changes will recreate the ChatClient instance.
+ * To update these options, remount the component or use a key prop.
+ */
+export type UseChatOptions<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'> & {
+    /** Display options for TanStack AI Devtools. */
+    devtools?: AIDevtoolsDisplayOptions;
+    /**
+     * Opt into mount-time live subscription behavior.
+     * When enabled, the hook subscribes on mount and unsubscribes on unmount.
+     */
+    live?: boolean;
+    /**
+     * Standard-schema-compatible schema (Zod, Valibot, ArkType, or a plain JSON
+     * Schema). Used to infer the shape of `partial` and `final` in the return.
+     * The schema is **not** sent to the server — server-side validation runs
+     * against the schema passed to `chat({ outputSchema })` on the server route.
+     */
+    outputSchema?: TSchema;
+} & ClientContextOptionFromTools<TTools, TContext>;
+/**
+ * Discriminated return shape: when `outputSchema` is supplied, the hook adds
+ * typed `partial` / `final` fields; when it is omitted (default), the return
+ * is unchanged.
+ */
+export type UseChatReturn<TTools extends ReadonlyArray<AnyClientTool> = any, TSchema extends SchemaInput | undefined = undefined> = BaseUseChatReturn<TTools, TSchema extends SchemaInput ? InferSchemaType<TSchema> : unknown> & (TSchema extends SchemaInput ? {
+    /**
+     * Live, progressively-parsed structured output. Updated from
+     * `TEXT_MESSAGE_CONTENT` deltas via `parsePartialJSON` while the stream
+     * is still arriving, and snapped to the validated payload when
+     * `structured-output.complete` fires. Resets on every new run
+     * (`sendMessage` / `reload`).
+     */
+    partial: DeepPartial<InferSchemaType<TSchema>>;
+    /**
+     * Final, schema-validated structured output. `null` until the terminal
+     * `structured-output.complete` event arrives. Resets on every new run.
+     */
+    final: InferSchemaType<TSchema> | null;
+} : Record<never, never>);
+interface BaseUseChatReturn<TTools extends ReadonlyArray<AnyClientTool> = any, TData = unknown> {
+    /**
+     * Current messages in the conversation. When `outputSchema` is supplied,
+     * `messages[i].parts.find(p => p.type === 'structured-output')` is typed
+     * with the schema's inferred shape — `data: T`, `partial: DeepPartial<T>`.
+     */
+    messages: Array<UIMessage<TTools, TData>>;
+    /**
+     * 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>;
+    /**
+     * Append a message to the conversation
+     */
+    append: (message: ModelMessage | UIMessage<TTools, TData>) => Promise<void>;
+    /**
+     * Add the result of a client-side tool execution
+     */
+    addToolResult: (result: {
+        toolCallId: string;
+        tool: string;
+        output: any;
+        state?: 'output-available' | 'output-error';
+        errorText?: string;
+    }) => Promise<void>;
+    /**
+     * Respond to a tool approval request
+     */
+    addToolApprovalResponse: (response: {
+        id: string;
+        approved: boolean;
+    }) => Promise<void>;
+    /**
+     * Reload the last assistant message
+     */
+    reload: () => Promise<void>;
+    /**
+     * Stop the current response generation
+     */
+    stop: () => void;
+    /**
+     * Whether a response is currently being generated
+     */
+    isLoading: boolean;
+    /**
+     * Current error, if any
+     */
+    error: Error | undefined;
+    /**
+     * Current status of the chat client
+     */
+    status: ChatClientState;
+    /**
+     * Whether the subscription loop is currently active
+     */
+    isSubscribed: boolean;
+    /**
+     * Current connection lifecycle status
+     */
+    connectionStatus: ConnectionStatus;
+    /**
+     * Whether the shared session is actively generating.
+     * 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).
+     */
+    sessionGenerating: boolean;
+    /**
+     * Set messages manually
+     */
+    setMessages: (messages: Array<UIMessage<TTools, TData>>) => void;
+    /**
+     * Clear all messages
+     */
+    clear: () => void;
+}

package/dist/esm/use-chat.d.ts

@@ -0,0 +1,4 @@
+import { AnyClientTool, SchemaInput } from '@tanstack/ai/client';
+import { InferredClientContext } from '@tanstack/ai-client';
+import { UseChatOptions, UseChatReturn } from './types.js';
+export declare function useChat<TTools extends ReadonlyArray<AnyClientTool> = any, TSchema extends SchemaInput | undefined = undefined, TContext = InferredClientContext<TTools>>(options: UseChatOptions<TTools, TSchema, TContext>): UseChatReturn<TTools, TSchema>;

package/dist/esm/use-chat.js

@@ -0,0 +1,258 @@
+import { ChatClient } from "@tanstack/ai-client";
+import { createChatDevtoolsBridge } from "@tanstack/ai-client/devtools";
+import { useId, useState, useRef, useMemo, useEffect, useCallback } from "react";
+function useChat(options) {
+  const hookId = useId();
+  const clientId = options.id || hookId;
+  const [messages, setMessages] = useState(
+    options.initialMessages || []
+  );
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState(void 0);
+  const [status, setStatus] = useState("ready");
+  const [isSubscribed, setIsSubscribed] = useState(false);
+  const [connectionStatus, setConnectionStatus] = useState("disconnected");
+  const [sessionGenerating, setSessionGenerating] = useState(false);
+  const messagesRef = useRef(
+    options.initialMessages || []
+  );
+  const isFirstMountRef = useRef(true);
+  const activeClientRef = useRef(null);
+  const cleanupInvalidationRef = useRef(
+    null
+  );
+  messagesRef.current = messages;
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+  const client = useMemo(() => {
+    const messagesToUse = options.initialMessages || [];
+    isFirstMountRef.current = false;
+    const initialOptions = optionsRef.current;
+    const transport = initialOptions.connection ? { connection: initialOptions.connection } : { fetcher: initialOptions.fetcher };
+    const instance = new ChatClient({
+      devtoolsBridgeFactory: createChatDevtoolsBridge,
+      ...transport,
+      id: clientId,
+      initialMessages: messagesToUse,
+      ...initialOptions.body !== void 0 && { body: initialOptions.body },
+      ...initialOptions.threadId !== void 0 && {
+        threadId: initialOptions.threadId
+      },
+      ...initialOptions.forwardedProps !== void 0 && {
+        forwardedProps: initialOptions.forwardedProps
+      },
+      ...initialOptions.persistence !== void 0 && {
+        persistence: initialOptions.persistence
+      },
+      ...initialOptions.context !== void 0 && {
+        context: initialOptions.context
+      },
+      devtools: {
+        ...initialOptions.devtools,
+        framework: "react",
+        hookName: "useChat",
+        outputKind: initialOptions.outputSchema ? "structured" : "chat"
+      },
+      onResponse: (response) => {
+        if (activeClientRef.current !== instance) return;
+        void optionsRef.current.onResponse?.(response);
+      },
+      onChunk: (chunk) => {
+        if (activeClientRef.current !== instance) return;
+        optionsRef.current.onChunk?.(chunk);
+      },
+      onFinish: (message) => {
+        if (activeClientRef.current !== instance) return;
+        optionsRef.current.onFinish?.(message);
+      },
+      onError: (error2) => {
+        if (activeClientRef.current !== instance) return;
+        optionsRef.current.onError?.(error2);
+      },
+      ...initialOptions.tools !== void 0 && {
+        tools: initialOptions.tools
+      },
+      onCustomEvent: (eventType, data, context) => {
+        if (activeClientRef.current !== instance) return;
+        optionsRef.current.onCustomEvent?.(eventType, data, context);
+      },
+      ...options.streamProcessor !== void 0 && {
+        streamProcessor: options.streamProcessor
+      },
+      onMessagesChange: (newMessages) => {
+        if (activeClientRef.current !== instance) return;
+        setMessages(newMessages);
+      },
+      onLoadingChange: (newIsLoading) => {
+        if (activeClientRef.current !== instance) return;
+        setIsLoading(newIsLoading);
+      },
+      onErrorChange: (newError) => {
+        if (activeClientRef.current !== instance) return;
+        setError(newError);
+      },
+      onStatusChange: (status2) => {
+        if (activeClientRef.current !== instance) return;
+        setStatus(status2);
+      },
+      onSubscriptionChange: (nextIsSubscribed) => {
+        if (activeClientRef.current !== instance) return;
+        setIsSubscribed(nextIsSubscribed);
+      },
+      onConnectionStatusChange: (nextStatus) => {
+        if (activeClientRef.current !== instance) return;
+        setConnectionStatus(nextStatus);
+      },
+      onSessionGeneratingChange: (isGenerating) => {
+        if (activeClientRef.current !== instance) return;
+        setSessionGenerating(isGenerating);
+      }
+    });
+    activeClientRef.current = instance;
+    return instance;
+  }, [clientId]);
+  useEffect(() => {
+    const clientMessages = client.getMessages();
+    if (clientMessages !== messagesRef.current) {
+      setMessages(clientMessages);
+    }
+  }, [client]);
+  useEffect(() => {
+    client.updateOptions({ body: options.body });
+  }, [client, options.body]);
+  useEffect(() => {
+    if (options.forwardedProps !== void 0) {
+      client.updateOptions({ forwardedProps: options.forwardedProps });
+    }
+  }, [client, options.forwardedProps]);
+  useEffect(() => {
+    if (options.tools !== void 0) {
+      client.updateOptions({ tools: options.tools });
+    }
+  }, [client, options.tools]);
+  useEffect(() => {
+    client.updateOptions({ context: options.context });
+  }, [client, options.context]);
+  useEffect(() => {
+    if (options.live) {
+      client.subscribe();
+    } else {
+      client.unsubscribe();
+    }
+  }, [client, options.live]);
+  useEffect(() => {
+    if (cleanupInvalidationRef.current) {
+      clearTimeout(cleanupInvalidationRef.current);
+      cleanupInvalidationRef.current = null;
+    }
+    activeClientRef.current = client;
+    client.mountDevtools();
+    return () => {
+      cleanupInvalidationRef.current = setTimeout(() => {
+        if (activeClientRef.current === client) {
+          activeClientRef.current = null;
+        }
+        cleanupInvalidationRef.current = null;
+      }, 0);
+      if (optionsRef.current.live) {
+        client.unsubscribe();
+      } else {
+        client.stop();
+      }
+      client.dispose();
+    };
+  }, [client]);
+  const sendMessage = useCallback(
+    async (content) => {
+      await client.sendMessage(content);
+    },
+    [client]
+  );
+  const append = useCallback(
+    async (message) => {
+      await client.append(message);
+    },
+    [client]
+  );
+  const reload = useCallback(async () => {
+    await client.reload();
+  }, [client]);
+  const stop = useCallback(() => {
+    client.stop();
+  }, [client]);
+  const clear = useCallback(() => {
+    client.clear();
+  }, [client]);
+  const setMessagesManually = useCallback(
+    (newMessages) => {
+      client.setMessagesManually(newMessages);
+    },
+    [client]
+  );
+  const addToolResult = useCallback(
+    async (result) => {
+      await client.addToolResult(result);
+    },
+    [client]
+  );
+  const addToolApprovalResponse = useCallback(
+    async (response) => {
+      await client.addToolApprovalResponse(response);
+    },
+    [client]
+  );
+  const renderedMessages = client.getMessages();
+  const activeStructuredPart = useMemo(() => {
+    let lastUserIndex = -1;
+    for (let i = renderedMessages.length - 1; i >= 0; i--) {
+      if (renderedMessages[i]?.role === "user") {
+        lastUserIndex = i;
+        break;
+      }
+    }
+    if (lastUserIndex === -1) return null;
+    for (let i = renderedMessages.length - 1; i > lastUserIndex; i--) {
+      const m = renderedMessages[i];
+      if (m?.role !== "assistant") continue;
+      const part = m.parts.find(
+        (p) => p.type === "structured-output"
+      );
+      if (part) return part;
+    }
+    return null;
+  }, [renderedMessages]);
+  const partial = useMemo(() => {
+    if (!activeStructuredPart) return {};
+    const v = activeStructuredPart.partial ?? activeStructuredPart.data;
+    return v ?? {};
+  }, [activeStructuredPart]);
+  const final = useMemo(() => {
+    if (!activeStructuredPart || activeStructuredPart.status !== "complete") {
+      return null;
+    }
+    return activeStructuredPart.data;
+  }, [activeStructuredPart]);
+  return {
+    messages: renderedMessages,
+    sendMessage,
+    append,
+    reload,
+    stop,
+    isLoading,
+    error,
+    status,
+    isSubscribed,
+    connectionStatus,
+    sessionGenerating,
+    setMessages: setMessagesManually,
+    clear,
+    addToolResult,
+    addToolApprovalResponse,
+    partial,
+    final
+  };
+}
+export {
+  useChat
+};
+//# sourceMappingURL=use-chat.js.map

package/dist/esm/use-chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat.js","sources":["../../src/use-chat.ts"],"sourcesContent":["import { ChatClient } from '@tanstack/ai-client'\nimport { createChatDevtoolsBridge } from '@tanstack/ai-client/devtools'\nimport { useCallback, useEffect, useId, useMemo, useRef, useState } from 'react'\nimport type {\n  AnyClientTool,\n  InferSchemaType,\n  ModelMessage,\n  SchemaInput,\n  StreamChunk,\n} from '@tanstack/ai/client'\nimport type {\n  ChatClientState,\n  ConnectionStatus,\n  InferredClientContext,\n  StructuredOutputPart,\n} from '@tanstack/ai-client'\n\nimport type {\n  DeepPartial,\n  MultimodalContent,\n  UIMessage,\n  UseChatOptions,\n  UseChatReturn,\n} from './types'\n\nexport function useChat<\n  TTools extends ReadonlyArray<AnyClientTool> = any,\n  TSchema extends SchemaInput | undefined = undefined,\n  TContext = InferredClientContext<TTools>,\n>(\n  options: UseChatOptions<TTools, TSchema, TContext>,\n): UseChatReturn<TTools, TSchema> {\n  const hookId = useId()\n  const clientId = options.id || hookId\n\n  const [messages, setMessages] = useState<Array<UIMessage<TTools>>>(\n    options.initialMessages || [],\n  )\n  const [isLoading, setIsLoading] = useState(false)\n  const [error, setError] = useState<Error | undefined>(undefined)\n  const [status, setStatus] = useState<ChatClientState>('ready')\n  const [isSubscribed, setIsSubscribed] = useState(false)\n  const [connectionStatus, setConnectionStatus] =\n    useState<ConnectionStatus>('disconnected')\n  const [sessionGenerating, setSessionGenerating] = useState(false)\n\n  type Partial = DeepPartial<InferSchemaType<NonNullable<TSchema>>>\n  type Final = InferSchemaType<NonNullable<TSchema>>\n\n  // Track current messages in a ref to preserve them when client is recreated\n  const messagesRef = useRef<Array<UIMessage<TTools>>>(\n    options.initialMessages || [],\n  )\n  const isFirstMountRef = useRef(true)\n  const activeClientRef = useRef<ChatClient | null>(null)\n  const cleanupInvalidationRef = useRef<ReturnType<typeof setTimeout> | null>(\n    null,\n  )\n\n  // Update ref synchronously during render so it's always current when useMemo runs.\n  messagesRef.current = messages\n\n  // Track current options in a ref to avoid recreating client when options change\n  const optionsRef = useRef<UseChatOptions<TTools, TSchema, TContext>>(options)\n  optionsRef.current = options\n\n  // Create ChatClient instance with callbacks to sync state\n  const client = useMemo(() => {\n    const messagesToUse = options.initialMessages || []\n    isFirstMountRef.current = false\n\n    // Build options with conditional spreads for fields whose source\n    // type is `T | undefined` but the ChatClient target uses a strict\n    // optional (`field?: T`) — `exactOptionalPropertyTypes` rejects\n    // assigning `undefined` to those, so we omit the key when absent.\n    const initialOptions = optionsRef.current\n    const transport = initialOptions.connection\n      ? { connection: initialOptions.connection }\n      : { fetcher: initialOptions.fetcher }\n\n    const instance = new ChatClient<TTools, TContext>({\n      devtoolsBridgeFactory: createChatDevtoolsBridge,\n      ...transport,\n      id: clientId,\n      initialMessages: messagesToUse,\n      ...(initialOptions.body !== undefined && { body: initialOptions.body }),\n      ...(initialOptions.threadId !== undefined && {\n        threadId: initialOptions.threadId,\n      }),\n      ...(initialOptions.forwardedProps !== undefined && {\n        forwardedProps: initialOptions.forwardedProps,\n      }),\n      ...(initialOptions.persistence !== undefined && {\n        persistence: initialOptions.persistence,\n      }),\n      ...(initialOptions.context !== undefined && {\n        context: initialOptions.context,\n      }),\n      devtools: {\n        ...initialOptions.devtools,\n        framework: 'react',\n        hookName: 'useChat',\n        outputKind: initialOptions.outputSchema ? 'structured' : 'chat',\n      },\n      onResponse: (response) => {\n        if (activeClientRef.current !== instance) return\n        void optionsRef.current.onResponse?.(response)\n      },\n      onChunk: (chunk: StreamChunk) => {\n        if (activeClientRef.current !== instance) return\n        optionsRef.current.onChunk?.(chunk)\n      },\n      onFinish: (message: UIMessage<TTools>) => {\n        if (activeClientRef.current !== instance) return\n        optionsRef.current.onFinish?.(message)\n      },\n      onError: (error: Error) => {\n        if (activeClientRef.current !== instance) return\n        optionsRef.current.onError?.(error)\n      },\n      ...(initialOptions.tools !== undefined && {\n        tools: initialOptions.tools,\n      }),\n      onCustomEvent: (eventType, data, context) => {\n        if (activeClientRef.current !== instance) return\n        optionsRef.current.onCustomEvent?.(eventType, data, context)\n      },\n      ...(options.streamProcessor !== undefined && {\n        streamProcessor: options.streamProcessor,\n      }),\n      onMessagesChange: (newMessages: Array<UIMessage<TTools>>) => {\n        if (activeClientRef.current !== instance) return\n        setMessages(newMessages)\n      },\n      onLoadingChange: (newIsLoading: boolean) => {\n        if (activeClientRef.current !== instance) return\n        setIsLoading(newIsLoading)\n      },\n      onErrorChange: (newError: Error | undefined) => {\n        if (activeClientRef.current !== instance) return\n        setError(newError)\n      },\n      onStatusChange: (status: ChatClientState) => {\n        if (activeClientRef.current !== instance) return\n        setStatus(status)\n      },\n      onSubscriptionChange: (nextIsSubscribed: boolean) => {\n        if (activeClientRef.current !== instance) return\n        setIsSubscribed(nextIsSubscribed)\n      },\n      onConnectionStatusChange: (nextStatus: ConnectionStatus) => {\n        if (activeClientRef.current !== instance) return\n        setConnectionStatus(nextStatus)\n      },\n      onSessionGeneratingChange: (isGenerating: boolean) => {\n        if (activeClientRef.current !== instance) return\n        setSessionGenerating(isGenerating)\n      },\n    })\n    activeClientRef.current = instance\n    return instance\n  }, [clientId])\n\n  useEffect(() => {\n    const clientMessages = client.getMessages()\n    if (clientMessages !== messagesRef.current) {\n      setMessages(clientMessages)\n    }\n  }, [client])\n\n  // Sync each wire-payload slot in its own effect so an unrelated option\n  // changing doesn't re-run the others. `updateOptions` declares strict-optional\n  // fields and rejects explicit `undefined` under EOPT, so guard the optional\n  // slots before passing them.\n  useEffect(() => {\n    client.updateOptions({ body: options.body })\n  }, [client, options.body])\n\n  useEffect(() => {\n    if (options.forwardedProps !== undefined) {\n      client.updateOptions({ forwardedProps: options.forwardedProps })\n    }\n  }, [client, options.forwardedProps])\n\n  useEffect(() => {\n    if (options.tools !== undefined) {\n      client.updateOptions({ tools: options.tools })\n    }\n  }, [client, options.tools])\n\n  useEffect(() => {\n    client.updateOptions({ context: options.context })\n  }, [client, options.context])\n\n  useEffect(() => {\n    if (options.live) {\n      client.subscribe()\n    } else {\n      client.unsubscribe()\n    }\n  }, [client, options.live])\n\n  useEffect(() => {\n    if (cleanupInvalidationRef.current) {\n      clearTimeout(cleanupInvalidationRef.current)\n      cleanupInvalidationRef.current = null\n    }\n    activeClientRef.current = client\n    client.mountDevtools()\n\n    return () => {\n      cleanupInvalidationRef.current = setTimeout(() => {\n        if (activeClientRef.current === client) {\n          activeClientRef.current = null\n        }\n        cleanupInvalidationRef.current = null\n      }, 0)\n      // Subscribe/unsubscribe on `options.live` is owned by the dedicated\n      // effect above. This cleanup only fires on unmount or client swap,\n      // so read `live` through the ref to avoid disposing the client every\n      // time `live` toggles.\n      if (optionsRef.current.live) {\n        client.unsubscribe()\n      } else {\n        client.stop()\n      }\n      client.dispose()\n    }\n  }, [client])\n\n  const sendMessage = useCallback(\n    async (content: string | MultimodalContent) => {\n      await client.sendMessage(content)\n    },\n    [client],\n  )\n\n  const append = useCallback(\n    async (message: ModelMessage | UIMessage) => {\n      await client.append(message)\n    },\n    [client],\n  )\n\n  const reload = useCallback(async () => {\n    await client.reload()\n  }, [client])\n\n  const stop = useCallback(() => {\n    client.stop()\n  }, [client])\n\n  const clear = useCallback(() => {\n    client.clear()\n  }, [client])\n\n  const setMessagesManually = useCallback(\n    (newMessages: Array<UIMessage<TTools>>) => {\n      client.setMessagesManually(newMessages)\n    },\n    [client],\n  )\n\n  const addToolResult = useCallback(\n    async (result: {\n      toolCallId: string\n      tool: string\n      output: any\n      state?: 'output-available' | 'output-error'\n      errorText?: string\n    }) => {\n      await client.addToolResult(result)\n    },\n    [client],\n  )\n\n  const addToolApprovalResponse = useCallback(\n    async (response: { id: string; approved: boolean }) => {\n      await client.addToolApprovalResponse(response)\n    },\n    [client],\n  )\n\n  // The \"active\" structured-output part is the one on the assistant message\n  // that follows the latest user message. No such message exists between\n  // sendMessage() and the first chunk, so partial/final naturally read as\n  // cleared. Historical parts on earlier assistant messages remain available\n  // via `messages` directly.\n  //\n  // When there is NO user message yet (e.g. `initialMessages` contains only\n  // a stale assistant turn or a system prompt) we deliberately return null\n  // rather than scanning historical assistants — otherwise a `final` from a\n  // previous session would leak into the hook value on first render.\n  const renderedMessages = client.getMessages()\n\n  const activeStructuredPart = useMemo<StructuredOutputPart | null>(() => {\n    let lastUserIndex = -1\n    for (let i = renderedMessages.length - 1; i >= 0; i--) {\n      if (renderedMessages[i]?.role === 'user') {\n        lastUserIndex = i\n        break\n      }\n    }\n    if (lastUserIndex === -1) return null\n    for (let i = renderedMessages.length - 1; i > lastUserIndex; i--) {\n      const m = renderedMessages[i]\n      if (m?.role !== 'assistant') continue\n      const part = m.parts.find(\n        (p): p is StructuredOutputPart => p.type === 'structured-output',\n      )\n      if (part) return part\n    }\n    return null\n  }, [renderedMessages])\n\n  const partial = useMemo<Partial>(() => {\n    if (!activeStructuredPart) return {} as Partial\n    const v = activeStructuredPart.partial ?? activeStructuredPart.data\n    return (v ?? {}) as Partial\n  }, [activeStructuredPart])\n\n  const final = useMemo<Final | null>(() => {\n    if (!activeStructuredPart || activeStructuredPart.status !== 'complete') {\n      return null\n    }\n    return activeStructuredPart.data as Final\n  }, [activeStructuredPart])\n\n  // The runtime shape unconditionally exposes partial/final; the public\n  // return type hides them when no outputSchema was supplied. TS can't\n  // structurally narrow across that conditional, so the `as` is the seam.\n  // eslint-disable-next-line no-restricted-syntax -- hook return shape diverges from generic UseChatReturn<TTools, TSchema> due to conditional type on TSchema; TS can't structurally narrow\n  return {\n    messages: renderedMessages,\n    sendMessage,\n    append,\n    reload,\n    stop,\n    isLoading,\n    error,\n    status,\n    isSubscribed,\n    connectionStatus,\n    sessionGenerating,\n    setMessages: setMessagesManually,\n    clear,\n    addToolResult,\n    addToolApprovalResponse,\n    partial,\n    final,\n  } as unknown as UseChatReturn<TTools, TSchema>\n}\n"],"names":["error","status"],"mappings":"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"}