@copilotkit/react-core 1.70.3 → 1.71.0

package/dist/{copilotkit-Ap_yisA5.mjs → copilotkit-snbJkMqQ.mjs}

@@ -3,8 +3,9 @@ import React, { createContext, createElement, forwardRef, memo, useCallback, use
 import { CopilotKitCore, CopilotKitCoreErrorCode, CopilotKitCoreRuntimeConnectionStatus, ProxiedCopilotRuntimeAgent, ToolCallStatus, emitInspectorActiveThread, emitInspectorViewThreadResult, isInspectorThreadBridgeEnabled, isRunCompletionAware, onInspectorStopViewing, onInspectorViewThread, ɵInterruptState, ɵcreateThreadStore, ɵselectFetchMoreError, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectIsMutating, ɵselectMemories, ɵselectMemoriesAvailable, ɵselectMemoriesError, ɵselectMemoriesIsLoading, ɵselectMemoriesRealtimeStatus, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading } from "@copilotkit/core";
 import { HttpAgent, randomUUID } from "@ag-ui/client";
 import { extendTailwindMerge, twMerge } from "tailwind-merge";
-import { ArrowUp, Check, ChevronDown, ChevronLeft, ChevronRight, ChevronRightIcon, Copy, Edit, Loader2, MessageCircle, Mic, PanelLeftOpen, Play, Plus, RefreshCw, Square, ThumbsDown, ThumbsUp, Upload, Volume2, X } from "lucide-react";
+import { ArrowUp, Check, ChevronDown, ChevronLeft, ChevronRight, ChevronRightIcon, Copy, Edit, EyeOff, Loader2, MessageCircle, Mic, PanelLeftOpen, Play, Plus, RefreshCw, Square, ThumbsDown, ThumbsUp, Upload, Volume2, Wrench, 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, copyToClipboard, createLicenseContextValue, dataToUUID, exceedsMaxSize, formatFileSize, generateVideoThumbnail, getDocumentIcon, getModalityFromMimeType, getSourceUrl, matchesAcceptFilter, parseJson, partialJSONParse, randomId, randomUUID as randomUUID$1, readFileAsBase64, schemaToJsonSchema, shouldEnableInspector } from "@copilotkit/shared";
+import { CopilotKitAgentIdContext, CopilotKitContext, LicenseContext, useCopilotKit, useCopilotKit as useCopilotKit$1, useDefaultAgentId, useLicenseContext, useLicenseContext as useLicenseContext$1 } from "@copilotkit/react-core/v2/context";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { Slot } from "@radix-ui/react-slot";
 import { cva } from "class-variance-authority";
@@ -12,7 +13,6 @@ import { clsx } from "clsx";
 import * as TooltipPrimitive from "@radix-ui/react-tooltip";
 import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
 import { Streamdown } from "streamdown";
-import { CopilotKitContext, LicenseContext, useCopilotKit, useCopilotKit as useCopilotKit$1, useLicenseContext, useLicenseContext as useLicenseContext$1 } from "@copilotkit/react-core/v2/context";
 import { z } from "zod";
 import { A2UIProvider, A2UIRenderer, A2UI_SCHEMA_CONTEXT_DESCRIPTION, Catalog, DEFAULT_SURFACE_ID, ROOT_COMPONENT_ID, buildCatalogContextValue, extractCatalogComponentSchemas, filterCatalog, initializeDefaultCatalog, injectStyles, useA2UIActions, useA2UIError, viewerTheme } from "@copilotkit/a2ui-renderer";
 import { zodToJsonSchema } from "zod-to-json-schema";
@@ -76,7 +76,12 @@ const CopilotChatDefaultLabels = {
 	assistantMessageToolbarCopyCodeCopiedLabel: "Copied",
 	assistantMessageToolbarCopyMessageLabel: "Copy",
 	assistantMessageToolbarInspectorLabel: "View in Inspector",
-	assistantMessageToolbarInspectorLocalOnlyLabel: "Development Only",
+	assistantMessageToolbarInspectorDescription: "Open this message in the Inspector",
+	assistantMessageToolbarInspectorLocalOnlyLabel: "Local only",
+	assistantMessageToolbarInspectorLocalOnlyDescription: "Only visible on localhost or loopback hosts in development. Never shown in production.",
+	assistantMessageToolbarInspectorTitle: "CopilotKit Inspector",
+	assistantMessageToolbarInspectorHideLabel: "Hide this icon",
+	assistantMessageToolbarInspectorHideDescription: "Until you reload this page",
 	assistantMessageToolbarThumbsUpLabel: "Good response",
 	assistantMessageToolbarThumbsDownLabel: "Bad response",
 	assistantMessageToolbarReadAloudLabel: "Read aloud",
@@ -117,7 +122,8 @@ const CopilotChatConfigurationProvider = ({ children, labels, agentId, threadId,
 		...parentConfig?.labels,
 		...stableLabels
 	}), [stableLabels, parentConfig?.labels]);
-	const resolvedAgentId = agentId ?? parentConfig?.agentId ?? DEFAULT_AGENT_ID;
+	const providerAgentId = useDefaultAgentId();
+	const resolvedAgentId = agentId ?? parentConfig?.agentId ?? providerAgentId ?? DEFAULT_AGENT_ID;
 	const threadIdPropIsAuthoritative = threadId !== void 0 && hasExplicitThreadId !== false;
 	const isThreadIdControlled = threadIdPropIsAuthoritative;
 	const [activeThreadOverride, setActiveThreadOverride] = useState(null);
@@ -474,6 +480,14 @@ function DropdownMenuItem({ className, inset, variant = "default", ...props }) {
 		...props
 	});
 }
