@copilotkit/react-core 1.55.3 → 1.56.0

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

@@ -3072,7 +3072,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 +3127,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 +3229,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 +3303,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 +3311,8 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, p
 		credentials,
 		properties,
 		mergedAgents,
-		useSingleEndpoint
+		useSingleEndpoint,
+		debug
 	]);
 	const didMountRef = (0, react.useRef)(false);
 	(0, react.useEffect)(() => {
@@ -3619,6 +3623,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 +3658,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 () => {
@@ -4184,6 +4199,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,11 +4868,8 @@ 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 });
@@ -4937,14 +4967,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 +5130,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 +5219,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 +5332,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 +8053,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 +8150,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 +8169,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
@@ -9186,7 +9236,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 +9876,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 +10002,4 @@ Object.defineProperty(exports, 'useToast', {
     return useToast;
   }
 });
-//# sourceMappingURL=copilotkit-Dgdpbqjt.cjs.map
+//# sourceMappingURL=copilotkit-Cvb6WpAX.cjs.map