@tanstack/ai-preact 0.11.1 → 0.12.1

package/dist/esm/use-chat.js

@@ -1,247 +1,303 @@
 import { ChatClient } from "@tanstack/ai-client";
 import { createChatDevtoolsBridge } from "@tanstack/ai-client/devtools";
-import { useId, useState, useRef, useEffect, useMemo, useCallback } from "preact/hooks";
+import { useCallback, useEffect, useId, useMemo, useRef, useState } from "preact/hooks";
+//#region src/use-chat.ts
+var EMPTY_INTERRUPTS = Object.freeze([]);
+var EMPTY_INTERRUPT_ERRORS = Object.freeze([]);
 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 [queue, setQueue] = useState([]);
-  const messagesRef = useRef(
-    options.initialMessages || []
-  );
-  const isFirstMountRef = useRef(true);
-  const activeClientRef = useRef(null);
-  const cleanupInvalidationRef = useRef(
-    null
-  );
-  const optionsRef = useRef(options);
-  optionsRef.current = options;
-  useEffect(() => {
-    messagesRef.current = messages;
-  }, [messages]);
-  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: "preact",
-        hookName: "useChat",
-        outputKind: initialOptions.outputSchema ? "structured" : "chat"
-      },
-      // Wrap every callback so the latest options are read at call time.
-      // Capturing the function reference directly would freeze it to whatever
-      // the parent passed on the first render.
-      onResponse: (response) => {
-        if (activeClientRef.current !== instance) return;
-        return 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: (err) => {
-        if (activeClientRef.current !== instance) return;
-        optionsRef.current.onError?.(err);
-      },
-      onCustomEvent: (eventType, data, context) => {
-        if (activeClientRef.current !== instance) return;
-        optionsRef.current.onCustomEvent?.(eventType, data, context);
-      },
-      ...initialOptions.tools !== void 0 && {
-        tools: initialOptions.tools
-      },
-      ...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);
-      },
-      onStatusChange: (newStatus) => {
-        if (activeClientRef.current !== instance) return;
-        setStatus(newStatus);
-      },
-      onErrorChange: (newError) => {
-        if (activeClientRef.current !== instance) return;
-        setError(newError);
-      },
-      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);
-      },
-      ...optionsRef.current.queue !== void 0 && {
-        queue: optionsRef.current.queue
-      },
-      onQueueChange: (nextQueue) => {
-        if (activeClientRef.current !== instance) return;
-        setQueue(nextQueue);
-      }
-    });
-    activeClientRef.current = instance;
-    return instance;
-  }, [clientId]);
-  useEffect(() => {
-    const clientMessages = client.getMessages();
-    if (clientMessages !== messagesRef.current) {
-      setMessages(clientMessages);
-    }
-  }, [client]);
-  useEffect(() => {
-    client.updateOptions({
-      body: options.body,
-      ...options.forwardedProps !== void 0 && {
-        forwardedProps: options.forwardedProps
-      },
-      context: options.context,
-      ...options.queue !== void 0 && { queue: options.queue }
-    });
-  }, [
-    client,
-    options.body,
-    options.forwardedProps,
-    options.context,
-    options.queue
-  ]);
-  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, sendOptions) => {
-      await client.sendMessage(content, void 0, sendOptions);
-    },
-    [client]
-  );
-  const cancelQueued = useCallback(
-    (id) => {
-      client.cancelQueued(id);
-    },
-    [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();
-  return {
-    messages: renderedMessages,
-    sendMessage,
-    append,
-    reload,
-    stop,
-    isLoading,
-    error,
-    status,
-    isSubscribed,
-    connectionStatus,
-    sessionGenerating,
-    setMessages: setMessagesManually,
-    clear,
-    addToolResult,
-    addToolApprovalResponse,
-    queue,
-    cancelQueued
-  };
+	const hookId = useId();
+	const clientId = options.threadId ?? 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 [queue, setQueue] = useState([]);
+	const [runId, setRunId] = useState(null);
+	const [interruptState, setInterruptState] = useState(() => ({
+		interrupts: EMPTY_INTERRUPTS,
+		pendingInterrupts: EMPTY_INTERRUPTS,
+		interruptErrors: EMPTY_INTERRUPT_ERRORS,
+		resuming: false
+	}));
+	const messagesRef = useRef(options.initialMessages || []);
+	const isFirstMountRef = useRef(true);
+	const activeClientRef = useRef(null);
+	const cleanupInvalidationRef = useRef(null);
+	const cleanupDisposalRef = useRef(null);
+	const optionsRef = useRef(options);
+	optionsRef.current = options;
+	const syncResumeState = useCallback((target) => {
+		if (!target) return;
+		setRunId(target.getCurrentRunId());
+		setInterruptState(target.getInterruptState());
+	}, []);
+	useEffect(() => {
+		messagesRef.current = messages;
+	}, [messages]);
+	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 instanceHolder = { current: void 0 };
+		const getActiveInstance = () => {
+			const currentInstance = instanceHolder.current;
+			if (!currentInstance || activeClientRef.current !== currentInstance) return;
+			return currentInstance;
+		};
+		const pendingInitializationErrors = [];
+		const instance = new ChatClient({
+			devtoolsBridgeFactory: createChatDevtoolsBridge,
+			...transport,
+			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.initialResumeSnapshot !== void 0 && { initialResumeSnapshot: initialOptions.initialResumeSnapshot },
+			...initialOptions.context !== void 0 && { context: initialOptions.context },
+			devtools: {
+				...initialOptions.devtools,
+				framework: "preact",
+				hookName: "useChat",
+				outputKind: initialOptions.outputSchema ? "structured" : "chat"
+			},
+			onResponse: (response) => {
+				if (!getActiveInstance()) return;
+				return optionsRef.current.onResponse?.(response);
+			},
+			onChunk: (chunk) => {
+				if (!getActiveInstance()) return;
+				optionsRef.current.onChunk?.(chunk);
+			},
+			onFinish: (message) => {
+				if (!getActiveInstance()) return;
+				optionsRef.current.onFinish?.(message);
+			},
+			onError: (err) => {
+				const currentInstance = instanceHolder.current;
+				if (!currentInstance) {
+					pendingInitializationErrors.push(err);
+					return;
+				}
+				if (activeClientRef.current !== currentInstance) return;
+				optionsRef.current.onError?.(err);
+			},
+			onCustomEvent: (eventType, data, context) => {
+				if (!getActiveInstance()) return;
+				optionsRef.current.onCustomEvent?.(eventType, data, context);
+			},
+			...initialOptions.tools !== void 0 && { tools: initialOptions.tools },
+			...options.streamProcessor !== void 0 && { streamProcessor: options.streamProcessor },
+			onMessagesChange: (newMessages) => {
+				if (!getActiveInstance()) return;
+				setMessages(newMessages);
+			},
+			onLoadingChange: (newIsLoading) => {
+				const currentInstance = getActiveInstance();
+				if (!currentInstance) return;
+				setIsLoading(newIsLoading);
+				syncResumeState(currentInstance);
+			},
+			onStatusChange: (newStatus) => {
+				if (!getActiveInstance()) return;
+				setStatus(newStatus);
+			},
+			onErrorChange: (newError) => {
+				if (!getActiveInstance()) return;
+				setError(newError);
+			},
+			onSubscriptionChange: (nextIsSubscribed) => {
+				if (!getActiveInstance()) return;
+				setIsSubscribed(nextIsSubscribed);
+			},
+			onConnectionStatusChange: (nextStatus) => {
+				if (!getActiveInstance()) return;
+				setConnectionStatus(nextStatus);
+			},
+			onSessionGeneratingChange: (isGenerating) => {
+				if (!getActiveInstance()) return;
+				setSessionGenerating(isGenerating);
+			},
+			...optionsRef.current.queue !== void 0 && { queue: optionsRef.current.queue },
+			onQueueChange: (nextQueue) => {
+				if (!getActiveInstance()) return;
+				setQueue(nextQueue);
+			},
+			onRunIdChange: (nextRunId) => {
+				if (!getActiveInstance()) return;
+				setRunId(nextRunId);
+			},
+			onResumeStateChange: (_nextResumeState, nextPendingInterrupts) => {
+				if (!getActiveInstance()) return;
+				setInterruptState((current) => ({
+					...current,
+					interrupts: nextPendingInterrupts,
+					pendingInterrupts: nextPendingInterrupts
+				}));
+			},
+			onInterruptStateChange: (nextInterruptState) => {
+				if (!getActiveInstance()) return;
+				setInterruptState(nextInterruptState);
+				optionsRef.current.onInterruptStateChange?.(nextInterruptState);
+			}
+		});
+		instanceHolder.current = instance;
+		activeClientRef.current = instance;
+		for (const initializationError of pendingInitializationErrors) {
+			if (activeClientRef.current !== instance) break;
+			optionsRef.current.onError?.(initializationError);
+		}
+		return instance;
+	}, [clientId, syncResumeState]);
+	useEffect(() => {
+		const clientMessages = client.getMessages();
+		if (clientMessages !== messagesRef.current) setMessages(clientMessages);
+	}, [client]);
+	useEffect(() => {
+		client.updateOptions({
+			body: options.body,
+			...options.forwardedProps !== void 0 && { forwardedProps: options.forwardedProps },
+			context: options.context,
+			...options.queue !== void 0 && { queue: options.queue }
+		});
+	}, [
+		client,
+		options.body,
+		options.forwardedProps,
+		options.context,
+		options.queue
+	]);
+	useEffect(() => {
+		if (options.live) client.subscribe();
+		else client.unsubscribe();
+	}, [client, options.live]);
+	useEffect(() => {
+		client.attach();
+		return () => {
+			client.detach();
+		};
+	}, [client]);
+	useEffect(() => {
+		if (cleanupDisposalRef.current?.client === client) {
+			clearTimeout(cleanupDisposalRef.current.timeout);
+			cleanupDisposalRef.current = null;
+		}
+		if (cleanupInvalidationRef.current) {
+			clearTimeout(cleanupInvalidationRef.current);
+			cleanupInvalidationRef.current = null;
+		}
+		activeClientRef.current = client;
+		client.mountDevtools();
+		syncResumeState(client);
+		return () => {
+			cleanupInvalidationRef.current = setTimeout(() => {
+				if (activeClientRef.current === client) activeClientRef.current = null;
+				cleanupInvalidationRef.current = null;
+			}, 0);
+			if (optionsRef.current.live) client.unsubscribe();
+			else client.stop();
+			const disposal = {
+				client,
+				timeout: setTimeout(() => {
+					client.dispose();
+					if (cleanupDisposalRef.current === disposal) cleanupDisposalRef.current = null;
+				}, 0)
+			};
+			cleanupDisposalRef.current = disposal;
+		};
+	}, [client, syncResumeState]);
+	const sendMessage = useCallback(async (content, sendOptions) => {
+		try {
+			await client.sendMessage(content, void 0, sendOptions);
+		} finally {
+			syncResumeState(client);
+		}
+	}, [client, syncResumeState]);
+	const cancelQueued = useCallback((id) => {
+		client.cancelQueued(id);
+	}, [client, syncResumeState]);
+	const append = useCallback(async (message) => {
+		try {
+			await client.append(message);
+		} finally {
+			syncResumeState(client);
+		}
+	}, [client, syncResumeState]);
+	const reload = useCallback(async () => {
+		try {
+			await client.reload();
+		} finally {
+			syncResumeState(client);
+		}
+	}, [client, syncResumeState]);
+	const stop = useCallback(() => {
+		client.stop();
+	}, [client]);
+	const clear = useCallback(() => {
+		client.clear();
+		syncResumeState(client);
+	}, [client, syncResumeState]);
+	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);
+		syncResumeState(client);
+	}, [client, syncResumeState]);
+	const resumeInterrupts = useCallback(async (resumeItems, state) => {
+		const result = await client.resumeInterrupts(resumeItems, state);
+		syncResumeState(client);
+		return result;
+	}, [client, syncResumeState]);
+	const resolveInterrupts = useCallback((resolution) => {
+		if (typeof resolution === "boolean") client.resolveInterrupts(resolution);
+		else client.resolveInterrupts(resolution);
+	}, [client]);
+	const cancelInterrupts = useCallback(() => {
+		client.cancelInterrupts();
+	}, [client]);
+	const retryInterrupts = useCallback(() => {
+		client.retryInterrupts();
+	}, [client]);
+	const resumeInterruptsUnsafe = useCallback((resumeItems, state) => client.resumeInterruptsUnsafe(resumeItems, state), [client]);
+	return {
+		messages: client.getMessages(),
+		sendMessage,
+		append,
+		reload,
+		stop,
+		isLoading,
+		error,
+		status,
+		isSubscribed,
+		connectionStatus,
+		sessionGenerating,
+		setMessages: setMessagesManually,
+		clear,
+		addToolResult,
+		addToolApprovalResponse,
+		queue,
+		cancelQueued,
+		runId,
+		interrupts: interruptState.interrupts,
+		pendingInterrupts: interruptState.pendingInterrupts,
+		interruptErrors: interruptState.interruptErrors,
+		resuming: interruptState.resuming,
+		resolveInterrupts,
+		cancelInterrupts,
+		retryInterrupts,
+		resumeInterruptsUnsafe,
+		resumeInterrupts
+	};
 }