+function DropdownMenuLabel({ className, inset, ...props }) {
+	return /* @__PURE__ */ jsx(DropdownMenuPrimitive.Label, {
+		"data-slot": "dropdown-menu-label",
+		"data-inset": inset,
+		className: cn("cpk:px-2 cpk:py-1.5 cpk:text-sm cpk:font-medium cpk:data-[inset]:pl-8", className),
+		...props
+	});
+}
 function DropdownMenuSeparator({ className, ...props }) {
 	return /* @__PURE__ */ jsx(DropdownMenuPrimitive.Separator, {
 		"data-slot": "dropdown-menu-separator",
@@ -1590,21 +1604,28 @@ function useRenderToolCall() {
 
 //#endregion
 //#region src/v2/components/CopilotKitInspector.tsx
-const CopilotKitInspector = ({ core, openRequest }) => {
+const CopilotKitInspector = ({ core, openRequest, onVisibilityChange }) => {
 	const mountRef = React$1.useRef(null);
 	const inspectorRef = React$1.useRef(null);
 	const latestCoreRef = React$1.useRef(core ?? null);
 	const latestOpenRequestRef = React$1.useRef(openRequest);
+	const visibilityCallbackRef = React$1.useRef(onVisibilityChange);
+	visibilityCallbackRef.current = onVisibilityChange;
 	latestCoreRef.current = core ?? null;
 	latestOpenRequestRef.current = openRequest;
 	React$1.useEffect(() => {
 		let mounted = true;
 		let inspector = null;
+		const handleVisibilityChange = (event) => {
+			const visible = event.detail?.visible;
+			visibilityCallbackRef.current?.(visible === true);
+		};
 		import("@copilotkit/web-inspector").then((mod) => {
 			if (!mounted || !mountRef.current) return;
 			mod.defineWebInspector?.();
 			inspector = mountRef.current.ownerDocument.createElement(mod.WEB_INSPECTOR_TAG);
 			mod.configureWebInspectorElement(inspector, latestCoreRef.current);
+			inspector.addEventListener("cpk-inspector-visibility-change", handleVisibilityChange);
 			mountRef.current.appendChild(inspector);
 			inspectorRef.current = inspector;
 			const request = latestOpenRequestRef.current;
@@ -1614,7 +1635,9 @@ const CopilotKitInspector = ({ core, openRequest }) => {
 		});
 		return () => {
 			mounted = false;
+			inspector?.removeEventListener("cpk-inspector-visibility-change", handleVisibilityChange);
 			inspector?.remove();
+			visibilityCallbackRef.current?.(false);
 			if (inspectorRef.current === inspector) inspectorRef.current = null;
 		};
 	}, []);
@@ -3643,14 +3666,19 @@ function useStableArrayProp(prop, warningMessage, isMeaningfulChange) {
 	}, [value, warningMessage]);
 	return value;
 }
-const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY_HEADERS, credentials, publicApiKey, publicLicenseKey, licenseToken, properties = EMPTY_PROPERTIES, agents__unsafe_dev_only: agents = EMPTY_AGENTS, selfManagedAgents = EMPTY_AGENTS, renderToolCalls, renderActivityMessages, renderCustomMessages, frontendTools, humanInTheLoop, openGenerativeUI, enableInspector, useSingleEndpoint, onError, a2ui, defaultThrottleMs, debug }) => {
+const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY_HEADERS, credentials, publicApiKey, publicLicenseKey, licenseToken, properties = EMPTY_PROPERTIES, agents__unsafe_dev_only: agents = EMPTY_AGENTS, selfManagedAgents = EMPTY_AGENTS, renderToolCalls, renderActivityMessages, renderCustomMessages, frontendTools, humanInTheLoop, openGenerativeUI, enableInspector, agentId, useSingleEndpoint, onError, a2ui, defaultThrottleMs, debug }) => {
 	const [shouldRenderInspector, setShouldRenderInspector] = useState(false);
+	const [inspectorVisible, setInspectorVisible] = useState(false);
 	useEffect(() => {
 		setShouldRenderInspector(shouldEnableInspector({
 			enableInspector,
 			isBrowser: true,
 			isDevelopment: process.env.NODE_ENV === "development"
-		}));
+		}) && [
+			"localhost",
+			"127.0.0.1",
+			"[::1]"
+		].includes(window.location.hostname));
 	}, [enableInspector]);
 	const [inspectorOpenRequest, setInspectorOpenRequest] = useState(null);
 	const [runtimeA2UIEnabled, setRuntimeA2UIEnabled] = useState(false);
