@copilotkit/react-core 1.56.2 → 1.56.4

package/dist/{copilotkit-CSJw5BG8.cjs → copilotkit-tb4zqaMK.cjs}

@@ -175,7 +175,7 @@ const CopilotChatDefaultLabels = {
 	welcomeMessageText: "How can I help you today?"
 };
 const CopilotChatConfiguration = (0, react.createContext)(null);
-const CopilotChatConfigurationProvider = ({ children, labels, agentId, threadId, isModalDefaultOpen }) => {
+const CopilotChatConfigurationProvider = ({ children, labels, agentId, threadId, hasExplicitThreadId, isModalDefaultOpen }) => {
 	const parentConfig = (0, react.useContext)(CopilotChatConfiguration);
 	const stableLabels = useShallowStableRef(labels);
 	const mergedLabels = (0, react.useMemo)(() => ({
@@ -189,6 +189,7 @@ const CopilotChatConfigurationProvider = ({ children, labels, agentId, threadId,
 		if (parentConfig?.threadId) return parentConfig.threadId;
 		return (0, _copilotkit_shared.randomUUID)();
 	}, [threadId, parentConfig?.threadId]);
+	const resolvedHasExplicitThreadId = (hasExplicitThreadId !== void 0 ? hasExplicitThreadId : !!threadId) || !!parentConfig?.hasExplicitThreadId;
 	const [internalModalOpen, setInternalModalOpen] = (0, react.useState)(isModalDefaultOpen ?? true);
 	const hasExplicitDefault = isModalDefaultOpen !== void 0;
 	const setAndSync = (0, react.useCallback)((open) => {
@@ -211,12 +212,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
 	]);
@@ -610,7 +613,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] = (0, react.useState)(() => value ?? "");
 	(0, react.useEffect)(() => {
@@ -1134,7 +1137,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__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -1349,6 +1353,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",
@@ -1390,6 +1396,14 @@ function getSeverityStyle(severity) {
 	}
 }
 function BannerShell({ severity, message, actionLabel, actionUrl, onDismiss }) {
+	(0, react.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__ */ (0, react_jsx_runtime.jsxs)("div", {
 		style: {
 			...BANNER_STYLES.base,
@@ -3342,7 +3356,6 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = {}, c
 		didMountRef.current = true;
 	}, []);
 	(0, react.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;
@@ -3559,15 +3572,6 @@ function useAgent({ agentId, threadId, updates, throttleMs } = {}) {
 	const providerThrottleMs = copilotkit.defaultThrottleMs;
 	const chatConfig = useCopilotChatConfiguration();
 	threadId ??= chatConfig?.threadId;
-	const effectiveThrottleMs = (0, react.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] = (0, react.useReducer)((x) => x + 1, 0);
 	const updateFlags = (0, react.useMemo)(() => updates ?? ALL_UPDATES, [JSON.stringify(updates)]);
 	const provisionalAgentCache = (0, react.useRef)(/* @__PURE__ */ new Map());
@@ -3630,9 +3634,8 @@ function useAgent({ agentId, threadId, updates, throttleMs } = {}) {
 	]);
 	(0, react.useEffect)(() => {
 		if (updateFlags.length === 0) return;
-		const handlers = {};
-		let timerId = null;
 		let active = true;
+		const handlers = {};
 		let batchScheduled = false;
 		const batchedForceUpdate = () => {
 			if (!active) return;
@@ -3644,46 +3647,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
 	]);
 	(0, react.useEffect)(() => {
@@ -4637,13 +4618,14 @@ function useThreads$1({ agentId, includeArchived, limit }) {
 	const { copilotkit } = useCopilotKit();
 	const [store] = (0, react.useState)(() => (0, _copilotkit_core.ɵcreateThreadStore)({ fetch: globalThis.fetch }));
 	const coreThreads = useThreadStoreSelector(store, _copilotkit_core.ɵselectThreads);
-	const threads = (0, react.useMemo)(() => coreThreads.map(({ id, agentId, name, archived, createdAt, updatedAt }) => ({
+	const threads = (0, react.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, _copilotkit_core.ɵselectThreadsIsLoading);
 	const storeError = useThreadStoreSelector(store, _copilotkit_core.ɵselectThreadsError);
@@ -4656,7 +4638,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] = (0, react.useState)(false);
+	const preConnectLoading = !!copilotkit.runtimeUrl && !hasDispatchedContext;
+	const isLoading = runtimeError ? false : preConnectLoading || storeIsLoading;
 	const error = runtimeError ?? storeError;
 	(0, react.useEffect)(() => {
 		store.start();
@@ -4664,19 +4648,27 @@ function useThreads$1({ agentId, includeArchived, limit }) {
 			store.stop();
 		};
 	}, [store]);
+	const runtimeStatus = copilotkit.runtimeConnectionStatus;
 	(0, react.useEffect)(() => {
-		const context = copilotkit.runtimeUrl ? {
+		if (!copilotkit.runtimeUrl) {
+			store.setContext(null);
+			return;
+		}
+		if (runtimeStatus !== _copilotkit_core.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,
@@ -5859,6 +5851,7 @@ CopilotChatMessageView.Cursor = function Cursor({ className, ...props }) {
 const CopilotChatAttachmentQueue = ({ attachments, onRemoveAttachment, className }) => {
 	if (attachments.length === 0) return null;
 	return /* @__PURE__ */ (0, react_jsx_runtime.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";
@@ -6201,9 +6194,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.default.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 } = (0, react.useContext)(LastUserMessageContext);
+	const lastNonceRef = (0, react.useRef)(-1);
+	const currentSpacerHeightRef = (0, react.useRef)(0);
+	(0, react.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__ */ (0, react_jsx_runtime.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"),
@@ -6216,7 +6291,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 = (0, react.useRef)(null);
 	const [inputContainerHeight, setInputContainerHeight] = (0, react.useState)(0);
 	const [isResizing, setIsResizing] = (0, react.useState)(false);
@@ -6266,11 +6341,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,
@@ -6282,7 +6357,8 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 		inputContainerHeight,
 		isResizing,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-			style: { paddingBottom: `${hasSuggestions ? 4 : 32}px` },
+			"data-testid": "copilot-scroll-content",
+			style: { paddingBottom: `${inputContainerHeight + (hasSuggestions ? 4 : 32)}px` },
 			children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "cpk:max-w-3xl cpk:mx-auto",
 				children: [BoundMessageView, hasSuggestions ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -6292,7 +6368,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,
@@ -6356,15 +6432,19 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 		children: [
 			dragOver && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DropOverlay, {}),
 			BoundScrollView,
-			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				className: "cpk:max-w-3xl cpk:mx-auto cpk:w-full",
-				children: attachments && attachments.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotChatAttachmentQueue, {
-					attachments,
-					onRemoveAttachment: (id) => onRemoveAttachment?.(id),
-					className: "cpk:px-4"
-				})
-			}),
-			BoundInput
+			/* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "cpk:max-w-3xl cpk:mx-auto cpk:w-full cpk:pointer-events-auto",
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotChatAttachmentQueue, {
+						attachments,
+						onRemoveAttachment: (id) => onRemoveAttachment?.(id),
+						className: "cpk:px-4"
+					})
+				}), BoundInput]
+			})
 		]
 	});
 }
@@ -6393,15 +6473,66 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 				BoundFeather,
 				!isAtBottom && !isResizing && /* @__PURE__ */ (0, react_jsx_runtime.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 = (0, react.useRef)(null);
+		usePinToSend({
+			scrollRef,
+			contentRef,
+			spacerRef,
+			topOffset: 16
+		});
+		const BoundFeather = renderSlot(feather, CopilotChatView.Feather, {});
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ScrollElementContext.Provider, {
+			value: nonAutoScrollEl,
+			children: /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsxs)("div", {
+						ref: nonAutoScrollRefCallback,
+						className: "cpk:flex-1 cpk:min-h-0 cpk:overflow-y-auto cpk:overflow-x-hidden",
+						...props,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("div", {
+							ref: spacerRef,
+							"data-pin-to-send-spacer": true,
+							"aria-hidden": "true",
+							style: {
+								height: 0,
+								flex: "0 0 auto"
+							}
+						})]
+					}),
+					BoundFeather,
+					showScrollButton && !isResizing && /* @__PURE__ */ (0, react_jsx_runtime.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] = (0, react.useState)(false);
-		const { scrollRef, contentRef, scrollToBottom } = (0, use_stick_to_bottom.useStickToBottom)();
+		const scrollRef = (0, react.useRef)(null);
+		const contentRef = (0, react.useRef)(null);
+		const scrollToBottom = (0, react.useCallback)(() => {
+			const el = scrollRef.current;
+			if (el) el.scrollTo({
+				top: el.scrollHeight,
+				behavior: "smooth"
+			});
+		}, []);
 		const [showScrollButton, setShowScrollButton] = (0, react.useState)(false);
 		const [nonAutoScrollEl, setNonAutoScrollEl] = (0, react.useState)(null);
 		const nonAutoScrollRefCallback = (0, react.useCallback)((el) => {
@@ -6412,7 +6543,7 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 			setHasMounted(true);
 		}, []);
 		(0, react.useEffect)(() => {
-			if (autoScroll) return;
+			if (mode === "pin-to-bottom") return;
 			const scrollElement = scrollRef.current;
 			if (!scrollElement) return;
 			const checkScroll = () => {
@@ -6426,7 +6557,7 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 				scrollElement.removeEventListener("scroll", checkScroll);
 				resizeObserver.disconnect();
 			};
-		}, [scrollRef, autoScroll]);
+		}, [scrollRef, mode]);
 		if (!hasMounted) return /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -6434,7 +6565,7 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 				children
 			})
 		});
-		if (!autoScroll) {
+		if (mode === "none") {
 			const BoundFeather = renderSlot(feather, CopilotChatView.Feather, {});
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ScrollElementContext.Provider, {
 				value: nonAutoScrollEl,
@@ -6451,13 +6582,28 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 						BoundFeather,
 						showScrollButton && !isResizing && /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)(PinToSendScrollContainer, {
+			scrollRef,
+			contentRef,
+			scrollToBottom,
+			scrollToBottomButton,
+			feather,
+			inputContainerHeight,
+			isResizing,
+			nonAutoScrollEl,
+			nonAutoScrollRefCallback,
+			showScrollButton,
+			className,
+			...props,
+			children
+		});
 		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(use_stick_to_bottom.StickToBottom, {
 			className: cn("cpk:flex-1 cpk:max-h-full cpk:flex cpk:flex-col cpk:min-h-0", className),
 			resize: "smooth",
@@ -6480,9 +6626,8 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 		...props,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(lucide_react.ChevronDown, { className: "cpk:w-4 cpk:h-4 cpk:text-gray-600 cpk:dark:text-white" })
 	});
-	_CopilotChatView.Feather = ({ className, style, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("div", {
+		className,
 		...props
 	});
 	_CopilotChatView.WelcomeMessage = ({ className, ...props }) => {
@@ -6650,7 +6795,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 ?? _copilotkit_shared.DEFAULT_AGENT_ID;
-	const resolvedThreadId = (0, react.useMemo)(() => threadId ?? existingConfig?.threadId ?? (0, _copilotkit_shared.randomUUID)(), [threadId, existingConfig?.threadId]);
+	const providedThreadId = threadId ?? existingConfig?.threadId;
+	const resolvedThreadId = (0, react.useMemo)(() => providedThreadId ?? (0, _copilotkit_shared.randomUUID)(), [providedThreadId]);
+	const hasExplicitThreadId = !!threadId || !!existingConfig?.hasExplicitThreadId;
 	const { agent } = useAgent({
 		agentId: resolvedAgentId,
 		threadId: resolvedThreadId,
@@ -6688,7 +6835,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] = (0, react.useState)(null);
+	const isConnecting = hasExplicitThreadId && lastConnectedThreadId !== resolvedThreadId;
 	(0, react.useEffect)(() => {
+		if (!hasExplicitThreadId) return;
 		let detached = false;
 		const connectAbortController = new AbortController();
 		if (agent instanceof _ag_ui_client.HttpAgent) agent.abortController = connectAbortController;
@@ -6698,6 +6848,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);
@@ -6709,7 +6863,8 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 	}, [
 		resolvedThreadId,
 		agent,
-		resolvedAgentId
+		resolvedAgentId,
+		hasExplicitThreadId
 	]);
 	const onSubmitInput = (0, react.useCallback)(async (value) => {
 		if (selectedAttachments.some((a) => a.status === "uploading")) {
@@ -6862,6 +7017,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 = (0, react.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] = (0, react.useState)(0);
+	const prevLastUserMessageIdRef = (0, react.useRef)(lastUserMessageId);
+	(0, react.useEffect)(() => {
+		if (lastUserMessageId && lastUserMessageId !== prevLastUserMessageIdRef.current) {
+			setSendNonce((n) => n + 1);
+			prevLastUserMessageIdRef.current = lastUserMessageId;
+		}
+	}, [lastUserMessageId]);
+	const lastUserMessageState = (0, react.useMemo)(() => ({
+		id: lastUserMessageId,
+		sendNonce
+	}), [lastUserMessageId, sendNonce]);
 	const RenderedChatView = renderSlot(chatView, CopilotChatView, {
 		...mergedProps,
 		messages,
@@ -6880,11 +7051,14 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 		dragOver,
 		onDragOver: handleDragOver,
 		onDragLeave: handleDragLeave,
-		onDrop: handleDrop
+		onDrop: handleDrop,
+		isConnecting,
+		hasExplicitThreadId
 	});
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotChatConfigurationProvider, {
 		agentId: resolvedAgentId,
 		threadId: resolvedThreadId,
+		hasExplicitThreadId,
 		labels,
 		isModalDefaultOpen,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -6915,7 +7089,10 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 					},
 					children: transcriptionError
 				}),
-				RenderedChatView
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(LastUserMessageContext.Provider, {
+					value: lastUserMessageState,
+					children: RenderedChatView
+				})
 			]
 		})
 	});
@@ -8641,12 +8818,19 @@ function useCoAgentStateRenders() {
 //#region src/context/threads-context.tsx
 const ThreadsContext = (0, react.createContext)(void 0);
 function ThreadsProvider({ children, threadId: explicitThreadId }) {
-	const [internalThreadId, setThreadId] = (0, react.useState)(() => (0, _copilotkit_shared.randomUUID)());
+	const [internalThreadId, setInternalThreadId] = (0, react.useState)(() => (0, _copilotkit_shared.randomUUID)());
+	const [internalIsExplicit, setInternalIsExplicit] = (0, react.useState)(false);
 	const threadId = explicitThreadId ?? internalThreadId;
+	const isThreadIdExplicit = explicitThreadId != null || internalIsExplicit;
+	const setThreadId = (0, react.useCallback)((value) => {
+		setInternalThreadId(value);
+		setInternalIsExplicit(true);
+	}, []);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ThreadsContext.Provider, {
 		value: {
 			threadId,
-			setThreadId
+			setThreadId,
+			isThreadIdExplicit
 		},
 		children
 	});
@@ -9348,7 +9532,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 = (0, react.useCallback)((value) => {
 		if (props.threadId) throw new Error("Cannot call setThreadId() when threadId is provided via props.");
 		setInternalThreadId(value);
@@ -9548,6 +9732,7 @@ function CopilotKitInternal(cpkProps) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotChatConfigurationProvider, {
 		agentId: props.agent ?? "default",
 		threadId,
+		hasExplicitThreadId: isThreadIdExplicit,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(CopilotContext.Provider, {
 			value: copilotContextValue,
 			children: [
@@ -10017,4 +10202,4 @@ Object.defineProperty(exports, 'useToast', {
     return useToast;
   }
 });
-//# sourceMappingURL=copilotkit-CSJw5BG8.cjs.map
+//# sourceMappingURL=copilotkit-tb4zqaMK.cjs.map