@copilotkit/react-core 1.55.3 → 1.56.0

package/dist/{copilotkit-Cd-NrDyp.mjs → copilotkit-BebqQrYT.mjs}

@@ -4,7 +4,7 @@ import { CopilotKitCore, CopilotKitCoreRuntimeConnectionStatus, ProxiedCopilotRu
 import { HttpAgent } from "@ag-ui/client";
 import { extendTailwindMerge, twMerge } from "tailwind-merge";
 import { ArrowUp, Check, ChevronDown, ChevronLeft, ChevronRight, ChevronRightIcon, Copy, Edit, Loader2, MessageCircle, Mic, Play, Plus, RefreshCw, Square, ThumbsDown, ThumbsUp, Upload, Volume2, X } from "lucide-react";
-import { A2UI_DEFAULT_DESIGN_GUIDELINES, A2UI_DEFAULT_GENERATION_GUIDELINES, COPILOT_CLOUD_API_URL, COPILOT_CLOUD_CHAT_URL, COPILOT_CLOUD_PUBLIC_API_KEY_HEADER, ConfigurationError, CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitRemoteEndpointDiscoveryError, DEFAULT_AGENT_ID, ErrorVisibility, MissingPublicApiKeyError, Severity, TranscriptionErrorCode, TranscriptionErrorCode as TranscriptionErrorCode$1, createLicenseContextValue, dataToUUID, exceedsMaxSize, formatFileSize, generateVideoThumbnail, getDocumentIcon, getModalityFromMimeType, getSourceUrl, matchesAcceptFilter, parseJson, partialJSONParse, randomId, randomUUID, readFileAsBase64, schemaToJsonSchema } from "@copilotkit/shared";
+import { A2UI_DEFAULT_DESIGN_GUIDELINES, A2UI_DEFAULT_GENERATION_GUIDELINES, COPILOT_CLOUD_API_URL, COPILOT_CLOUD_CHAT_URL, COPILOT_CLOUD_PUBLIC_API_KEY_HEADER, ConfigurationError, CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitRemoteEndpointDiscoveryError, DEFAULT_AGENT_ID, ErrorVisibility, MissingPublicApiKeyError, Severity, TranscriptionErrorCode, TranscriptionErrorCode as TranscriptionErrorCode$1, copyToClipboard, createLicenseContextValue, dataToUUID, exceedsMaxSize, formatFileSize, generateVideoThumbnail, getDocumentIcon, getModalityFromMimeType, getSourceUrl, matchesAcceptFilter, parseJson, partialJSONParse, randomId, randomUUID, readFileAsBase64, schemaToJsonSchema } from "@copilotkit/shared";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { Slot } from "@radix-ui/react-slot";
 import { cva } from "class-variance-authority";
@@ -3042,7 +3042,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] = useState(false);
 	const [runtimeA2UIEnabled, setRuntimeA2UIEnabled] = useState(false);
 	const [runtimeOpenGenUIEnabled, setRuntimeOpenGenUIEnabled] = useState(false);
@@ -3097,6 +3097,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 = useMemo(() => {
 		if (!resolvedPublicKey) return headers;
 		if (headers[HEADER_NAME]) return headers;
@@ -3198,7 +3199,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);
 	}
@@ -3271,6 +3273,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,
@@ -3278,7 +3281,8 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, p
 		credentials,
 		properties,
 		mergedAgents,
-		useSingleEndpoint
+		useSingleEndpoint,
+		debug
 	]);
 	const didMountRef = useRef(false);
 	useEffect(() => {
@@ -3589,6 +3593,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) {
@@ -3613,11 +3628,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 () => {
@@ -4154,6 +4169,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 } = {}) {
@@ -4805,11 +4838,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 copyToClipboard(message.content);
+		return false;
 	} });
 	const boundThumbsUpButton = renderSlot(thumbsUpButton, CopilotChatAssistantMessage.ThumbsUpButton, { onClick: onThumbsUp });
 	const boundThumbsDownButton = renderSlot(thumbsDownButton, CopilotChatAssistantMessage.ThumbsDownButton, { onClick: onThumbsDown });