-export {
-  useChat
-};
-//# sourceMappingURL=use-chat.js.map
+//#endregion
+export { useChat };
+
+//# sourceMappingURL=use-chat.js.map

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

@@ -1 +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 {\n  useCallback,\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n} from 'preact/hooks'\nimport type {\n  ChatClientState,\n  ConnectionStatus,\n  InferredClientContext,\n  QueuedMessage,\n  SendMessageOptions,\n} from '@tanstack/ai-client'\nimport type { AnyClientTool, ModelMessage } from '@tanstack/ai'\n\nimport type {\n  MultimodalContent,\n  UIMessage,\n  UseChatOptions,\n  UseChatReturn,\n} from './types'\n\nexport function useChat<\n  const TTools extends ReadonlyArray<AnyClientTool> = any,\n  TContext = InferredClientContext<TTools>,\n>(options: UseChatOptions<TTools, TContext>): UseChatReturn<TTools> {\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  const [queue, setQueue] = useState<Array<QueuedMessage>>([])\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  const optionsRef = useRef<UseChatOptions<TTools, TContext>>(options)\n\n  optionsRef.current = options\n\n  useEffect(() => {\n    messagesRef.current = messages\n  }, [messages])\n\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: 'preact',\n        hookName: 'useChat',\n        outputKind: initialOptions.outputSchema ? 'structured' : 'chat',\n      },\n      // Wrap every callback so the latest options are read at call time.\n      // Capturing the function reference directly would freeze it to whatever\n      // the parent passed on the first render.\n      onResponse: (response) => {\n        if (activeClientRef.current !== instance) return\n        return optionsRef.current.onResponse?.(response)\n      },\n      onChunk: (chunk) => {\n        if (activeClientRef.current !== instance) return\n        optionsRef.current.onChunk?.(chunk)\n      },\n      onFinish: (message) => {\n        if (activeClientRef.current !== instance) return\n        optionsRef.current.onFinish?.(message)\n      },\n      onError: (err) => {\n        if (activeClientRef.current !== instance) return\n        optionsRef.current.onError?.(err)\n      },\n      onCustomEvent: (eventType, data, context) => {\n        if (activeClientRef.current !== instance) return\n        optionsRef.current.onCustomEvent?.(eventType, data, context)\n      },\n      ...(initialOptions.tools !== undefined && {\n        tools: initialOptions.tools,\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      onStatusChange: (newStatus: ChatClientState) => {\n        if (activeClientRef.current !== instance) return\n        setStatus(newStatus)\n      },\n      onErrorChange: (newError: Error | undefined) => {\n        if (activeClientRef.current !== instance) return\n        setError(newError)\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      ...(optionsRef.current.queue !== undefined && {\n        queue: optionsRef.current.queue,\n      }),\n      onQueueChange: (nextQueue: Array<QueuedMessage>) => {\n        if (activeClientRef.current !== instance) return\n        setQueue(nextQueue)\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 body / forwardedProps changes to the client.\n  // Both populate the same wire payload; `forwardedProps` is preferred\n  // and `body` is deprecated but still supported.\n  useEffect(() => {\n    // Conditional spread: `updateOptions` declares strict-optional\n    // fields and rejects explicit `undefined` under EOPT.\n    client.updateOptions({\n      body: options.body,\n      ...(options.forwardedProps !== undefined && {\n        forwardedProps: options.forwardedProps,\n      }),\n      context: options.context,\n      ...(options.queue !== undefined && { queue: options.queue }),\n    })\n  }, [\n    client,\n    options.body,\n    options.forwardedProps,\n    options.context,\n    options.queue,\n  ])\n\n  useEffect(() => {\n    if (options.live) {\n      client.subscribe()\n    } else {\n      client.unsubscribe()\n    }\n  }, [client, options.live])\n\n  // Cleanup on unmount: stop any in-flight requests\n  // Note: We only cleanup when client changes or component unmounts.\n  // DO NOT include isLoading in dependencies - that would cause the cleanup\n  // to run when isLoading changes, aborting continuation requests.\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  // All callback options are read through optionsRef at call time, so fresh\n  // closures from each render are picked up without recreating the client.\n  const sendMessage = useCallback(\n    async (\n      content: string | MultimodalContent,\n      sendOptions?: SendMessageOptions,\n    ) => {\n      await client.sendMessage(content, undefined, sendOptions)\n    },\n    [client],\n  )\n\n  const cancelQueued = useCallback(\n    (id: string) => {\n      client.cancelQueued(id)\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: unknown\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  const renderedMessages = client.getMessages()\n\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    queue,\n    cancelQueued,\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-chat.js","names":[],"sources":["../../src/use-chat.ts"],"sourcesContent":["import { ChatClient } from '@tanstack/ai-client'\nimport { createChatDevtoolsBridge } from '@tanstack/ai-client/devtools'\nimport {\n  useCallback,\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n} from 'preact/hooks'\nimport type {\n  ChatClientState,\n  ChatInterrupt,\n  ChatInterruptState,\n  ChatResumeState,\n  ConnectionStatus,\n  InferredClientContext,\n  QueuedMessage,\n  SendMessageOptions,\n} from '@tanstack/ai-client'\nimport type {\n  AnyClientTool,\n  ModelMessage,\n  RunAgentResumeItem,\n} from '@tanstack/ai'\n\nimport type {\n  MultimodalContent,\n  UIMessage,\n  UseChatOptions,\n  UseChatReturn,\n} from './types'\n\nconst EMPTY_INTERRUPTS = Object.freeze([])\nconst EMPTY_INTERRUPT_ERRORS = Object.freeze([])\n\nexport function useChat<\n  const TTools extends ReadonlyArray<AnyClientTool> = any,\n  TContext = InferredClientContext<TTools>,\n>(options: UseChatOptions<TTools, TContext>): UseChatReturn<TTools> {\n  // The hook's identity is its `threadId` — also the persistence key, so a\n  // reload with the same `threadId` restores the same conversation. `hookId` is\n  // only a stable fallback for client-recreation keying when no `threadId` is\n  // given (an ephemeral chat), never a persistence key.\n  const hookId = useId()\n  const clientId = options.threadId ?? 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  const [queue, setQueue] = useState<Array<QueuedMessage>>([])\n  const [runId, setRunId] = useState<string | null>(null)\n  const [interruptState, setInterruptState] = useState<\n    ChatInterruptState<TTools>\n  >(() => ({\n    interrupts: EMPTY_INTERRUPTS,\n    pendingInterrupts: EMPTY_INTERRUPTS,\n    interruptErrors: EMPTY_INTERRUPT_ERRORS,\n    resuming: false,\n  }))\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  const cleanupDisposalRef = useRef<{\n    client: ChatClient\n    timeout: ReturnType<typeof setTimeout>\n  } | null>(null)\n  const optionsRef = useRef<UseChatOptions<TTools, TContext>>(options)\n\n  optionsRef.current = options\n\n  const syncResumeState = useCallback((target: ChatClient | null) => {\n    if (!target) return\n    setRunId(target.getCurrentRunId())\n    setInterruptState(target.getInterruptState())\n  }, [])\n\n  useEffect(() => {\n    messagesRef.current = messages\n  }, [messages])\n\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 instanceHolder: {\n      current: ChatClient<TTools, TContext> | undefined\n    } = { current: undefined }\n    const getActiveInstance = () => {\n      const currentInstance = instanceHolder.current\n      if (!currentInstance || activeClientRef.current !== currentInstance) {\n        return undefined\n      }\n      return currentInstance\n    }\n    const pendingInitializationErrors: Array<Error> = []\n    const instance = new ChatClient<TTools, TContext>({\n      devtoolsBridgeFactory: createChatDevtoolsBridge,\n      ...transport,\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.initialResumeSnapshot !== undefined && {\n        initialResumeSnapshot: initialOptions.initialResumeSnapshot,\n      }),\n      ...(initialOptions.context !== undefined && {\n        context: initialOptions.context,\n      }),\n      devtools: {\n        ...initialOptions.devtools,\n        framework: 'preact',\n        hookName: 'useChat',\n        outputKind: initialOptions.outputSchema ? 'structured' : 'chat',\n      },\n      // Wrap every callback so the latest options are read at call time.\n      // Capturing the function reference directly would freeze it to whatever\n      // the parent passed on the first render.\n      onResponse: (response) => {\n        if (!getActiveInstance()) return\n        return optionsRef.current.onResponse?.(response)\n      },\n      onChunk: (chunk) => {\n        if (!getActiveInstance()) return\n        optionsRef.current.onChunk?.(chunk)\n      },\n      onFinish: (message) => {\n        if (!getActiveInstance()) return\n        optionsRef.current.onFinish?.(message)\n      },\n      onError: (err) => {\n        const currentInstance = instanceHolder.current\n        if (!currentInstance) {\n          pendingInitializationErrors.push(err)\n          return\n        }\n        if (activeClientRef.current !== currentInstance) return\n        optionsRef.current.onError?.(err)\n      },\n      onCustomEvent: (eventType, data, context) => {\n        if (!getActiveInstance()) return\n        optionsRef.current.onCustomEvent?.(eventType, data, context)\n      },\n      ...(initialOptions.tools !== undefined && {\n        tools: initialOptions.tools,\n      }),\n      ...(options.streamProcessor !== undefined && {\n        streamProcessor: options.streamProcessor,\n      }),\n      onMessagesChange: (newMessages: Array<UIMessage<TTools>>) => {\n        if (!getActiveInstance()) return\n        setMessages(newMessages)\n      },\n      onLoadingChange: (newIsLoading: boolean) => {\n        const currentInstance = getActiveInstance()\n        if (!currentInstance) return\n        setIsLoading(newIsLoading)\n        syncResumeState(currentInstance)\n      },\n      onStatusChange: (newStatus: ChatClientState) => {\n        if (!getActiveInstance()) return\n        setStatus(newStatus)\n      },\n      onErrorChange: (newError: Error | undefined) => {\n        if (!getActiveInstance()) return\n        setError(newError)\n      },\n      onSubscriptionChange: (nextIsSubscribed: boolean) => {\n        if (!getActiveInstance()) return\n        setIsSubscribed(nextIsSubscribed)\n      },\n      onConnectionStatusChange: (nextStatus: ConnectionStatus) => {\n        if (!getActiveInstance()) return\n        setConnectionStatus(nextStatus)\n      },\n      onSessionGeneratingChange: (isGenerating: boolean) => {\n        if (!getActiveInstance()) return\n        setSessionGenerating(isGenerating)\n      },\n      ...(optionsRef.current.queue !== undefined && {\n        queue: optionsRef.current.queue,\n      }),\n      onQueueChange: (nextQueue: Array<QueuedMessage>) => {\n        if (!getActiveInstance()) return\n        setQueue(nextQueue)\n      },\n      onRunIdChange: (nextRunId) => {\n        if (!getActiveInstance()) return\n        setRunId(nextRunId)\n      },\n      onResumeStateChange: (_nextResumeState, nextPendingInterrupts) => {\n        if (!getActiveInstance()) return\n        setInterruptState((current) => ({\n          ...current,\n          interrupts: nextPendingInterrupts,\n          pendingInterrupts: nextPendingInterrupts,\n        }))\n      },\n      onInterruptStateChange: (nextInterruptState) => {\n        if (!getActiveInstance()) return\n        setInterruptState(nextInterruptState)\n        optionsRef.current.onInterruptStateChange?.(nextInterruptState)\n      },\n    })\n    instanceHolder.current = instance\n    activeClientRef.current = instance\n    for (const initializationError of pendingInitializationErrors) {\n      if (activeClientRef.current !== instance) break\n      optionsRef.current.onError?.(initializationError)\n    }\n    return instance\n  }, [clientId, syncResumeState])\n\n  useEffect(() => {\n    const clientMessages = client.getMessages()\n    if (clientMessages !== messagesRef.current) {\n      setMessages(clientMessages)\n    }\n  }, [client])\n\n  // Sync body / forwardedProps changes to the client.\n  // Both populate the same wire payload; `forwardedProps` is preferred\n  // and `body` is deprecated but still supported.\n  useEffect(() => {\n    // Conditional spread: `updateOptions` declares strict-optional\n    // fields and rejects explicit `undefined` under EOPT.\n    client.updateOptions({\n      body: options.body,\n      ...(options.forwardedProps !== undefined && {\n        forwardedProps: options.forwardedProps,\n      }),\n      context: options.context,\n      ...(options.queue !== undefined && { queue: options.queue }),\n    })\n  }, [\n    client,\n    options.body,\n    options.forwardedProps,\n    options.context,\n    options.queue,\n  ])\n\n  useEffect(() => {\n    if (options.live) {\n      client.subscribe()\n    } else {\n      client.unsubscribe()\n    }\n  }, [client, options.live])\n\n  // ONLY THE VIEW ON SCREEN HOLDS A STREAM. See the same effect in\n  // `@tanstack/ai-react`. A page can own many chats and a browser allows only ~6\n  // connections per origin, so one long-lived stream per chat starves everything\n  // else once a handful of views have been open. `attach` is idempotent and\n  // `detach` keeps the transcript and the resume pointer, so a remount picks the\n  // run straight back up from the durable log.\n  //\n  // Immediate, unlike the deferred disposal below, which a remount can skip —\n  // correct for disposal, useless for a connection.\n  useEffect(() => {\n    client.attach()\n    return () => {\n      client.detach()\n    }\n  }, [client])\n\n  // Cleanup on unmount: stop any in-flight requests\n  // Note: We only cleanup when client changes or component unmounts.\n  // DO NOT include isLoading in dependencies - that would cause the cleanup\n  // to run when isLoading changes, aborting continuation requests.\n  useEffect(() => {\n    if (cleanupDisposalRef.current?.client === client) {\n      clearTimeout(cleanupDisposalRef.current.timeout)\n      cleanupDisposalRef.current = null\n    }\n    if (cleanupInvalidationRef.current) {\n      clearTimeout(cleanupInvalidationRef.current)\n      cleanupInvalidationRef.current = null\n    }\n    activeClientRef.current = client\n    client.mountDevtools()\n    // Delivery-durability resume is transparent: the resumable SSE connection\n    // adapter reattaches via the browser's native Last-Event-ID on reconnect.\n    // We only seed interrupt (state) resume from the client here.\n    syncResumeState(client)\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      const disposal = {\n        client,\n        timeout: setTimeout(() => {\n          client.dispose()\n          if (cleanupDisposalRef.current === disposal) {\n            cleanupDisposalRef.current = null\n          }\n        }, 0),\n      }\n      cleanupDisposalRef.current = disposal\n    }\n  }, [client, syncResumeState])\n\n  // All callback options are read through optionsRef at call time, so fresh\n  // closures from each render are picked up without recreating the client.\n  const sendMessage = useCallback(\n    async (\n      content: string | MultimodalContent,\n      sendOptions?: SendMessageOptions,\n    ) => {\n      try {\n        await client.sendMessage(content, undefined, sendOptions)\n      } finally {\n        syncResumeState(client)\n      }\n    },\n    [client, syncResumeState],\n  )\n\n  const cancelQueued = useCallback(\n    (id: string) => {\n      client.cancelQueued(id)\n    },\n    [client, syncResumeState],\n  )\n\n  const append = useCallback(\n    async (message: ModelMessage | UIMessage) => {\n      try {\n        await client.append(message)\n      } finally {\n        syncResumeState(client)\n      }\n    },\n    [client, syncResumeState],\n  )\n\n  const reload = useCallback(async () => {\n    try {\n      await client.reload()\n    } finally {\n      syncResumeState(client)\n    }\n  }, [client, syncResumeState])\n\n  const stop = useCallback(() => {\n    client.stop()\n  }, [client])\n\n  const clear = useCallback(() => {\n    client.clear()\n    syncResumeState(client)\n  }, [client, syncResumeState])\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: unknown\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      syncResumeState(client)\n    },\n    [client, syncResumeState],\n  )\n\n  const resumeInterrupts = useCallback(\n    async (resumeItems: Array<RunAgentResumeItem>, state?: ChatResumeState) => {\n      const result = await client.resumeInterrupts(resumeItems, state)\n      syncResumeState(client)\n      return result\n    },\n    [client, syncResumeState],\n  )\n\n  const resolveInterrupts = useCallback(\n    (\n      resolution: boolean | ((interrupt: ChatInterrupt<TTools>) => undefined),\n    ) => {\n      if (typeof resolution === 'boolean') {\n        client.resolveInterrupts(resolution)\n      } else {\n        client.resolveInterrupts(resolution)\n      }\n    },\n    [client],\n  )\n\n  const cancelInterrupts = useCallback(() => {\n    client.cancelInterrupts()\n  }, [client])\n\n  const retryInterrupts = useCallback(() => {\n    client.retryInterrupts()\n  }, [client])\n\n  const resumeInterruptsUnsafe = useCallback(\n    (resumeItems: Array<RunAgentResumeItem>, state?: ChatResumeState) =>\n      client.resumeInterruptsUnsafe(resumeItems, state),\n    [client],\n  )\n\n  const renderedMessages = client.getMessages()\n\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    queue,\n    cancelQueued,\n    runId,\n    interrupts: interruptState.interrupts,\n    pendingInterrupts: interruptState.pendingInterrupts,\n    interruptErrors: interruptState.interruptErrors,\n    resuming: interruptState.resuming,\n    resolveInterrupts,\n    cancelInterrupts,\n    retryInterrupts,\n    resumeInterruptsUnsafe,\n    resumeInterrupts,\n  }\n}\n"],"mappings":"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"}