@@ -3666,9 +3694,15 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 		setInspectorOpenRequest({ ...request });
 	}, []);
 	const inspectorContextValue = useMemo(() => ({
-		isInspectorEnabled: shouldRenderInspector,
+		providerEnableInspector: enableInspector,
+		isInspectorEnabled: shouldRenderInspector && inspectorVisible,
 		openInspector: requestInspectorOpen
-	}), [shouldRenderInspector, requestInspectorOpen]);
+	}), [
+		enableInspector,
+		shouldRenderInspector,
+		inspectorVisible,
+		requestInspectorOpen
+	]);
 	const renderToolCallsList = useStableArrayProp(renderToolCalls, "renderToolCalls must be a stable array. If you want to dynamically add or remove tools, use `useFrontendTool` instead.", (initial, next) => {
 		const key = (rc) => `${rc?.agentId ?? ""}:${rc?.name ?? ""}`;
 		const setFrom = (arr) => new Set(arr.map(key));
@@ -4065,9 +4099,13 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 					}),
 					/* @__PURE__ */ jsxs(CopilotKitInspectorContextProvider, {
 						value: inspectorContextValue,
-						children: [children, shouldRenderInspector ? /* @__PURE__ */ jsx(CopilotKitInspector, {
+						children: [/* @__PURE__ */ jsx(CopilotKitAgentIdContext.Provider, {
+							value: agentId,
+							children
+						}), shouldRenderInspector ? /* @__PURE__ */ jsx(CopilotKitInspector, {
 							core: copilotkit,
-							openRequest: inspectorOpenRequest
+							openRequest: inspectorOpenRequest,
+							onVisibilityChange: setInspectorVisible
 						}) : null]
 					}),
 					runtimeLicenseWarningStatus === "none" && !resolvedPublicKey && /* @__PURE__ */ jsx(LicenseWarningBanner, { type: "no_license" }),
@@ -4649,7 +4687,8 @@ function useAgent({ agentId, threadId, runtimeAgentId, updates, throttleMs } = {
 	if (runtimeAgentId != null && threadId == null) throw new Error(`useAgent: \`runtimeAgentId\` requires \`threadId\`. A proxied agent exists to scope a thread to a private instance; without a threadId it behaves like the shared agent while adding a registration and a local agentId to keep unique. Either pass the thread, e.g. useAgent({ agentId: "${agentId ?? "chat-1"}", runtimeAgentId: "${runtimeAgentId}", threadId }), or bind to the agent directly with useAgent({ agentId: "${runtimeAgentId}" }).`);
 	if (runtimeAgentId != null && agentId == null) throw new Error(`useAgent: \`runtimeAgentId\` requires an explicit \`agentId\`. The proxied agent is registered under \`agentId\`, and the usual fallbacks (chat configuration, then "${DEFAULT_AGENT_ID}") name agents that already exist — registering over one throws or shadows it. Pick a local id for this hook, e.g. useAgent({ agentId: "chat-1", runtimeAgentId: "${runtimeAgentId}", threadId }).`);
 	const chatConfig = useCopilotChatConfiguration();
-	const resolvedAgentId = agentId ?? chatConfig?.agentId ?? DEFAULT_AGENT_ID;
+	const providerAgentId = useDefaultAgentId();
+	const resolvedAgentId = agentId ?? chatConfig?.agentId ?? providerAgentId ?? DEFAULT_AGENT_ID;
 	const { copilotkit } = useCopilotKit();
 	const providerThrottleMs = copilotkit.defaultThrottleMs;
 	const [, forceUpdate] = useReducer((x) => x + 1, 0);
@@ -4877,7 +4916,12 @@ function useAgentContext(context) {
 function useSuggestions({ agentId } = {}) {
 	const { copilotkit } = useCopilotKit();
 	const config = useCopilotChatConfiguration();
-	const resolvedAgentId = useMemo(() => agentId ?? config?.agentId ?? DEFAULT_AGENT_ID, [agentId, config?.agentId]);
+	const providerAgentId = useDefaultAgentId();
+	const resolvedAgentId = useMemo(() => agentId ?? config?.agentId ?? providerAgentId ?? DEFAULT_AGENT_ID, [
+		agentId,
+		config?.agentId,
+		providerAgentId
+	]);
 	const [suggestions, setSuggestions] = useState(() => {
 		return copilotkit.getSuggestions(resolvedAgentId).suggestions;
 	});
@@ -6181,6 +6225,289 @@ function CopilotChatToolCallsView({ message, messages = [] }) {
 	}) });
 }
 
+//#endregion
+//#region src/v2/components/chat/CopilotChatInspectorButton.tsx
+let shortcutsHidden = false;
+const listeners = /* @__PURE__ */ new Set();
+const subscribe = (listener) => {
+	listeners.add(listener);
+	return () => {
+		listeners.delete(listener);
+	};
+};
+const getSnapshot = () => shortcutsHidden;
+const getServerSnapshot = () => false;
+function useInspectorShortcutsHidden() {
+	return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+function hideShortcuts() {
+	shortcutsHidden = true;
+	listeners.forEach((listener) => listener());
+}
+function InspectorKiteIcon({ className, ...props }) {
+	const id = useId();
+	return /* @__PURE__ */ jsxs("svg", {
+		...props,
+		"aria-hidden": "true",
+		className: twMerge("cpk:size-4", className),
+		viewBox: "4.57 3.36 17.8 17.8",
+		fill: "none",
+		children: [
+			/* @__PURE__ */ jsx("path", {
+				d: "M6.36084 10.9855C8.34277 8.393 9.98843 5.82939 10.6204 3.75914C10.6382 3.70281 10.7043 3.67888 10.7534 3.7114C12.9536 5.16894 16.9635 6.12833 20.5086 6.15085C20.5703 6.15124 20.6124 6.2114 20.5895 6.26829C19.4109 9.25938 17.9705 14.6189 17.9148 20.7392C17.9148 20.8301 17.7873 20.8627 17.7419 20.7837C15.7236 17.2522 9.26021 12.2898 6.39414 11.1186C6.34112 11.0968 6.32556 11.0313 6.36084 10.9855Z",
+				fill: `url(#${id}-paint0_linear)`
+			}),
+			/* @__PURE__ */ jsx("path", {
+				d: "M13.0475 9.39974C9.95016 10.3806 7.11935 10.9259 6.44331 11.0498C6.40027 11.0577 6.39115 11.1172 6.43152 11.134C9.3203 12.3347 15.7516 17.2826 17.7511 20.7998C17.7551 20.8075 17.7647 20.8103 17.7728 20.8068C17.7809 20.803 17.7853 20.793 17.7819 20.7844L13.0475 9.39974Z",
+				fill: `url(#${id}-paint1_linear)`
+			}),
+			/* @__PURE__ */ jsx("path", {
+				d: "M10.762 3.705C13.4137 5.15161 16.4787 5.80132 20.545 6.14367C20.5703 6.14585 20.5787 6.18008 20.5557 6.19197C20.0359 6.45923 17.0574 7.97512 14.8455 8.78701C14.2524 9.00453 13.6564 9.20632 13.0692 9.39249C13.0562 9.39656 13.0419 9.39015 13.0369 9.37774L10.7005 3.75979C10.6849 3.72196 10.7257 3.68538 10.762 3.705Z",
+				fill: `url(#${id}-paint2_linear)`
+			}),
+			/* @__PURE__ */ jsx("path", {
+				d: "M10.7145 3.79041L17.8305 20.7659",
+				stroke: "#513C9F",
+				strokeWidth: "0.17284",
+				strokeLinecap: "round"
+			}),
+			/* @__PURE__ */ jsx("path", {
+				d: "M6.44531 11.0476C6.44531 11.0476 10.375 10.3422 14.0686 9.06804C17.7623 7.7939 20.5122 6.23373 20.5122 6.23373",
+				stroke: "#513C9F",
+				strokeWidth: "0.17284",
+				strokeLinecap: "round"
+			}),
+			/* @__PURE__ */ jsx("path", {
+				d: "M11.6914 5.93518L9.05534 14.7068M9.05534 14.7068H15.3203M9.05534 14.7068L0.15625 26.3646",
+				stroke: "#ABABAB",
+				strokeWidth: "0.302474",
+				strokeLinecap: "round"
+			}),
+			/* @__PURE__ */ jsx("path", {
+				d: "M6.02539 23.9646L4.85806 24.1287C5.46272 25.7287 6.70381 26.4276 8.18528 26.4276C11.8147 26.4276 10.707 22.3227 12.8103 22.3227C14.3358 22.3227 13.7155 25.6498 16.9992 25.6498C19.0029 25.6498 19.2028 23.631 18.8607 22.7625C18.8589 22.7572 18.8568 22.7524 18.8538 22.7476L18.3166 21.9253C18.2817 21.8706 18.1968 21.8912 18.1907 21.9562L18.0908 22.9529C18.0838 23.0222 18.0857 23.0913 18.0936 23.1605C18.1764 23.8491 18.2291 25.5202 16.9992 25.5202C15.7015 25.5202 15.3895 22.2362 12.8103 22.2362C9.78393 22.2362 10.1726 26.298 8.31487 26.298C7.08938 26.298 6.15447 24.9153 6.02539 23.9646Z",
+				fill: `url(#${id}-paint3_linear)`
+			}),
+			/* @__PURE__ */ jsxs("defs", { children: [
+				/* @__PURE__ */ jsxs("linearGradient", {
+					id: `${id}-paint0_linear`,
+					x1: "15.5372",
+					y1: "5.0278",
+					x2: "12.0802",
+					y2: "14.534",
+					gradientUnits: "userSpaceOnUse",
+					children: [/* @__PURE__ */ jsx("stop", { stopColor: "#6430AB" }), /* @__PURE__ */ jsx("stop", {
+						offset: "1",
+						stopColor: "#AA89D8"
+					})]
+				}),
+				/* @__PURE__ */ jsxs("linearGradient", {
+					id: `${id}-paint1_linear`,
+					x1: "12.8583",
+					y1: "10.3858",
+					x2: "8.40764",
+					y2: "18.9846",
+					gradientUnits: "userSpaceOnUse",
+					children: [/* @__PURE__ */ jsx("stop", { stopColor: "#005DBB" }), /* @__PURE__ */ jsx("stop", {
+						offset: "1",
+						stopColor: "#3D92E8"
+					})]
+				}),
+				/* @__PURE__ */ jsxs("linearGradient", {
+					id: `${id}-paint2_linear`,
+					x1: "14.8452",
+					y1: "5.02774",
+					x2: "13.5047",
+					y2: "9.21911",
+					gradientUnits: "userSpaceOnUse",
+					children: [/* @__PURE__ */ jsx("stop", { stopColor: "#1B70C4" }), /* @__PURE__ */ jsx("stop", {
+						offset: "1",
+						stopColor: "#54A4F2"
+					})]
+				}),
+				/* @__PURE__ */ jsxs("linearGradient", {
+					id: `${id}-paint3_linear`,
+					x1: "4.85806",
+					y1: "24.2455",
+					x2: "18.9963",
+					y2: "24.2455",
+					gradientUnits: "userSpaceOnUse",
+					children: [
+						/* @__PURE__ */ jsx("stop", { stopColor: "#4497EA" }),
+						/* @__PURE__ */ jsx("stop", {
+							offset: "0.254755",
+							stopColor: "#1463B2"
+						}),
+						/* @__PURE__ */ jsx("stop", {
+							offset: "0.498725",
+							stopColor: "#0A437D"
+						}),
+						/* @__PURE__ */ jsx("stop", {
+							offset: "0.666667",
+							stopColor: "#2476C8"
+						}),
+						/* @__PURE__ */ jsx("stop", {
+							offset: "0.972542",
+							stopColor: "#0C549A"
+						})
+					]
+				})
+			] })
+		]
+	});
+}
+function CopilotChatInspectorButton({ title, className, onClick, onPointerDown, onPointerEnter, onPointerLeave, onKeyDown, disabled, ...props }) {
+	const labels = useCopilotChatConfiguration()?.labels ?? CopilotChatDefaultLabels;
+	const { isInspectorEnabled } = useCopilotKitInspector();
+	const hidden = useInspectorShortcutsHidden();
+	const [open, setOpen] = useState(false);
+	const [dark, setDark] = useState(false);
+	const trigger = useRef(null);
+	const closeTimer = useRef(null);
+	const openedByHover = useRef(false);
+	const primaryLabel = title || labels.assistantMessageToolbarInspectorLabel;
+	const cancelClose = () => {
+		if (closeTimer.current !== null) clearTimeout(closeTimer.current);
+		closeTimer.current = null;
+	};
+	useEffect(() => cancelClose, []);
+	const changeOpen = (next) => {
+		cancelClose();
+		if (next) setDark(!!trigger.current?.closest(".dark"));
+		setOpen(next);
+	};
+	const scheduleClose = () => {
+		cancelClose();
+		closeTimer.current = setTimeout(() => {
+			if (openedByHover.current) setOpen(false);
+		}, 180);
+	};
+	if (!isInspectorEnabled || hidden) return null;
+	return /* @__PURE__ */ jsxs(DropdownMenu, {
+		open,
+		onOpenChange: changeOpen,
+		modal: false,
+		children: [/* @__PURE__ */ jsx(DropdownMenuTrigger, {
+			asChild: true,
+			children: /* @__PURE__ */ jsx(Button, {
+				...props,
+				ref: trigger,
+				type: "button",
+				disabled,
+				variant: "assistantMessageToolbarButton",
+				size: "icon",
+				"data-testid": "copilot-inspector-button",
+				"aria-label": `${labels.assistantMessageToolbarInspectorTitle} (${labels.assistantMessageToolbarInspectorLocalOnlyLabel.toLowerCase()})`,
+				className: twMerge("cpk:size-8 cpk:p-1.5", className),
+				onPointerEnter: (event) => {
+					onPointerEnter?.(event);
+					if (!disabled && event.pointerType !== "touch") {
+						openedByHover.current = true;
+						changeOpen(true);
+					}
+				},
+				onPointerLeave: (event) => {
+					onPointerLeave?.(event);
+					scheduleClose();
+				},
+				onPointerDown: (event) => {
+					onPointerDown?.(event);
+					event.preventDefault();
+				},
+				onClick: (event) => {
+					changeOpen(false);
+					onClick?.(event);
+				},
+				onKeyDown: (event) => {
+					openedByHover.current = false;
+					onKeyDown?.(event);
+					if (!event.defaultPrevented && (event.key === "Enter" || event.key === " ")) {
+						event.preventDefault();
+						event.currentTarget.click();
+					}
+				},
+				children: /* @__PURE__ */ jsx(Wrench, {
+					"aria-hidden": "true",
+					className: "cpk:size-4",
+					"data-testid": "copilot-inspector-icon"
+				})
+			})
+		}), /* @__PURE__ */ jsxs(DropdownMenuContent, {
+			align: "start",
+			side: "top",
+			sideOffset: 6,
+			className: twMerge("cpk:w-64 cpk:p-1 cpk:text-sm", dark && "dark"),
+			onPointerEnter: cancelClose,
+			onPointerLeave: scheduleClose,
+			onKeyDown: () => {
+				openedByHover.current = false;
+			},
+			onOpenAutoFocus: (event) => {
+				if (openedByHover.current) event.preventDefault();
+			},
+			onCloseAutoFocus: (event) => {
+				if (openedByHover.current) event.preventDefault();
+			},
+			onFocusOutside: () => changeOpen(false),
+			children: [
+				/* @__PURE__ */ jsxs(DropdownMenuLabel, {
+					className: "cpk:flex cpk:items-center cpk:justify-between cpk:gap-3 cpk:px-2 cpk:py-2",
+					children: [/* @__PURE__ */ jsx("span", {
+						className: "cpk:text-xs cpk:font-medium",
+						children: labels.assistantMessageToolbarInspectorTitle
+					}), /* @__PURE__ */ jsxs(Tooltip, {
+						delayDuration: 1e3,
+						children: [/* @__PURE__ */ jsx(TooltipTrigger, {
+							asChild: true,
+							children: /* @__PURE__ */ jsx("span", {
+								tabIndex: 0,
+								className: "cpk:cursor-help cpk:rounded cpk:bg-muted cpk:px-1.5 cpk:py-0.5 cpk:text-[10px] cpk:font-normal cpk:text-muted-foreground",
+								children: labels.assistantMessageToolbarInspectorLocalOnlyLabel
+							})
+						}), /* @__PURE__ */ jsx(TooltipContent, {
+							side: "top",
+							sideOffset: 6,
+							className: twMerge("cpk:max-w-48 cpk:text-wrap", dark && "dark"),
+							onPointerEnter: cancelClose,
+							onPointerLeave: scheduleClose,
+							children: labels.assistantMessageToolbarInspectorLocalOnlyDescription
+						})]
+					})]
+				}),
+				/* @__PURE__ */ jsx(DropdownMenuSeparator, {}),
+				/* @__PURE__ */ jsx(DropdownMenuItem, {
+					asChild: true,
+					children: /* @__PURE__ */ jsxs("button", {
+						type: "button",
+						onClick,
+						className: "cpk:w-full cpk:cursor-pointer cpk:items-start cpk:text-left",
+						children: [/* @__PURE__ */ jsx(InspectorKiteIcon, { className: "cpk:mt-0.5" }), /* @__PURE__ */ jsxs("span", { children: [/* @__PURE__ */ jsx("span", {
+							className: "cpk:block",
+							children: primaryLabel
+						}), /* @__PURE__ */ jsx("span", {
+							className: "cpk:block cpk:text-xs cpk:text-muted-foreground",
+							children: labels.assistantMessageToolbarInspectorDescription
+						})] })]
+					})
+				}),
+				/* @__PURE__ */ jsxs(DropdownMenuItem, {
+					onSelect: hideShortcuts,
+					className: "cpk:cursor-pointer cpk:items-start",
+					children: [/* @__PURE__ */ jsx(EyeOff, {
+						"aria-hidden": "true",
+						className: "cpk:mt-0.5"
+					}), /* @__PURE__ */ jsxs("span", { children: [/* @__PURE__ */ jsx("span", {
+						className: "cpk:block",
+						children: labels.assistantMessageToolbarInspectorHideLabel
+					}), /* @__PURE__ */ jsx("span", {
+						className: "cpk:block cpk:text-xs cpk:text-muted-foreground",
+						children: labels.assistantMessageToolbarInspectorHideDescription
+					})] })]
+				})
+			]
+		})]
+	});
+}
+
 //#endregion
 //#region src/v2/components/chat/CopilotChatAssistantMessage.tsx
 /**
@@ -6201,30 +6528,32 @@ function BoundInspectorButton({ inspectorButton, messageId, openInspector, ...pr
 function CopilotChatAssistantMessage({ message, messages, isRunning, onThumbsUp, onThumbsDown, onReadAloud, onRegenerate, additionalToolbarItems, toolbarVisible = true, markdownRenderer, toolbar, copyButton, inspectorButton, thumbsUpButton, thumbsDownButton, readAloudButton, regenerateButton, toolCallsView, children, className, ...props }) {
 	useKatexStyles();
 	const { isInspectorEnabled, openInspector } = useCopilotKitInspector();
+	const shortcutsHidden = useInspectorShortcutsHidden();
+	const showInspectorShortcut = isInspectorEnabled && !shortcutsHidden;
 	const boundMarkdownRenderer = renderSlot(markdownRenderer, CopilotChatAssistantMessage.MarkdownRenderer, { content: message.content || "" });
 	const boundCopyButton = renderSlot(copyButton, CopilotChatAssistantMessage.CopyButton, { onClick: async () => {
 		if (message.content) return await copyToClipboard(message.content);
 		return false;
 	} });
 	const boundThumbsUpButton = renderSlot(thumbsUpButton, CopilotChatAssistantMessage.ThumbsUpButton, { onClick: onThumbsUp ? () => onThumbsUp(message) : void 0 });
-	const boundInspectorButton = /* @__PURE__ */ jsx(BoundInspectorButton, {
+	const boundInspectorButton = showInspectorShortcut ? /* @__PURE__ */ jsx(BoundInspectorButton, {
 		inspectorButton,
 		messageId: message.id,
 		openInspector
-	});
+	}) : /* @__PURE__ */ jsx(Fragment$1, {});
 	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__ */ jsxs("div", {
-		className: "cpk:flex cpk:items-center cpk:gap-1",
+		className: "cpk:flex cpk:w-full cpk:items-center cpk:gap-1",
 		children: [
 			boundCopyButton,
-			isInspectorEnabled && boundInspectorButton,
 			(onThumbsUp || thumbsUpButton) && boundThumbsUpButton,
 			(onThumbsDown || thumbsDownButton) && boundThumbsDownButton,
 			(onReadAloud || readAloudButton) && boundReadAloudButton,
 			(onRegenerate || regenerateButton) && boundRegenerateButton,
-			additionalToolbarItems
+			additionalToolbarItems,
+			showInspectorShortcut && boundInspectorButton
 		]
 	}) });
 	const boundToolCallsView = renderSlot(toolCallsView, CopilotChatToolCallsView, {
@@ -6233,7 +6562,7 @@ function CopilotChatAssistantMessage({ message, messages, isRunning, onThumbsUp,
 	});
 	const hasContent = !!(message.content && message.content.trim().length > 0);
 	const isLatestAssistantMessage = message.role === "assistant" && messages?.[messages.length - 1]?.id === message.id;
-	const shouldShowToolbar = toolbarVisible && (hasContent || isInspectorEnabled) && !(isRunning && isLatestAssistantMessage);
+	const shouldShowToolbar = toolbarVisible && (hasContent || showInspectorShortcut) && !(isRunning && isLatestAssistantMessage);
 	if (children) return /* @__PURE__ */ jsx("div", {
 		"data-copilotkit": true,
 		style: { display: "contents" },
@@ -6274,110 +6603,6 @@ function CopilotChatAssistantMessage({ message, messages, isRunning, onThumbsUp,
 		]
 	});
 }
-function CopilotKitColoredIcon() {
-	const gradientId = useId().replace(/:/g, "");
-	return /* @__PURE__ */ jsxs("svg", {
-		"aria-hidden": "true",
-		className: "cpk:size-5",
-		"data-testid": "copilot-inspector-icon",
-		viewBox: "0 0 24 24",
-		children: [
-			/* @__PURE__ */ jsx("path", {
-				d: "M8.162 7.758c2.093-2.738 3.831-5.445 4.498-7.63a.093.093 0 01.14-.051c2.324 1.539 6.558 2.552 10.301 2.576a.09.09 0 01.085.124c-1.243 3.158-2.765 8.817-2.823 15.28-.001.095-.135.13-.183.046-2.131-3.729-8.955-8.968-11.982-10.205a.09.09 0 01-.036-.14z",
-				fill: `url(#${gradientId}-purple)`
-			}),
-			/* @__PURE__ */ jsx("path", {
-				d: "M15.223 6.083A61.492 61.492 0 018.25 7.827c-.045.008-.055.071-.012.089 3.05 1.267 9.84 6.492 11.952 10.206a.017.017 0 00.022.007.018.018 0 00.01-.024l-4.999-12.02z",
-				fill: `url(#${gradientId}-blue)`
-			}),
-			/* @__PURE__ */ jsx("path", {
-				d: "M12.81.07c2.8 1.528 6.037 2.214 10.33 2.575.028.002.036.039.012.051-.55.282-3.695 1.883-6.03 2.74-.626.23-1.256.443-1.876.64a.028.028 0 01-.033-.016L12.746.128c-.017-.04.027-.078.065-.058z",
-				fill: `url(#${gradientId}-light-blue)`
-			}),
-			/* @__PURE__ */ jsx("path", {
-				className: "cpk:fill-[#513C9F] cpk:dark:fill-[#B99AE8]",
-				d: "M12.725.075c.046-.019.1.003.119.05l7.514 17.923a.091.091 0 01-.148.1l-.02-.03L12.675.195a.091.091 0 01.049-.12z"
-			}),
-			/* @__PURE__ */ jsx("path", {
-				className: "cpk:fill-[#513C9F] cpk:dark:fill-[#B99AE8]",
-				d: "M23.06 2.66c.044-.025.1-.01.125.034.025.044.009.1-.035.124v.001l-.008.004-.025.015-.1.054a41.384 41.384 0 01-1.811.92A47.05 47.05 0 0116.33 5.82c-1.954.674-3.97 1.197-5.497 1.552a66.27 66.27 0 01-2.38.507l-.138.026-.036.007h-.01l-.002.002a.091.091 0 11-.033-.18l.016.09-.015-.09h.002l.01-.002.035-.007.137-.025a66.16 66.16 0 002.373-.506c1.524-.354 3.533-.876 5.479-1.547a46.857 46.857 0 006.276-2.709c.166-.087.295-.156.381-.204l.099-.054.024-.014.008-.004z"
-			}),
-			/* @__PURE__ */ jsx("path", {
-				className: "cpk:fill-[#ABABAB] cpk:dark:fill-[#D4D4D4]",
-				d: "M13.838 2.272a.16.16 0 01.107.2l-2.72 9.055h6.4l.061.013a.16.16 0 010 .295l-.061.013h-6.541L.679 24.099l-.05.04a.16.16 0 01-.194-.245l10.43-12.285 2.773-9.23a.16.16 0 01.2-.107z"
-			}),
-			/* @__PURE__ */ jsx("path", {
-				d: "M7.809 21.461l-1.232.173c.638 1.69 1.949 2.427 3.514 2.427 3.831 0 2.661-4.334 4.883-4.334 1.61 0 .956 3.513 4.423 3.513 2.116 0 2.326-2.131 1.966-3.048l-.008-.016-.567-.868c-.037-.058-.127-.036-.133.032l-.106 1.053a1.01 1.01 0 00.003.219c.088.727.144 2.491-1.155 2.491-1.37 0-1.7-3.467-4.423-3.467-3.196 0-2.785 4.289-4.747 4.289-1.294 0-2.28-1.46-2.418-2.464z",
-				fill: `url(#${gradientId}-tail)`
-			}),
-			/* @__PURE__ */ jsxs("defs", { children: [
-				/* @__PURE__ */ jsxs("linearGradient", {
-					gradientUnits: "userSpaceOnUse",
-					id: `${gradientId}-purple`,
-					x1: "17.852",
-					x2: "14.202",
-					y1: "1.467",
-					y2: "11.504",
-					children: [/* @__PURE__ */ jsx("stop", { className: "cpk:[stop-color:#6430AB] cpk:dark:[stop-color:#B792F0]" }), /* @__PURE__ */ jsx("stop", {
-						className: "cpk:[stop-color:#AA89D8] cpk:dark:[stop-color:#D3BDF7]",
-						offset: "1"
-					})]
-				}),
-				/* @__PURE__ */ jsxs("linearGradient", {
-					gradientUnits: "userSpaceOnUse",
-					id: `${gradientId}-blue`,
-					x1: "15.024",
-					x2: "10.324",
-					y1: "7.125",
-					y2: "16.204",
-					children: [/* @__PURE__ */ jsx("stop", { className: "cpk:[stop-color:#005DBB] cpk:dark:[stop-color:#4D9FEF]" }), /* @__PURE__ */ jsx("stop", {
-						className: "cpk:[stop-color:#3D92E8] cpk:dark:[stop-color:#84C0FA]",
-						offset: "1"
-					})]
-				}),
-				/* @__PURE__ */ jsxs("linearGradient", {
-					gradientUnits: "userSpaceOnUse",
-					id: `${gradientId}-light-blue`,
-					x1: "17.122",
-					x2: "15.707",
-					y1: "1.467",
-					y2: "5.892",
-					children: [/* @__PURE__ */ jsx("stop", { className: "cpk:[stop-color:#1B70C4] cpk:dark:[stop-color:#61ACF2]" }), /* @__PURE__ */ jsx("stop", {
-						className: "cpk:[stop-color:#54A4F2] cpk:dark:[stop-color:#9ACDFF]",
-						offset: "1"
-					})]
-				}),
-				/* @__PURE__ */ jsxs("linearGradient", {
-					gradientUnits: "userSpaceOnUse",
-					id: `${gradientId}-tail`,
-					x1: "6.577",
-					x2: "21.506",
-					y1: "21.758",
-					y2: "21.758",
-					children: [
-						/* @__PURE__ */ jsx("stop", { className: "cpk:[stop-color:#4497EA] cpk:dark:[stop-color:#79BCF5]" }),
-						/* @__PURE__ */ jsx("stop", {
-							className: "cpk:[stop-color:#1463B2] cpk:dark:[stop-color:#4594D8]",
-							offset: ".255"
-						}),
-						/* @__PURE__ */ jsx("stop", {
-							className: "cpk:[stop-color:#0A437D] cpk:dark:[stop-color:#347CB7]",
-							offset: ".499"
-						}),
-						/* @__PURE__ */ jsx("stop", {
-							className: "cpk:[stop-color:#2476C8] cpk:dark:[stop-color:#58A4E5]",
-							offset: ".667"
-						}),
-						/* @__PURE__ */ jsx("stop", {
-							className: "cpk:[stop-color:#0C549A] cpk:dark:[stop-color:#3C87C7]",
-							offset: ".973"
-						})
-					]
-				})
-			] })
-		]
-	});
-}
 (function(_CopilotChatAssistantMessage) {
 	_CopilotChatAssistantMessage.MarkdownRenderer = ({ content, className, ...props }) => /* @__PURE__ */ jsx(Streamdown, {
 		className,
@@ -6435,30 +6660,7 @@ function CopilotKitColoredIcon() {
 			children: copied ? /* @__PURE__ */ jsx(Check, { className: "cpk:size-[18px]" }) : /* @__PURE__ */ jsx(Copy, { className: "cpk:size-[18px]" })
 		});
 	};
-	_CopilotChatAssistantMessage.InspectorButton = ({ title, className, ...props }) => {
-		const labels = useCopilotChatConfiguration()?.labels ?? CopilotChatDefaultLabels;
-		const primaryLabel = title || labels.assistantMessageToolbarInspectorLabel;
-		const accessibleLabel = `${primaryLabel} (local only)`;
-		return /* @__PURE__ */ jsxs(ToolbarButton, {
-			"data-testid": "copilot-inspector-button",
-			title: accessibleLabel,
-			className: twMerge("cpk:w-auto cpk:gap-1.5 cpk:px-2", className),
-			tooltipClassName: "cpk:max-w-64 cpk:text-left cpk:leading-4",
-			tooltip: "View this message in the Inspector to get more information. This button and the inspector only display during local development (localhost, dev env).",
-			...props,
-			children: [
-				/* @__PURE__ */ jsx(CopilotKitColoredIcon, {}),
-				/* @__PURE__ */ jsx("span", {
-					className: "cpk:font-medium",
-					children: primaryLabel
-				}),
-				/* @__PURE__ */ jsx("span", {
-					className: "cpk:text-xs cpk:text-muted-foreground",
-					children: "(local only)"
-				})
-			]
-		});
-	};
+	_CopilotChatAssistantMessage.InspectorButton = CopilotChatInspectorButton;
 	_CopilotChatAssistantMessage.ThumbsUpButton = ({ title, ...props }) => {
 		const labels = useCopilotChatConfiguration()?.labels ?? CopilotChatDefaultLabels;
 		return /* @__PURE__ */ jsx(ToolbarButton, {
@@ -8708,9 +8910,15 @@ function useInspectorThreadOverride(args) {
 
 //#endregion
 //#region src/v2/components/chat/CopilotChat.tsx
-function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen, attachments: attachmentsConfig, onError, throttleMs, ...props }) {
+function CopilotChat({ agentId, threadId, labels, inspectorTools, chatView, isModalDefaultOpen, attachments: attachmentsConfig, onError, throttleMs, ...props }) {
 	const existingConfig = useCopilotChatConfiguration();
-	const resolvedAgentId = agentId ?? existingConfig?.agentId ?? DEFAULT_AGENT_ID;
+	const inspector = useCopilotKitInspector();
+	const inspectorContextValue = useMemo(() => ({
+		...inspector,
+		isInspectorEnabled: inspector.isInspectorEnabled && (inspector.providerEnableInspector ?? inspectorTools ?? true)
+	}), [inspector, inspectorTools]);
+	const providerAgentId = useDefaultAgentId();
+	const resolvedAgentId = agentId ?? existingConfig?.agentId ?? providerAgentId ?? DEFAULT_AGENT_ID;
 	const providedThreadId = threadId ?? existingConfig?.threadId;
 	const baseThreadId = useMemo(() => providedThreadId ?? randomUUID$1(), [providedThreadId]);
 	const baseHasExplicitThreadId = !!threadId || !!existingConfig?.hasExplicitThreadId;
@@ -9283,7 +9491,10 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 				}),
 				/* @__PURE__ */ jsx(LastUserMessageContext.Provider, {
 					value: lastUserMessageState,
-					children: RenderedChatView
+					children: /* @__PURE__ */ jsx(CopilotKitInspectorContextProvider, {
+						value: inspectorContextValue,
+						children: RenderedChatView
+					})
 				})
 			]
 		})
@@ -9991,7 +10202,8 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 	const featureLicensed = checkFeature("threads");
 	const licensed = licensePresent && featureLicensed;
 	const licensePending = status === null;
-	const resolvedAgentId = agentId ?? configuration?.agentId ?? DEFAULT_AGENT_ID;
+	const providerAgentId = useDefaultAgentId();
+	const resolvedAgentId = agentId ?? configuration?.agentId ?? providerAgentId ?? DEFAULT_AGENT_ID;
 	const activeThreadId = configuration?.threadId ?? null;
 	const { threads, isLoading, listError, fetchMoreError, hasMoreThreads, isFetchingMoreThreads, archiveThread, unarchiveThread, deleteThread, fetchMoreThreads, refetchThreads, startNewThread } = useThreads$1({
 		agentId: resolvedAgentId,
@@ -12450,4 +12662,4 @@ function validateProps(props) {
 
 //#endregion
 export { useAgentContext as $, CopilotChatMessageView as A, AudioRecorderError as At, CopilotChatAssistantMessage_default as B, CopilotModalHeader as C, MCPAppsActivityContentSchema as Ct, CopilotChat as D, CopilotKitInspector as Dt, DefaultOpenIcon as E, ɵrunMcpFollowUp as Et, CopilotChatSuggestionView as F, useLearnFromUserActionInCurrentThread as G, useLearningContainersInCurrentThread as H, CopilotChatSuggestionPill as I, useThreads$1 as J, useLearnFromUserAction as K, CopilotChatReasoningMessage_default as L, IntelligenceIndicator as M, CopilotChatConfigurationProvider as Mt, getIntelligenceTurnAnchors as N, useCopilotChatConfiguration as Nt, CopilotChatView_default as O, useRenderToolCall as Ot, IntelligenceIndicatorView as P, useSuggestions as Q, CopilotChatUserMessage_default as R, CopilotSidebarView as S, useSandboxFunctions as St, DefaultCloseIcon as T, MCPAppsActivityType as Tt, useLearningContainers as U, CopilotChatToolCallsView as V, useAttachments as W, INTERRUPT_EVENT_NAME as X, useInterrupt as Y, useConfigureSuggestions as Z, WildcardToolCallRender as _, OpenGenerativeUIActivityRenderer as _t, ThreadsProvider as a, useRenderTool as at, CopilotSidebar as b, OpenGenerativeUIToolRenderer as bt, CoAgentStateRendersProvider as c, useRenderActivityMessage as ct, shouldShowDevConsole as d, useCopilotKit$1 as dt, useCapabilities as et, useToast as f, useLicenseContext$1 as ft, useCopilotContext as g, GenerateSandboxedUiArgsSchema as gt, CopilotContext as h, createA2UIMessageRenderer as ht, ThreadsContext as i, useDefaultRenderTool as it, INTELLIGENCE_TURN_HEAD as j, CopilotChatAudioRecorder as jt, CopilotChatAttachmentQueue as k, CopilotChatInput_default as kt, useCoAgentStateRenders as l, useRenderCustomMessages as lt, useCopilotMessagesContext as m, defineToolCallRenderer as mt, defaultCopilotContextCategories as n, useAgent as nt, useThreads as o, useComponent as ot, CopilotMessagesContext as p, CopilotKitCoreReact as pt, useMemories as q, CoAgentStateRenderBridge as r, useHumanInTheLoop as rt, CoAgentStateRendersContext as s, useFrontendTool as st, CopilotKit as t, UseAgentUpdate as tt, useAsyncCallback as u, CopilotKitProvider as ut, CopilotThreadsDrawer as v, OpenGenerativeUIActivityType as vt, CopilotChatToggleButton as w, MCPAppsActivityRenderer as wt, CopilotPopupView as x, SandboxFunctionsContext as xt, CopilotPopup as y, OpenGenerativeUIContentSchema as yt, CopilotChatAttachmentRenderer as z };
-//# sourceMappingURL=copilotkit-Ap_yisA5.mjs.map
+//# sourceMappingURL=copilotkit-snbJkMqQ.mjs.map