@copilotkit/react-core 1.55.3 → 1.56.1

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

@@ -299,8 +299,9 @@ const buttonVariants = (0, class_variance_authority.cva)("cpk:inline-flex cpk:it
 		size: "default"
 	}
 });
-function Button({ className, variant, size, asChild = false, ...props }) {
+const Button = react.forwardRef(function Button({ className, variant, size, asChild = false, ...props }, ref) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(asChild ? _radix_ui_react_slot.Slot : "button", {
+		ref,
 		"data-slot": "button",
 		className: cn(buttonVariants({
 			variant,
@@ -309,7 +310,7 @@ function Button({ className, variant, size, asChild = false, ...props }) {
 		})),
 		...props
 	});
-}
+});
 
 //#endregion
 //#region src/v2/components/ui/tooltip.tsx
@@ -751,6 +752,7 @@ function CopilotChatInput({ mode = "input", onSubmitMessage, onStop, isRunning =
 		});
 	}, [clearInputValue]);
 	const handleKeyDown = (e) => {
+		if (e.nativeEvent.isComposing || e.keyCode === 229) return;
 		if (commandQuery !== null && mode === "input") {
 			if (e.key === "ArrowDown") {
 				if (filteredCommands.length > 0) {
@@ -798,10 +800,8 @@ function CopilotChatInput({ mode = "input", onSubmitMessage, onStop, isRunning =
 		const trimmed = resolvedValue.trim();
 		if (!trimmed) return;
 		onSubmitMessage(trimmed);
-		if (!isControlled) {
-			setInternalValue("");
-			onChange?.("");
-		}
+		if (!isControlled) setInternalValue("");
+		onChange?.("");
 		if (inputRef.current) inputRef.current.focus();
 	};
 	const BoundTextArea = renderSlot(textArea, CopilotChatInput.TextArea, {
@@ -809,6 +809,12 @@ function CopilotChatInput({ mode = "input", onSubmitMessage, onStop, isRunning =
 		value: resolvedValue,
 		onChange: handleChange,
 		onKeyDown: handleKeyDown,
+		onCompositionStart: () => {
+			isComposingRef.current = true;
+		},
+		onCompositionEnd: () => {
+			isComposingRef.current = false;
+		},
 		autoFocus,
 		className: (0, tailwind_merge.twMerge)("cpk:w-full cpk:py-3", isExpanded ? "cpk:px-5" : "cpk:pr-5")
 	});
@@ -883,9 +889,10 @@ function CopilotChatInput({ mode = "input", onSubmitMessage, onStop, isRunning =
 		const target = e.target;
 		if (target.tagName !== "BUTTON" && !target.closest("button") && inputRef.current && mode === "input") inputRef.current.focus();
 	};
+	const isComposingRef = (0, react.useRef)(false);
 	const ensureMeasurements = (0, react.useCallback)(() => {
 		const textarea = inputRef.current;
-		if (!textarea) return;
+		if (!textarea || isComposingRef.current) return;
 		const previousValue = textarea.value;
 		const previousHeight = textarea.style.height;
 		textarea.style.height = "auto";
@@ -3072,7 +3079,7 @@ function useStableArrayProp(prop, warningMessage, isMeaningfulChange) {
 	}, [value, warningMessage]);
 	return value;
 }
-const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, publicApiKey, publicLicenseKey, licenseToken, properties = {}, agents__unsafe_dev_only: agents = {}, selfManagedAgents = {}, renderToolCalls, renderActivityMessages, renderCustomMessages, frontendTools, humanInTheLoop, openGenerativeUI, showDevConsole = false, useSingleEndpoint, onError, a2ui, defaultThrottleMs, inspectorDefaultAnchor }) => {
+const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = {}, credentials, publicApiKey, publicLicenseKey, licenseToken, properties = {}, agents__unsafe_dev_only: agents = {}, selfManagedAgents = {}, renderToolCalls, renderActivityMessages, renderCustomMessages, frontendTools, humanInTheLoop, openGenerativeUI, showDevConsole = false, useSingleEndpoint, onError, a2ui, defaultThrottleMs, inspectorDefaultAnchor, debug }) => {
 	const [shouldRenderInspector, setShouldRenderInspector] = (0, react.useState)(false);
 	const [runtimeA2UIEnabled, setRuntimeA2UIEnabled] = (0, react.useState)(false);
 	const [runtimeOpenGenUIEnabled, setRuntimeOpenGenUIEnabled] = (0, react.useState)(false);
@@ -3127,6 +3134,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, p
 		...selfManagedAgents
 	}), [agents, selfManagedAgents]);
 	const hasLocalAgents = mergedAgents && Object.keys(mergedAgents).length > 0;
+	const headers = typeof headersProp === "function" ? headersProp() : headersProp;
 	const mergedHeaders = (0, react.useMemo)(() => {
 		if (!resolvedPublicKey) return headers;
 		if (headers[HEADER_NAME]) return headers;
@@ -3228,7 +3236,8 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, p
 			tools: allTools,
 			renderToolCalls: allRenderToolCalls,
 			renderActivityMessages: allActivityRenderers,
-			renderCustomMessages: renderCustomMessagesList
+			renderCustomMessages: renderCustomMessagesList,
+			debug
 		});
 		if (defaultThrottleMs !== void 0) copilotkitRef.current.setDefaultThrottleMs(defaultThrottleMs);
 	}
@@ -3301,6 +3310,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, p
 		copilotkit.setCredentials(credentials);
 		copilotkit.setProperties(properties);
 		copilotkit.setAgents__unsafe_dev_only(mergedAgents);
+		copilotkit.setDebug(debug);
 	}, [
 		copilotkit,
 		chatApiEndpoint,
@@ -3308,7 +3318,8 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, p
 		credentials,
 		properties,
 		mergedAgents,
-		useSingleEndpoint
+		useSingleEndpoint,
+		debug
 	]);
 	const didMountRef = (0, react.useRef)(false);
 	(0, react.useEffect)(() => {
@@ -3429,18 +3440,21 @@ const ToolCallRenderer = react.default.memo(function ToolCallRenderer({ toolCall
 	const toolName = toolCall.function.name;
 	if (toolMessage) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderComponent, {
 		name: toolName,
+		toolCallId: toolCall.id,
 		args,
 		status: _copilotkit_core.ToolCallStatus.Complete,
 		result: toolMessage.content
 	});
 	else if (isExecuting) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderComponent, {
 		name: toolName,
+		toolCallId: toolCall.id,
 		args,
 		status: _copilotkit_core.ToolCallStatus.Executing,
 		result: void 0
 	});
 	else return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderComponent, {
 		name: toolName,
+		toolCallId: toolCall.id,
 		args,
 		status: _copilotkit_core.ToolCallStatus.InProgress,
 		result: void 0
@@ -3619,6 +3633,17 @@ function useAgent({ agentId, threadId, updates, throttleMs } = {}) {
 		const handlers = {};
 		let timerId = null;
 		let active = true;
+		let batchScheduled = false;
+		const batchedForceUpdate = () => {
+			if (!active) return;
+			if (!batchScheduled) {
+				batchScheduled = true;
+				queueMicrotask(() => {
+					batchScheduled = false;
+					if (active) forceUpdate();
+				});
+			}
+		};
 		if (updateFlags.includes(UseAgentUpdate.OnMessagesChanged)) {
 			const ms = effectiveThrottleMs;
 			if (ms > 0) {
@@ -3643,11 +3668,11 @@ function useAgent({ agentId, threadId, updates, throttleMs } = {}) {
 				handlers.onMessagesChanged = throttledNotify;
 			} else handlers.onMessagesChanged = forceUpdate;
 		}
-		if (updateFlags.includes(UseAgentUpdate.OnStateChanged)) handlers.onStateChanged = forceUpdate;
+		if (updateFlags.includes(UseAgentUpdate.OnStateChanged)) handlers.onStateChanged = batchedForceUpdate;
 		if (updateFlags.includes(UseAgentUpdate.OnRunStatusChanged)) {
-			handlers.onRunInitialized = forceUpdate;
-			handlers.onRunFinalized = forceUpdate;
-			handlers.onRunFailed = forceUpdate;
+			handlers.onRunInitialized = batchedForceUpdate;
+			handlers.onRunFinalized = batchedForceUpdate;
+			handlers.onRunFailed = batchedForceUpdate;
 		}
 		const subscription = agent.subscribe(handlers);
 		return () => {
@@ -3686,7 +3711,7 @@ function useRenderCustomMessages() {
 		const runId = resolvedRunId ?? `missing-run-id:${message.id}`;
 		const registryAgent = copilotkit.getAgent(agentId);
 		const agent = getThreadClone(registryAgent, threadId) ?? registryAgent;
-		if (!agent) throw new Error("Agent not found");
+		if (!agent) return null;
 		const messagesIdsInRun = resolvedRunId ? agent.messages.filter((msg) => copilotkit.getRunIdForMessage(agentId, threadId, msg.id) === resolvedRunId).map((msg) => msg.id) : [message.id];
 		const rawMessageIndex = agent.messages.findIndex((msg) => msg.id === message.id);
 		const messageIndex = rawMessageIndex >= 0 ? rawMessageIndex : 0;
@@ -4184,6 +4209,24 @@ function useHumanInTheLoop(tool, deps) {
 	]);
 }
 
+//#endregion
+//#region src/v2/hooks/use-capabilities.tsx
+/**
+* Returns the capabilities declared by the given agent (or the default agent).
+* Capabilities are populated from the runtime `/info` response at connection
+* time. The hook reads them synchronously from the agent instance — there is
+* no separate loading state, but the value will be `undefined` until the
+* runtime handshake completes.
+*
+* @param agentId - Optional agent ID. If omitted, uses the default agent.
+* @returns The agent's capabilities, or `undefined` if the agent doesn't
+*          declare capabilities.
+*/
+function useCapabilities(agentId) {
+	const { agent } = useAgent({ agentId });
+	if (agent && "capabilities" in agent) return agent.capabilities;
+}
+
 //#endregion
 //#region src/v2/hooks/use-suggestions.tsx
 function useSuggestions({ agentId } = {}) {
@@ -4835,16 +4878,13 @@ function CopilotChatAssistantMessage({ message, messages, isRunning, onThumbsUp,
 	useKatexStyles();
 	const boundMarkdownRenderer = renderSlot(markdownRenderer, CopilotChatAssistantMessage.MarkdownRenderer, { content: message.content || "" });
 	const boundCopyButton = renderSlot(copyButton, CopilotChatAssistantMessage.CopyButton, { onClick: async () => {
-		if (message.content) try {
-			await navigator.clipboard.writeText(message.content);
-		} catch (err) {
-			console.error("Failed to copy message:", err);
-		}
+		if (message.content) return await (0, _copilotkit_shared.copyToClipboard)(message.content);
+		return false;
 	} });
-	const boundThumbsUpButton = renderSlot(thumbsUpButton, CopilotChatAssistantMessage.ThumbsUpButton, { onClick: onThumbsUp });
-	const boundThumbsDownButton = renderSlot(thumbsDownButton, CopilotChatAssistantMessage.ThumbsDownButton, { onClick: onThumbsDown });
-	const boundReadAloudButton = renderSlot(readAloudButton, CopilotChatAssistantMessage.ReadAloudButton, { onClick: onReadAloud });
-	const boundRegenerateButton = renderSlot(regenerateButton, CopilotChatAssistantMessage.RegenerateButton, { onClick: onRegenerate });
+	const boundThumbsUpButton = renderSlot(thumbsUpButton, CopilotChatAssistantMessage.ThumbsUpButton, { onClick: onThumbsUp ? () => onThumbsUp(message) : void 0 });
+	const boundThumbsDownButton = renderSlot(thumbsDownButton, CopilotChatAssistantMessage.ThumbsDownButton, { onClick: onThumbsDown ? () => onThumbsDown(message) : void 0 });
+	const boundReadAloudButton = renderSlot(readAloudButton, CopilotChatAssistantMessage.ReadAloudButton, { onClick: onReadAloud ? () => onReadAloud(message) : void 0 });
+	const boundRegenerateButton = renderSlot(regenerateButton, CopilotChatAssistantMessage.RegenerateButton, { onClick: onRegenerate ? () => onRegenerate(message) : void 0 });
 	const boundToolbar = renderSlot(toolbar, CopilotChatAssistantMessage.Toolbar, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "cpk:flex cpk:items-center cpk:gap-1",
 		children: [
@@ -4937,14 +4977,17 @@ function CopilotChatAssistantMessage({ message, messages, isRunning, onThumbsUp,
 				if (timerRef.current !== null) clearTimeout(timerRef.current);
 			};
 		}, []);
-		const handleClick = (event) => {
-			setCopied(true);
-			if (timerRef.current !== null) clearTimeout(timerRef.current);
-			timerRef.current = setTimeout(() => {
-				timerRef.current = null;
-				setCopied(false);
-			}, 2e3);
-			if (onClick) onClick(event);
+		const handleClick = async (event) => {
+			let success = false;
+			if (onClick) success = await Promise.resolve(onClick(event)) === true;
+			if (success) {
+				setCopied(true);
+				if (timerRef.current !== null) clearTimeout(timerRef.current);
+				timerRef.current = setTimeout(() => {
+					timerRef.current = null;
+					setCopied(false);
+				}, 2e3);
+			}
 		};
 		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolbarButton, {
 			"data-testid": "copilot-copy-button",
@@ -5097,11 +5140,8 @@ function CopilotChatUserMessage({ message, onEditMessage, branchIndex, numberOfB
 	const mediaParts = (0, react.useMemo)(() => getMediaParts(message.content), [message.content]);
 	const BoundMessageRenderer = renderSlot(messageRenderer, CopilotChatUserMessage.MessageRenderer, { content: flattenedContent });
 	const BoundCopyButton = renderSlot(copyButton, CopilotChatUserMessage.CopyButton, { onClick: async () => {
-		if (flattenedContent) try {
-			await navigator.clipboard.writeText(flattenedContent);
-		} catch (err) {
-			console.error("Failed to copy message:", err);
-		}
+		if (flattenedContent) return await (0, _copilotkit_shared.copyToClipboard)(flattenedContent);
+		return false;
 	} });
 	const BoundEditButton = renderSlot(editButton, CopilotChatUserMessage.EditButton, { onClick: () => onEditMessage?.({ message }) });
 	const BoundBranchNavigation = renderSlot(branchNavigation, CopilotChatUserMessage.BranchNavigation, {
@@ -5189,10 +5229,13 @@ function CopilotChatUserMessage({ message, onEditMessage, branchIndex, numberOfB
 	_CopilotChatUserMessage.CopyButton = ({ className, title, onClick, ...props }) => {
 		const labels = useCopilotChatConfiguration()?.labels ?? CopilotChatDefaultLabels;
 		const [copied, setCopied] = (0, react.useState)(false);
-		const handleClick = (event) => {
-			setCopied(true);
-			setTimeout(() => setCopied(false), 2e3);
-			if (onClick) onClick(event);
+		const handleClick = async (event) => {
+			let success = false;
+			if (onClick) success = await Promise.resolve(onClick(event)) === true;
+			if (success) {
+				setCopied(true);
+				setTimeout(() => setCopied(false), 2e3);
+			}
 		};
 		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolbarButton, {
 			"data-testid": "copilot-user-copy-button",
@@ -5299,17 +5342,24 @@ function CopilotChatReasoningMessage({ message, messages, isRunning, header, con
 		return () => clearInterval(timer);
 	}, [isStreaming]);
 	const [isOpen, setIsOpen] = (0, react.useState)(isStreaming);
+	const userToggledRef = (0, react.useRef)(false);
 	(0, react.useEffect)(() => {
-		if (isStreaming) setIsOpen(true);
-		else setIsOpen(false);
+		if (isStreaming) {
+			userToggledRef.current = false;
+			setIsOpen(true);
+		} else if (!userToggledRef.current) setIsOpen(false);
 	}, [isStreaming]);
+	const handleToggle = hasContent ? () => {
+		userToggledRef.current = true;
+		setIsOpen((prev) => !prev);
+	} : void 0;
 	const label = isStreaming ? "Thinking…" : `Thought for ${formatDuration(elapsed)}`;
 	const boundHeader = renderSlot(header, CopilotChatReasoningMessage.Header, {
 		isOpen,
 		label,
 		hasContent,
 		isStreaming,
-		onClick: hasContent ? () => setIsOpen((prev) => !prev) : void 0
+		onClick: handleToggle
 	});
 	const boundContent = renderSlot(contentView, CopilotChatReasoningMessage.Content, {
 		isStreaming,
@@ -8013,6 +8063,20 @@ function shouldShowDevConsole(showDevConsole) {
 /**
 * An internal context to separate the messages state (which is constantly changing) from the rest of CopilotKit context
 */
+/**
+* Determine whether a GraphQL error should be suppressed based on its visibility
+* and whether the dev console is active.
+*
+* Returns `null` when the error should be surfaced to the UI, or a log prefix
+* string when the error should be suppressed (logged to console only).
+*
+* Exported for unit testing.
+*/
+function getErrorSuppression(visibility, isDev) {
+	if (visibility === _copilotkit_shared.ErrorVisibility.SILENT) return "CopilotKit Silent Error:";
+	if (!isDev && visibility === _copilotkit_shared.ErrorVisibility.DEV_ONLY) return "CopilotKit Error (hidden in production):";
+	return null;
+}
 const MessagesTapContext = (0, react.createContext)(null);
 function useMessagesTap() {
 	const tap = (0, react.useContext)(MessagesTapContext);
@@ -8096,12 +8160,9 @@ function CopilotMessages({ children }) {
 			const graphQLErrors = error.graphQLErrors;
 			const routeError = (gqlError) => {
 				const visibility = gqlError.extensions?.visibility;
-				if (!shouldShowDevConsole(showDevConsole)) {
-					console.error("CopilotKit Error (hidden in production):", gqlError.message);
-					return;
-				}
-				if (visibility === _copilotkit_shared.ErrorVisibility.SILENT) {
-					console.error("CopilotKit Silent Error:", gqlError.message);
+				const suppression = getErrorSuppression(visibility, shouldShowDevConsole(showDevConsole));
+				if (suppression) {
+					console.error(suppression, gqlError.message);
 					return;
 				}
 				const ckError = createStructuredError(gqlError);
@@ -8118,8 +8179,7 @@ function CopilotMessages({ children }) {
 				}
 			};
 			graphQLErrors.forEach(routeError);
-		} else if (!shouldShowDevConsole(showDevConsole)) console.error("CopilotKit Error (hidden in production):", error);
-		else {
+		} else {
 			const fallbackError = new _copilotkit_shared.CopilotKitError({
 				message: error?.message || String(error),
 				code: _copilotkit_shared.CopilotKitErrorCode.UNKNOWN
@@ -8993,12 +9053,17 @@ const usePredictStateSubscription = (agent) => {
 		};
 	}, [agent, getSubscriber]);
 };
-function CopilotListeners() {
-	const { copilotkit } = useCopilotKit();
+function CopilotListenersAgentSubscription() {
 	const resolvedAgentId = useCopilotChatConfiguration()?.agentId;
-	const { setBannerError } = useToast();
 	const { agent } = useAgent({ agentId: resolvedAgentId });
 	usePredictStateSubscription(agent);
+	return null;
+}
+function CopilotListeners() {
+	const { copilotkit } = useCopilotKit();
+	const { setBannerError } = useToast();
+	const hasAgents = Object.keys(copilotkit.agents ?? {}).length > 0;
+	const hasRuntime = copilotkit.runtimeUrl !== void 0;
 	(0, react.useEffect)(() => {
 		const subscription = copilotkit.subscribe({ onError: ({ error, code, context }) => {
 			if (error.name === "AbortError" || error.message === "Fetch is aborted" || error.message === "signal is aborted without reason" || error.message === "component unmounted" || !error.message) return;
@@ -9020,7 +9085,7 @@ function CopilotListeners() {
 			subscription.unsubscribe();
 		};
 	}, [copilotkit?.subscribe]);
-	return null;
+	return hasAgents || hasRuntime ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotListenersAgentSubscription, {}) : null;
 }
 
 //#endregion
@@ -9186,7 +9251,7 @@ function CopilotKitInternal(cpkProps) {
 			publicApiKey,
 			...cloud ? { cloud } : {},
 			chatApiEndpoint,
-			headers: props.headers || {},
+			headers: typeof props.headers === "function" ? props.headers() : props.headers || {},
 			properties: props.properties || {},
 			transcribeAudioUrl: props.transcribeAudioUrl,
 			textToSpeechUrl: props.textToSpeechUrl,
@@ -9826,6 +9891,12 @@ Object.defineProperty(exports, 'useAttachments', {
     return useAttachments;
   }
 });
+Object.defineProperty(exports, 'useCapabilities', {
+  enumerable: true,
+  get: function () {
+    return useCapabilities;
+  }
+});
 Object.defineProperty(exports, 'useCoAgentStateRenders', {
   enumerable: true,
   get: function () {
@@ -9946,4 +10017,4 @@ Object.defineProperty(exports, 'useToast', {
     return useToast;
   }
 });
-//# sourceMappingURL=copilotkit-Dgdpbqjt.cjs.map
+//# sourceMappingURL=copilotkit-CSJw5BG8.cjs.map