@copilotkit/react-core 1.56.2 → 1.56.4

package/dist/{copilotkit-Cj2ZIxVr.mjs → copilotkit-Bd0m5HFp.mjs}

@@ -18,7 +18,7 @@ import { A2UIProvider, A2UIRenderer, A2UI_SCHEMA_CONTEXT_DESCRIPTION, DEFAULT_SU
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { useVirtualizer } from "@tanstack/react-virtual";
 import { createPortal, flushSync } from "react-dom";
-import { StickToBottom, useStickToBottom, useStickToBottomContext } from "use-stick-to-bottom";
+import { StickToBottom, useStickToBottomContext } from "use-stick-to-bottom";
 import ReactMarkdown from "react-markdown";
 
 //#region src/v2/lib/slots.tsx
@@ -145,7 +145,7 @@ const CopilotChatDefaultLabels = {
 	welcomeMessageText: "How can I help you today?"
 };
 const CopilotChatConfiguration = createContext(null);
-const CopilotChatConfigurationProvider = ({ children, labels, agentId, threadId, isModalDefaultOpen }) => {
+const CopilotChatConfigurationProvider = ({ children, labels, agentId, threadId, hasExplicitThreadId, isModalDefaultOpen }) => {
 	const parentConfig = useContext(CopilotChatConfiguration);
 	const stableLabels = useShallowStableRef(labels);
 	const mergedLabels = useMemo(() => ({
@@ -159,6 +159,7 @@ const CopilotChatConfigurationProvider = ({ children, labels, agentId, threadId,
 		if (parentConfig?.threadId) return parentConfig.threadId;
 		return randomUUID();
 	}, [threadId, parentConfig?.threadId]);
+	const resolvedHasExplicitThreadId = (hasExplicitThreadId !== void 0 ? hasExplicitThreadId : !!threadId) || !!parentConfig?.hasExplicitThreadId;
 	const [internalModalOpen, setInternalModalOpen] = useState(isModalDefaultOpen ?? true);
 	const hasExplicitDefault = isModalDefaultOpen !== void 0;
 	const setAndSync = useCallback((open) => {
@@ -181,12 +182,14 @@ const CopilotChatConfigurationProvider = ({ children, labels, agentId, threadId,
 		labels: mergedLabels,
 		agentId: resolvedAgentId,
 		threadId: resolvedThreadId,
+		hasExplicitThreadId: resolvedHasExplicitThreadId,
 		isModalOpen: resolvedIsModalOpen,
 		setModalOpen: resolvedSetModalOpen
 	}), [
 		mergedLabels,
 		resolvedAgentId,
 		resolvedThreadId,
+		resolvedHasExplicitThreadId,
 		resolvedIsModalOpen,
 		resolvedSetModalOpen
 	]);
@@ -580,7 +583,7 @@ CopilotChatAudioRecorder.displayName = "CopilotChatAudioRecorder";
 //#region src/v2/components/chat/CopilotChatInput.tsx
 const SLASH_MENU_MAX_VISIBLE_ITEMS = 5;
 const SLASH_MENU_ITEM_HEIGHT_PX = 40;
-function CopilotChatInput({ mode = "input", onSubmitMessage, onStop, isRunning = false, onStartTranscribe, onCancelTranscribe, onFinishTranscribe, onFinishTranscribeWithAudio, onAddFile, onChange, value, toolsMenu, autoFocus = false, positioning = "static", keyboardHeight = 0, containerRef, showDisclaimer, textArea, sendButton, startTranscribeButton, cancelTranscribeButton, finishTranscribeButton, addMenuButton, audioRecorder, disclaimer, children, className, ...props }) {
+function CopilotChatInput({ mode = "input", onSubmitMessage, onStop, isRunning = false, onStartTranscribe, onCancelTranscribe, onFinishTranscribe, onFinishTranscribeWithAudio, onAddFile, onChange, value, toolsMenu, autoFocus = false, positioning = "static", keyboardHeight = 0, containerRef, showDisclaimer, bottomAnchored = false, textArea, sendButton, startTranscribeButton, cancelTranscribeButton, finishTranscribeButton, addMenuButton, audioRecorder, disclaimer, children, className, ...props }) {
 	const isControlled = value !== void 0;
 	const [internalValue, setInternalValue] = useState(() => value ?? "");
 	useEffect(() => {
@@ -1104,7 +1107,8 @@ function CopilotChatInput({ mode = "input", onSubmitMessage, onStop, isRunning =
 		className: cn("cpk:pointer-events-none cpk:relative cpk:z-20", positioning === "absolute" && "cpk:absolute cpk:bottom-0 cpk:left-0 cpk:right-0", className),
 		style: {
 			transform: keyboardHeight > 0 ? `translateY(-${keyboardHeight}px)` : void 0,
-			transition: "transform 0.2s ease-out"
+			transition: "transform 0.2s ease-out",
+			...positioning === "absolute" || bottomAnchored ? { paddingBottom: "var(--copilotkit-license-banner-offset, 0px)" } : {}
 		},
 		...props,
 		children: [/* @__PURE__ */ jsx("div", {
@@ -1319,6 +1323,8 @@ CopilotKitInspector.displayName = "CopilotKitInspector";
 
 //#endregion
 //#region src/v2/components/license-warning-banner.tsx
+const LICENSE_BANNER_OFFSET_PX = 52;
+const LICENSE_BANNER_OFFSET_VAR = "--copilotkit-license-banner-offset";
 const BANNER_STYLES = {
 	base: {
 		position: "fixed",
@@ -1360,6 +1366,14 @@ function getSeverityStyle(severity) {
 	}
 }
 function BannerShell({ severity, message, actionLabel, actionUrl, onDismiss }) {
+	useEffect(() => {
+		if (typeof document === "undefined") return;
+		const root = document.documentElement;
+		root.style.setProperty(LICENSE_BANNER_OFFSET_VAR, `${LICENSE_BANNER_OFFSET_PX}px`);
+		return () => {
+			root.style.removeProperty(LICENSE_BANNER_OFFSET_VAR);
+		};
+	}, []);
 	return /* @__PURE__ */ jsxs("div", {
 		style: {
 			...BANNER_STYLES.base,
@@ -3312,7 +3326,6 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = {}, c
 		didMountRef.current = true;
 	}, []);
 	useEffect(() => {
-		if (defaultThrottleMs !== void 0 && (!Number.isFinite(defaultThrottleMs) || defaultThrottleMs < 0)) console.error(`CopilotKitProvider: defaultThrottleMs must be a non-negative finite number, got ${defaultThrottleMs}. useAgent hooks without an explicit throttleMs will fall back to unthrottled.`);
 		copilotkit.setDefaultThrottleMs(defaultThrottleMs);
 	}, [copilotkit, defaultThrottleMs]);
 	const designSkill = openGenerativeUI?.designSkill ?? DEFAULT_DESIGN_SKILL;
@@ -3529,15 +3542,6 @@ function useAgent({ agentId, threadId, updates, throttleMs } = {}) {
 	const providerThrottleMs = copilotkit.defaultThrottleMs;
 	const chatConfig = useCopilotChatConfiguration();
 	threadId ??= chatConfig?.threadId;
-	const effectiveThrottleMs = useMemo(() => {
-		const resolved = throttleMs ?? providerThrottleMs ?? 0;
-		if (!Number.isFinite(resolved) || resolved < 0) {
-			const source = throttleMs !== void 0 ? "hook-level throttleMs" : "provider-level defaultThrottleMs";
-			console.error(`useAgent: ${source} must be a non-negative finite number, got ${resolved}. Falling back to unthrottled.`);
-			return 0;
-		}
-		return resolved;
-	}, [throttleMs, providerThrottleMs]);
 	const [, forceUpdate] = useReducer((x) => x + 1, 0);
 	const updateFlags = useMemo(() => updates ?? ALL_UPDATES, [JSON.stringify(updates)]);
 	const provisionalAgentCache = useRef(/* @__PURE__ */ new Map());
@@ -3600,9 +3604,8 @@ function useAgent({ agentId, threadId, updates, throttleMs } = {}) {
 	]);
 	useEffect(() => {
 		if (updateFlags.length === 0) return;
-		const handlers = {};
-		let timerId = null;
 		let active = true;
+		const handlers = {};
 		let batchScheduled = false;
 		const batchedForceUpdate = () => {
 			if (!active) return;
@@ -3614,46 +3617,24 @@ function useAgent({ agentId, threadId, updates, throttleMs } = {}) {
 				});
 			}
 		};
-		if (updateFlags.includes(UseAgentUpdate.OnMessagesChanged)) {
-			const ms = effectiveThrottleMs;
-			if (ms > 0) {
-				let throttleActive = false;
-				let pending = false;
-				const throttledNotify = () => {
-					if (!active) return;
-					if (!throttleActive) {
-						throttleActive = true;
-						pending = false;
-						forceUpdate();
-						timerId = setTimeout(function trailingEdge() {
-							timerId = null;
-							if (active && pending) {
-								pending = false;
-								forceUpdate();
-								timerId = setTimeout(trailingEdge, ms);
-							} else throttleActive = false;
-						}, ms);
-					} else pending = true;
-				};
-				handlers.onMessagesChanged = throttledNotify;
-			} else handlers.onMessagesChanged = forceUpdate;
-		}
+		if (updateFlags.includes(UseAgentUpdate.OnMessagesChanged)) handlers.onMessagesChanged = forceUpdate;
 		if (updateFlags.includes(UseAgentUpdate.OnStateChanged)) handlers.onStateChanged = batchedForceUpdate;
 		if (updateFlags.includes(UseAgentUpdate.OnRunStatusChanged)) {
 			handlers.onRunInitialized = batchedForceUpdate;
 			handlers.onRunFinalized = batchedForceUpdate;
 			handlers.onRunFailed = batchedForceUpdate;
+			handlers.onRunErrorEvent = batchedForceUpdate;
 		}
-		const subscription = agent.subscribe(handlers);
+		const subscription = copilotkit.subscribeToAgentWithOptions(agent, handlers, { throttleMs });
 		return () => {
 			active = false;
-			if (timerId !== null) clearTimeout(timerId);
 			subscription.unsubscribe();
 		};
 	}, [
 		agent,
 		forceUpdate,
-		effectiveThrottleMs,
+		throttleMs,
+		providerThrottleMs,
 		updateFlags
 	]);
 	useEffect(() => {
@@ -4607,13 +4588,14 @@ function useThreads$1({ agentId, includeArchived, limit }) {
 	const { copilotkit } = useCopilotKit();
 	const [store] = useState(() => ɵcreateThreadStore({ fetch: globalThis.fetch }));
 	const coreThreads = useThreadStoreSelector(store, ɵselectThreads);
-	const threads = useMemo(() => coreThreads.map(({ id, agentId, name, archived, createdAt, updatedAt }) => ({
+	const threads = useMemo(() => coreThreads.map(({ id, agentId, name, archived, createdAt, updatedAt, lastRunAt }) => ({
 		id,
 		agentId,
 		name,
 		archived,
 		createdAt,
-		updatedAt
+		updatedAt,
+		...lastRunAt !== void 0 ? { lastRunAt } : {}
 	})), [coreThreads]);
 	const storeIsLoading = useThreadStoreSelector(store, ɵselectThreadsIsLoading);
 	const storeError = useThreadStoreSelector(store, ɵselectThreadsError);
@@ -4626,7 +4608,9 @@ function useThreads$1({ agentId, includeArchived, limit }) {
 		if (copilotkit.runtimeUrl) return null;
 		return /* @__PURE__ */ new Error("Runtime URL is not configured");
 	}, [copilotkit.runtimeUrl]);
-	const isLoading = runtimeError ? false : storeIsLoading;
+	const [hasDispatchedContext, setHasDispatchedContext] = useState(false);
+	const preConnectLoading = !!copilotkit.runtimeUrl && !hasDispatchedContext;
+	const isLoading = runtimeError ? false : preConnectLoading || storeIsLoading;
 	const error = runtimeError ?? storeError;
 	useEffect(() => {
 		store.start();
@@ -4634,19 +4618,27 @@ function useThreads$1({ agentId, includeArchived, limit }) {
 			store.stop();
 		};
 	}, [store]);
+	const runtimeStatus = copilotkit.runtimeConnectionStatus;
 	useEffect(() => {
-		const context = copilotkit.runtimeUrl ? {
+		if (!copilotkit.runtimeUrl) {
+			store.setContext(null);
+			return;
+		}
+		if (runtimeStatus !== CopilotKitCoreRuntimeConnectionStatus.Connected) return;
+		const context = {
 			runtimeUrl: copilotkit.runtimeUrl,
 			headers: { ...copilotkit.headers },
 			wsUrl: copilotkit.intelligence?.wsUrl,
 			agentId,
 			includeArchived,
 			limit
-		} : null;
+		};
 		store.setContext(context);
+		setHasDispatchedContext(true);
 	}, [
 		store,
 		copilotkit.runtimeUrl,
+		runtimeStatus,
 		headersKey,
 		copilotkit.intelligence?.wsUrl,
 		agentId,
@@ -5829,6 +5821,7 @@ CopilotChatMessageView.Cursor = function Cursor({ className, ...props }) {
 const CopilotChatAttachmentQueue = ({ attachments, onRemoveAttachment, className }) => {
 	if (attachments.length === 0) return null;
 	return /* @__PURE__ */ jsx("div", {
+		"data-testid": "copilot-attachment-queue",
 		className: cn("cpk:flex cpk:flex-wrap cpk:gap-2 cpk:p-2", className),
 		children: attachments.map((attachment) => {
 			const isMedia = attachment.type === "image" || attachment.type === "video";
@@ -6171,9 +6164,91 @@ function useKeyboardHeight() {
 	return keyboardState;
 }
 
+//#endregion
+//#region src/v2/components/chat/normalize-auto-scroll.ts
+const VALID = [
+	"pin-to-bottom",
+	"pin-to-send",
+	"none"
+];
+function normalizeAutoScroll(value) {
+	if (value === void 0) return "pin-to-bottom";
+	if (value === true) return "pin-to-bottom";
+	if (value === false) return "none";
+	if (VALID.includes(value)) return value;
+	return "pin-to-bottom";
+}
+
+//#endregion
+//#region src/v2/components/chat/last-user-message-context.ts
+const LastUserMessageContext = React.createContext({
+	id: null,
+	sendNonce: 0
+});
+
+//#endregion
+//#region src/v2/hooks/use-pin-to-send.ts
+function usePinToSend({ scrollRef, contentRef, spacerRef, topOffset = 16 }) {
+	const { id, sendNonce } = useContext(LastUserMessageContext);
+	const lastNonceRef = useRef(-1);
+	const currentSpacerHeightRef = useRef(0);
+	useEffect(() => {
+		if (sendNonce === lastNonceRef.current) return;
+		lastNonceRef.current = sendNonce;
+		if (!id) return;
+		const scrollEl = scrollRef.current;
+		const contentEl = contentRef.current;
+		const spacerEl = spacerRef.current;
+		if (!scrollEl || !contentEl || !spacerEl) return;
+		const escaped = typeof CSS !== "undefined" && CSS.escape ? CSS.escape(id) : id.replace(/[!"#$%&'()*+,./:;<=>?@[\\\]^`{|}~]/g, "\\$&");
+		const targetEl = contentEl.querySelector(`[data-message-id="${escaped}"]`);
+		if (!targetEl) return;
+		const viewportHeight = scrollEl.clientHeight;
+		const userMessageHeight = targetEl.getBoundingClientRect().height;
+		const paddingTop = parseFloat(getComputedStyle(targetEl).paddingTop) || 0;
+		const bubbleHeight = Math.max(0, userMessageHeight - paddingTop);
+		const spacerHeight = Math.max(0, viewportHeight - bubbleHeight - topOffset);
+		spacerEl.style.height = `${spacerHeight}px`;
+		currentSpacerHeightRef.current = spacerHeight;
+		const raf = requestAnimationFrame(() => {
+			const targetTop = computeOffsetTop(targetEl, scrollEl) + paddingTop - topOffset;
+			scrollEl.scrollTo({
+				top: Math.max(0, targetTop),
+				behavior: "smooth"
+			});
+		});
+		const ro = new ResizeObserver(() => {
+			if (!contentEl || !spacerEl || !scrollEl) return;
+			const consumedBelow = contentEl.getBoundingClientRect().height - computeOffsetTop(targetEl, contentEl) - userMessageHeight;
+			const remaining = Math.max(0, spacerHeight - consumedBelow);
+			if (remaining < currentSpacerHeightRef.current) {
+				spacerEl.style.height = `${remaining}px`;
+				currentSpacerHeightRef.current = remaining;
+			}
+		});
+		ro.observe(contentEl);
+		return () => {
+			cancelAnimationFrame(raf);
+			ro.disconnect();
+		};
+	}, [
+		id,
+		sendNonce,
+		scrollRef,
+		contentRef,
+		spacerRef,
+		topOffset
+	]);
+}
+function computeOffsetTop(el, stopAt) {
+	const elRect = el.getBoundingClientRect();
+	const stopRect = stopAt.getBoundingClientRect();
+	return elRect.top - stopRect.top + stopAt.scrollTop;
+}
+
 //#endregion
 //#region src/v2/components/chat/CopilotChatView.tsx
-const FEATHER_HEIGHT = 96;
+const SCROLL_BUTTON_OFFSET = 16;
 function DropOverlay() {
 	return /* @__PURE__ */ jsx("div", {
 		className: cn("cpk:absolute cpk:inset-0 cpk:z-50 cpk:pointer-events-none", "cpk:flex cpk:items-center cpk:justify-center", "cpk:bg-primary/5 cpk:backdrop-blur-[2px]", "cpk:border-2 cpk:border-dashed cpk:border-primary/40 cpk:rounded-lg cpk:m-2"),
@@ -6186,7 +6261,7 @@ function DropOverlay() {
 		})
 	});
 }
-function CopilotChatView({ messageView, input, scrollView, suggestionView, welcomeScreen, messages = [], autoScroll = true, isRunning = false, suggestions, suggestionLoadingIndexes, onSelectSuggestion, onSubmitMessage, onStop, inputMode, inputValue, onInputChange, onStartTranscribe, onCancelTranscribe, onFinishTranscribe, onFinishTranscribeWithAudio, attachments, onRemoveAttachment, onAddFile, dragOver, onDragOver, onDragLeave, onDrop, disclaimer, children, className, ...props }) {
+function CopilotChatView({ messageView, input, scrollView, suggestionView, welcomeScreen, messages = [], autoScroll = true, isRunning = false, suggestions, suggestionLoadingIndexes, onSelectSuggestion, onSubmitMessage, onStop, inputMode, inputValue, onInputChange, onStartTranscribe, onCancelTranscribe, onFinishTranscribe, onFinishTranscribeWithAudio, attachments, onRemoveAttachment, onAddFile, dragOver, onDragOver, onDragLeave, onDrop, isConnecting = false, hasExplicitThreadId = false, disclaimer, children, className, ...props }) {
 	const inputContainerRef = useRef(null);
 	const [inputContainerHeight, setInputContainerHeight] = useState(0);
 	const [isResizing, setIsResizing] = useState(false);
@@ -6236,11 +6311,11 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 		onAddFile,
 		positioning: "static",
 		keyboardHeight: isKeyboardOpen ? keyboardHeight : 0,
-		containerRef: inputContainerRef,
 		showDisclaimer: true,
+		bottomAnchored: true,
 		...disclaimer !== void 0 ? { disclaimer } : {}
 	});
-	const hasSuggestions = Array.isArray(suggestions) && suggestions.length > 0;
+	const hasSuggestions = !isConnecting && !isRunning && Array.isArray(suggestions) && suggestions.length > 0;
 	const BoundSuggestionView = hasSuggestions ? renderSlot(suggestionView, CopilotChatSuggestionView, {
 		suggestions,
 		loadingIndexes: suggestionLoadingIndexes,
@@ -6252,7 +6327,8 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 		inputContainerHeight,
 		isResizing,
 		children: /* @__PURE__ */ jsx("div", {
-			style: { paddingBottom: `${hasSuggestions ? 4 : 32}px` },
+			"data-testid": "copilot-scroll-content",
+			style: { paddingBottom: `${inputContainerHeight + (hasSuggestions ? 4 : 32)}px` },
 			children: /* @__PURE__ */ jsxs("div", {
 				className: "cpk:max-w-3xl cpk:mx-auto",
 				children: [BoundMessageView, hasSuggestions ? /* @__PURE__ */ jsx("div", {
@@ -6262,7 +6338,7 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 			})
 		})
 	});
-	if (messages.length === 0 && !(welcomeScreen === false)) {
+	if (messages.length === 0 && !(welcomeScreen === false) && !isConnecting && !hasExplicitThreadId) {
 		const BoundInputForWelcome = renderSlot(input, CopilotChatInput_default, {
 			onSubmitMessage,
 			onStop,
@@ -6326,15 +6402,19 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 		children: [
 			dragOver && /* @__PURE__ */ jsx(DropOverlay, {}),
 			BoundScrollView,
-			/* @__PURE__ */ jsx("div", {
-				className: "cpk:max-w-3xl cpk:mx-auto cpk:w-full",
-				children: attachments && attachments.length > 0 && /* @__PURE__ */ jsx(CopilotChatAttachmentQueue, {
-					attachments,
-					onRemoveAttachment: (id) => onRemoveAttachment?.(id),
-					className: "cpk:px-4"
-				})
-			}),
-			BoundInput
+			/* @__PURE__ */ jsxs("div", {
+				ref: inputContainerRef,
+				"data-testid": "copilot-input-overlay",
+				className: "cpk:absolute cpk:bottom-0 cpk:left-0 cpk:right-0 cpk:z-20 cpk:pointer-events-none",
+				children: [attachments && attachments.length > 0 && /* @__PURE__ */ jsx("div", {
+					className: "cpk:max-w-3xl cpk:mx-auto cpk:w-full cpk:pointer-events-auto",
+					children: /* @__PURE__ */ jsx(CopilotChatAttachmentQueue, {
+						attachments,
+						onRemoveAttachment: (id) => onRemoveAttachment?.(id),
+						className: "cpk:px-4"
+					})
+				}), BoundInput]
+			})
 		]
 	});
 }
@@ -6363,15 +6443,66 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 				BoundFeather,
 				!isAtBottom && !isResizing && /* @__PURE__ */ jsx("div", {
 					className: "cpk:absolute cpk:inset-x-0 cpk:flex cpk:justify-center cpk:z-30 cpk:pointer-events-none",
-					style: { bottom: `${inputContainerHeight + FEATHER_HEIGHT + 16}px` },
+					style: { bottom: `${inputContainerHeight + SCROLL_BUTTON_OFFSET}px` },
 					children: renderSlot(scrollToBottomButton, CopilotChatView.ScrollToBottomButton, { onClick: () => scrollToBottom() })
 				})
 			] })
 		});
 	};
-	_CopilotChatView.ScrollView = ({ children, autoScroll = true, scrollToBottomButton, feather, inputContainerHeight = 0, isResizing = false, className, ...props }) => {
+	const PinToSendScrollContainer = ({ children, scrollRef, contentRef, scrollToBottom, scrollToBottomButton, feather, inputContainerHeight, isResizing, nonAutoScrollEl, nonAutoScrollRefCallback, showScrollButton, className, ...props }) => {
+		const spacerRef = useRef(null);
+		usePinToSend({
+			scrollRef,
+			contentRef,
+			spacerRef,
+			topOffset: 16
+		});
+		const BoundFeather = renderSlot(feather, CopilotChatView.Feather, {});
+		return /* @__PURE__ */ jsx(ScrollElementContext.Provider, {
+			value: nonAutoScrollEl,
+			children: /* @__PURE__ */ jsxs("div", {
+				className: cn("cpk:h-full cpk:max-h-full cpk:flex cpk:flex-col cpk:min-h-0 cpk:relative", className),
+				children: [
+					/* @__PURE__ */ jsxs("div", {
+						ref: nonAutoScrollRefCallback,
+						className: "cpk:flex-1 cpk:min-h-0 cpk:overflow-y-auto cpk:overflow-x-hidden",
+						...props,
+						children: [/* @__PURE__ */ jsx("div", {
+							ref: contentRef,
+							className: "cpk:px-4 cpk:sm:px-0 cpk:[div[data-sidebar-chat]_&]:px-8 cpk:[div[data-popup-chat]_&]:px-6",
+							children
+						}), /* @__PURE__ */ jsx("div", {
+							ref: spacerRef,
+							"data-pin-to-send-spacer": true,
+							"aria-hidden": "true",
+							style: {
+								height: 0,
+								flex: "0 0 auto"
+							}
+						})]
+					}),
+					BoundFeather,
+					showScrollButton && !isResizing && /* @__PURE__ */ jsx("div", {
+						className: "cpk:absolute cpk:inset-x-0 cpk:flex cpk:justify-center cpk:z-30 cpk:pointer-events-none",
+						style: { bottom: `${inputContainerHeight + SCROLL_BUTTON_OFFSET}px` },
+						children: renderSlot(scrollToBottomButton, CopilotChatView.ScrollToBottomButton, { onClick: () => scrollToBottom() })
+					})
+				]
+			})
+		});
+	};
+	_CopilotChatView.ScrollView = ({ children, autoScroll = "pin-to-bottom", scrollToBottomButton, feather, inputContainerHeight = 0, isResizing = false, className, ...props }) => {
+		const mode = normalizeAutoScroll(autoScroll);
 		const [hasMounted, setHasMounted] = useState(false);
-		const { scrollRef, contentRef, scrollToBottom } = useStickToBottom();
+		const scrollRef = useRef(null);
+		const contentRef = useRef(null);
+		const scrollToBottom = useCallback(() => {
+			const el = scrollRef.current;
+			if (el) el.scrollTo({
+				top: el.scrollHeight,
+				behavior: "smooth"
+			});
+		}, []);
 		const [showScrollButton, setShowScrollButton] = useState(false);
 		const [nonAutoScrollEl, setNonAutoScrollEl] = useState(null);
 		const nonAutoScrollRefCallback = useCallback((el) => {
@@ -6382,7 +6513,7 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 			setHasMounted(true);
 		}, []);
 		useEffect(() => {
-			if (autoScroll) return;
+			if (mode === "pin-to-bottom") return;
 			const scrollElement = scrollRef.current;
 			if (!scrollElement) return;
 			const checkScroll = () => {
@@ -6396,7 +6527,7 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 				scrollElement.removeEventListener("scroll", checkScroll);
 				resizeObserver.disconnect();
 			};
-		}, [scrollRef, autoScroll]);
+		}, [scrollRef, mode]);
 		if (!hasMounted) return /* @__PURE__ */ jsx("div", {
 			className: "cpk:h-full cpk:max-h-full cpk:flex cpk:flex-col cpk:min-h-0 cpk:overflow-y-auto cpk:overflow-x-hidden",
 			children: /* @__PURE__ */ jsx("div", {
@@ -6404,7 +6535,7 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 				children
 			})
 		});
-		if (!autoScroll) {
+		if (mode === "none") {
 			const BoundFeather = renderSlot(feather, CopilotChatView.Feather, {});
 			return /* @__PURE__ */ jsx(ScrollElementContext.Provider, {
 				value: nonAutoScrollEl,
@@ -6421,13 +6552,28 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 						BoundFeather,
 						showScrollButton && !isResizing && /* @__PURE__ */ jsx("div", {
 							className: "cpk:absolute cpk:inset-x-0 cpk:flex cpk:justify-center cpk:z-30 cpk:pointer-events-none",
-							style: { bottom: `${inputContainerHeight + FEATHER_HEIGHT + 16}px` },
+							style: { bottom: `${inputContainerHeight + SCROLL_BUTTON_OFFSET}px` },
 							children: renderSlot(scrollToBottomButton, CopilotChatView.ScrollToBottomButton, { onClick: () => scrollToBottom() })
 						})
 					]
 				})
 			});
 		}
+		if (mode === "pin-to-send") return /* @__PURE__ */ jsx(PinToSendScrollContainer, {
+			scrollRef,
+			contentRef,
+			scrollToBottom,
+			scrollToBottomButton,
+			feather,
+			inputContainerHeight,
+			isResizing,
+			nonAutoScrollEl,
+			nonAutoScrollRefCallback,
+			showScrollButton,
+			className,
+			...props,
+			children
+		});
 		return /* @__PURE__ */ jsx(StickToBottom, {
 			className: cn("cpk:flex-1 cpk:max-h-full cpk:flex cpk:flex-col cpk:min-h-0", className),
 			resize: "smooth",
@@ -6450,9 +6596,8 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 		...props,
 		children: /* @__PURE__ */ jsx(ChevronDown, { className: "cpk:w-4 cpk:h-4 cpk:text-gray-600 cpk:dark:text-white" })
 	});
-	_CopilotChatView.Feather = ({ className, style, ...props }) => /* @__PURE__ */ jsx("div", {
-		className: cn("cpk:absolute cpk:bottom-0 cpk:left-0 cpk:right-4 cpk:h-24 cpk:pointer-events-none cpk:z-10 cpk:bg-gradient-to-t", "cpk:from-white cpk:via-white cpk:to-transparent", "cpk:dark:from-[rgb(33,33,33)] cpk:dark:via-[rgb(33,33,33)]", className),
-		style,
+	_CopilotChatView.Feather = ({ className, ...props }) => /* @__PURE__ */ jsx("div", {
+		className,
 		...props
 	});
 	_CopilotChatView.WelcomeMessage = ({ className, ...props }) => {
@@ -6620,7 +6765,9 @@ async function transcribeAudio(core, audioBlob, filename = "recording.webm") {
 function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen, attachments: attachmentsConfig, onError, throttleMs, ...props }) {
 	const existingConfig = useCopilotChatConfiguration();
 	const resolvedAgentId = agentId ?? existingConfig?.agentId ?? DEFAULT_AGENT_ID;
-	const resolvedThreadId = useMemo(() => threadId ?? existingConfig?.threadId ?? randomUUID(), [threadId, existingConfig?.threadId]);
+	const providedThreadId = threadId ?? existingConfig?.threadId;
+	const resolvedThreadId = useMemo(() => providedThreadId ?? randomUUID(), [providedThreadId]);
+	const hasExplicitThreadId = !!threadId || !!existingConfig?.hasExplicitThreadId;
 	const { agent } = useAgent({
 		agentId: resolvedAgentId,
 		threadId: resolvedThreadId,
@@ -6658,7 +6805,10 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 	const isTranscriptionEnabled = copilotkit.audioFileTranscriptionEnabled;
 	const isMediaRecorderSupported = typeof window !== "undefined" && typeof MediaRecorder !== "undefined";
 	const { messageView: providedMessageView, suggestionView: providedSuggestionView, onStop: providedStopHandler, ...restProps } = props;
+	const [lastConnectedThreadId, setLastConnectedThreadId] = useState(null);
+	const isConnecting = hasExplicitThreadId && lastConnectedThreadId !== resolvedThreadId;
 	useEffect(() => {
+		if (!hasExplicitThreadId) return;
 		let detached = false;
 		const connectAbortController = new AbortController();
 		if (agent instanceof HttpAgent) agent.abortController = connectAbortController;
@@ -6668,6 +6818,10 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 			} catch (error) {
 				if (detached) return;
 				console.error("CopilotChat: connectAgent failed", error);
+			} finally {
+				if (!detached) (typeof requestAnimationFrame === "function" ? requestAnimationFrame : (cb) => setTimeout(cb, 16))(() => {
+					if (!detached) setLastConnectedThreadId(resolvedThreadId);
+				});
 			}
 		};
 		connect(agent);
@@ -6679,7 +6833,8 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 	}, [
 		resolvedThreadId,
 		agent,
-		resolvedAgentId
+		resolvedAgentId,
+		hasExplicitThreadId
 	]);
 	const onSubmitInput = useCallback(async (value) => {
 		if (selectedAttachments.some((a) => a.status === "uploading")) {
@@ -6832,6 +6987,22 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 		const toolCallsKey = "toolCalls" in m && Array.isArray(m.toolCalls) ? m.toolCalls.map((tc) => `${tc.id}:${tc.function?.arguments?.length ?? 0}`).join(";") : "";
 		return `${m.id}:${m.role}:${contentKey}:${toolCallsKey}`;
 	}).join(",")]);
+	const lastUserMessageId = useMemo(() => {
+		for (let i = messages.length - 1; i >= 0; i--) if (messages[i].role === "user") return messages[i].id;
+		return null;
+	}, [messages]);
+	const [sendNonce, setSendNonce] = useState(0);
+	const prevLastUserMessageIdRef = useRef(lastUserMessageId);
+	useEffect(() => {
+		if (lastUserMessageId && lastUserMessageId !== prevLastUserMessageIdRef.current) {
+			setSendNonce((n) => n + 1);
+			prevLastUserMessageIdRef.current = lastUserMessageId;
+		}
+	}, [lastUserMessageId]);
+	const lastUserMessageState = useMemo(() => ({
+		id: lastUserMessageId,
+		sendNonce
+	}), [lastUserMessageId, sendNonce]);
 	const RenderedChatView = renderSlot(chatView, CopilotChatView, {
 		...mergedProps,
 		messages,
@@ -6850,11 +7021,14 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 		dragOver,
 		onDragOver: handleDragOver,
 		onDragLeave: handleDragLeave,
-		onDrop: handleDrop
+		onDrop: handleDrop,
+		isConnecting,
+		hasExplicitThreadId
 	});
 	return /* @__PURE__ */ jsx(CopilotChatConfigurationProvider, {
 		agentId: resolvedAgentId,
 		threadId: resolvedThreadId,
+		hasExplicitThreadId,
 		labels,
 		isModalDefaultOpen,
 		children: /* @__PURE__ */ jsxs("div", {
@@ -6885,7 +7059,10 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 					},
 					children: transcriptionError
 				}),
-				RenderedChatView
+				/* @__PURE__ */ jsx(LastUserMessageContext.Provider, {
+					value: lastUserMessageState,
+					children: RenderedChatView
+				})
 			]
 		})
 	});
@@ -8611,12 +8788,19 @@ function useCoAgentStateRenders() {
 //#region src/context/threads-context.tsx
 const ThreadsContext = createContext(void 0);
 function ThreadsProvider({ children, threadId: explicitThreadId }) {
-	const [internalThreadId, setThreadId] = useState(() => randomUUID());
+	const [internalThreadId, setInternalThreadId] = useState(() => randomUUID());
+	const [internalIsExplicit, setInternalIsExplicit] = useState(false);
 	const threadId = explicitThreadId ?? internalThreadId;
+	const isThreadIdExplicit = explicitThreadId != null || internalIsExplicit;
+	const setThreadId = useCallback((value) => {
+		setInternalThreadId(value);
+		setInternalIsExplicit(true);
+	}, []);
 	return /* @__PURE__ */ jsx(ThreadsContext.Provider, {
 		value: {
 			threadId,
-			setThreadId
+			setThreadId,
+			isThreadIdExplicit
 		},
 		children
 	});
@@ -9318,7 +9502,7 @@ function CopilotKitInternal(cpkProps) {
 		if (props.agent) setAgentSession({ agentName: props.agent });
 		else setAgentSession(null);
 	}, [props.agent]);
-	const { threadId, setThreadId: setInternalThreadId } = useThreads();
+	const { threadId, setThreadId: setInternalThreadId, isThreadIdExplicit } = useThreads();
 	const setThreadId = useCallback((value) => {
 		if (props.threadId) throw new Error("Cannot call setThreadId() when threadId is provided via props.");
 		setInternalThreadId(value);
@@ -9518,6 +9702,7 @@ function CopilotKitInternal(cpkProps) {
 	return /* @__PURE__ */ jsx(CopilotChatConfigurationProvider, {
 		agentId: props.agent ?? "default",
 		threadId,
+		hasExplicitThreadId: isThreadIdExplicit,
 		children: /* @__PURE__ */ jsxs(CopilotContext.Provider, {
 			value: copilotContextValue,
 			children: [
@@ -9568,4 +9753,4 @@ function validateProps(props) {
 
 //#endregion
 export { CopilotKitProvider as $, CopilotChatSuggestionView as A, useConfigureSuggestions as B, CopilotChatToggleButton as C, CopilotChatView_default as D, CopilotChat as E, CopilotChatAssistantMessage_default as F, useRenderTool as G, useCapabilities as H, CopilotChatToolCallsView as I, useRenderActivityMessage as J, useComponent as K, useAttachments as L, CopilotChatReasoningMessage_default as M, CopilotChatUserMessage_default as N, CopilotChatAttachmentQueue as O, CopilotChatAttachmentRenderer as P, useRenderToolCall as Q, useThreads$1 as R, CopilotModalHeader as S, DefaultOpenIcon as T, useHumanInTheLoop as U, useSuggestions as V, useDefaultRenderTool as W, UseAgentUpdate as X, useRenderCustomMessages as Y, useAgent as Z, WildcardToolCallRender as _, ThreadsProvider as a, SandboxFunctionsContext as at, CopilotPopupView as b, CoAgentStateRendersProvider as c, MCPAppsActivityRenderer as ct, shouldShowDevConsole as d, CopilotChatInput_default as dt, useCopilotKit as et, useToast as f, AudioRecorderError as ft, useCopilotContext as g, CopilotContext as h, useCopilotChatConfiguration as ht, ThreadsContext as i, createA2UIMessageRenderer as it, CopilotChatSuggestionPill as j, CopilotChatMessageView as k, useCoAgentStateRenders as l, MCPAppsActivityType as lt, useCopilotMessagesContext as m, CopilotChatConfigurationProvider as mt, defaultCopilotContextCategories as n, useAgentContext as nt, useThreads as o, useSandboxFunctions as ot, CopilotMessagesContext as p, CopilotChatAudioRecorder as pt, useFrontendTool as q, CoAgentStateRenderBridge as r, defineToolCallRenderer as rt, CoAgentStateRendersContext as s, MCPAppsActivityContentSchema as st, CopilotKit as t, CopilotKitCoreReact as tt, useAsyncCallback as u, CopilotKitInspector as ut, CopilotPopup as v, DefaultCloseIcon as w, CopilotSidebarView as x, CopilotSidebar as y, useInterrupt as z };
-//# sourceMappingURL=copilotkit-Cj2ZIxVr.mjs.map
+//# sourceMappingURL=copilotkit-Bd0m5HFp.mjs.map