@@ -4907,14 +4937,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__ */ jsx(ToolbarButton, {
 			"data-testid": "copilot-copy-button",
@@ -5067,11 +5100,8 @@ function CopilotChatUserMessage({ message, onEditMessage, branchIndex, numberOfB
 	const mediaParts = 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 copyToClipboard(flattenedContent);
+		return false;
 	} });
 	const BoundEditButton = renderSlot(editButton, CopilotChatUserMessage.EditButton, { onClick: () => onEditMessage?.({ message }) });
 	const BoundBranchNavigation = renderSlot(branchNavigation, CopilotChatUserMessage.BranchNavigation, {
@@ -5159,10 +5189,13 @@ function CopilotChatUserMessage({ message, onEditMessage, branchIndex, numberOfB
 	_CopilotChatUserMessage.CopyButton = ({ className, title, onClick, ...props }) => {
 		const labels = useCopilotChatConfiguration()?.labels ?? CopilotChatDefaultLabels;
 		const [copied, setCopied] = 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__ */ jsx(ToolbarButton, {
 			"data-testid": "copilot-user-copy-button",
@@ -5269,17 +5302,24 @@ function CopilotChatReasoningMessage({ message, messages, isRunning, header, con
 		return () => clearInterval(timer);
 	}, [isStreaming]);
 	const [isOpen, setIsOpen] = useState(isStreaming);
+	const userToggledRef = useRef(false);
 	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,
@@ -7983,6 +8023,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 === ErrorVisibility.SILENT) return "CopilotKit Silent Error:";
+	if (!isDev && visibility === ErrorVisibility.DEV_ONLY) return "CopilotKit Error (hidden in production):";
+	return null;
+}
 const MessagesTapContext = createContext(null);
 function useMessagesTap() {
 	const tap = useContext(MessagesTapContext);
@@ -8066,12 +8120,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 === 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);
@@ -8088,8 +8139,7 @@ function CopilotMessages({ children }) {
 				}
 			};
 			graphQLErrors.forEach(routeError);
-		} else if (!shouldShowDevConsole(showDevConsole)) console.error("CopilotKit Error (hidden in production):", error);
-		else {
+		} else {
 			const fallbackError = new CopilotKitError({
 				message: error?.message || String(error),
 				code: CopilotKitErrorCode.UNKNOWN
@@ -9156,7 +9206,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,
@@ -9502,5 +9552,5 @@ function validateProps(props) {
 }
 
 //#endregion
-export { useCopilotKit as $, CopilotChatSuggestionView as A, useConfigureSuggestions as B, CopilotChatToggleButton as C, CopilotChatView_default as D, CopilotChat as E, CopilotChatAssistantMessage_default as F, useComponent as G, useHumanInTheLoop as H, CopilotChatToolCallsView as I, useRenderCustomMessages as J, useFrontendTool as K, useAttachments as L, CopilotChatReasoningMessage_default as M, CopilotChatUserMessage_default as N, CopilotChatAttachmentQueue as O, CopilotChatAttachmentRenderer as P, CopilotKitProvider as Q, useThreads$1 as R, CopilotModalHeader as S, DefaultOpenIcon as T, useDefaultRenderTool as U, useSuggestions as V, useRenderTool as W, useAgent as X, UseAgentUpdate as Y, useRenderToolCall as Z, WildcardToolCallRender as _, ThreadsProvider as a, useSandboxFunctions as at, CopilotPopupView as b, CoAgentStateRendersProvider as c, MCPAppsActivityType as ct, shouldShowDevConsole as d, AudioRecorderError as dt, CopilotKitCoreReact as et, useToast as f, CopilotChatAudioRecorder as ft, useCopilotContext as g, CopilotContext as h, ThreadsContext as i, SandboxFunctionsContext as it, CopilotChatSuggestionPill as j, CopilotChatMessageView as k, useCoAgentStateRenders as l, CopilotKitInspector as lt, useCopilotMessagesContext as m, useCopilotChatConfiguration as mt, defaultCopilotContextCategories as n, defineToolCallRenderer as nt, useThreads as o, MCPAppsActivityContentSchema as ot, CopilotMessagesContext as p, CopilotChatConfigurationProvider as pt, useRenderActivityMessage as q, CoAgentStateRenderBridge as r, createA2UIMessageRenderer as rt, CoAgentStateRendersContext as s, MCPAppsActivityRenderer as st, CopilotKit as t, useAgentContext as tt, useAsyncCallback as u, CopilotChatInput_default as ut, CopilotPopup as v, DefaultCloseIcon as w, CopilotSidebarView as x, CopilotSidebar as y, useInterrupt as z };
-//# sourceMappingURL=copilotkit-Cd-NrDyp.mjs.map
+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-BebqQrYT.mjs.map