@copilotkit/react-core 1.68.1 → 1.68.3-canary.1786716392

package/dist/v2/index.umd.js

@@ -90,6 +90,8 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 		assistantMessageToolbarCopyCodeLabel: "Copy",
 		assistantMessageToolbarCopyCodeCopiedLabel: "Copied",
 		assistantMessageToolbarCopyMessageLabel: "Copy",
+		assistantMessageToolbarInspectorLabel: "View in Inspector",
+		assistantMessageToolbarInspectorLocalOnlyLabel: "Local Only",
 		assistantMessageToolbarThumbsUpLabel: "Good response",
 		assistantMessageToolbarThumbsDownLabel: "Bad response",
 		assistantMessageToolbarReadAloudLabel: "Read aloud",
@@ -1634,8 +1636,9 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 
 //#endregion
 //#region src/v2/components/CopilotKitInspector.tsx
-	const CopilotKitInspector = ({ core, ...rest }) => {
+	const CopilotKitInspector = ({ core, openRequest, ...rest }) => {
 		const [InspectorComponent, setInspectorComponent] = react.useState(null);
+		const inspectorRef = react.useRef(null);
 		react.useEffect(() => {
 			let mounted = true;
 			import("@copilotkit/web-inspector").then((mod) => {
@@ -1651,14 +1654,29 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 				mounted = false;
 			};
 		}, []);
+		react.useEffect(() => {
+			if (openRequest) inspectorRef.current?.openInspector("message_toolbar", openRequest);
+		}, [InspectorComponent, openRequest]);
 		if (!InspectorComponent) return null;
 		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(InspectorComponent, {
+			ref: inspectorRef,
 			...rest,
 			core: core ?? null
 		});
 	};
 	CopilotKitInspector.displayName = "CopilotKitInspector";
 
+//#endregion
+//#region src/v2/components/CopilotKitInspectorContext.tsx
+	const CopilotKitInspectorContext = react.createContext({
+		isLocalInspectorEnabled: false,
+		openInspector: () => void 0
+	});
+	const CopilotKitInspectorContextProvider = CopilotKitInspectorContext.Provider;
+	function useCopilotKitInspector() {
+		return react.useContext(CopilotKitInspectorContext);
+	}
+
 //#endregion
 //#region src/v2/components/license-warning-banner.tsx
 	const LICENSE_BANNER_OFFSET_PX = 52;
@@ -3507,6 +3525,8 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	}
 	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, showDevConsole = false, useSingleEndpoint, onError, a2ui, defaultThrottleMs, inspectorDefaultAnchor, debug }) => {
 		const [shouldRenderInspector, setShouldRenderInspector] = (0, react.useState)(false);
+		const [isLocalInspectorEnabled, setIsLocalInspectorEnabled] = (0, react.useState)(false);
+		const [inspectorOpenRequest, setInspectorOpenRequest] = (0, react.useState)(null);
 		const [runtimeA2UIEnabled, setRuntimeA2UIEnabled] = (0, react.useState)(false);
 		const [runtimeOpenGenUIEnabled, setRuntimeOpenGenUIEnabled] = (0, react.useState)(false);
 		const [catalogToggleVersion, setCatalogToggleVersion] = (0, react.useState)(0);
@@ -3516,11 +3536,30 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		const [runtimeLicenseStatus, setRuntimeLicenseStatus] = (0, react.useState)(void 0);
 		(0, react.useEffect)(() => {
 			if (typeof window === "undefined") return;
-			if (showDevConsole === true) setShouldRenderInspector(true);
-			else if (showDevConsole === "auto") if (new Set(["localhost", "127.0.0.1"]).has(window.location.hostname)) setShouldRenderInspector(true);
-			else setShouldRenderInspector(false);
-			else setShouldRenderInspector(false);
+			const isLocalhost = new Set(["localhost", "127.0.0.1"]).has(window.location?.hostname ?? "");
+			const canShowLocalInspectorAction = process.env.NODE_ENV === "development" && isLocalhost;
+			if (showDevConsole === true) {
+				setShouldRenderInspector(true);
+				setIsLocalInspectorEnabled(canShowLocalInspectorAction);
+			} else if (showDevConsole === "auto") if (isLocalhost) {
+				setShouldRenderInspector(true);
+				setIsLocalInspectorEnabled(canShowLocalInspectorAction);
+			} else {
+				setShouldRenderInspector(false);
+				setIsLocalInspectorEnabled(false);
+			}
+			else {
+				setShouldRenderInspector(false);
+				setIsLocalInspectorEnabled(false);
+			}
 		}, [showDevConsole]);
+		const requestInspectorOpen = (0, react.useCallback)((request) => {
+			setInspectorOpenRequest({ ...request });
+		}, []);
+		const inspectorContextValue = (0, react.useMemo)(() => ({
+			isLocalInspectorEnabled,
+			openInspector: requestInspectorOpen
+		}), [isLocalInspectorEnabled, 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));
@@ -3857,11 +3896,14 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 							catalog: filteredCatalog,
 							includeSchema: a2ui?.includeSchema
 						}),
-						children,
-						shouldRenderInspector ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotKitInspector, {
-							core: copilotkit,
-							defaultAnchor: inspectorDefaultAnchor
-						}) : null,
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(CopilotKitInspectorContextProvider, {
+							value: inspectorContextValue,
+							children: [children, shouldRenderInspector ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotKitInspector, {
+								core: copilotkit,
+								defaultAnchor: inspectorDefaultAnchor,
+								openRequest: inspectorOpenRequest
+							}) : null]
+						}),
 						runtimeLicenseStatus === "none" && !resolvedPublicKey && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LicenseWarningBanner, { type: "no_license" }),
 						runtimeLicenseStatus === "expired" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LicenseWarningBanner, { type: "expired" }),
 						runtimeLicenseStatus === "invalid" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LicenseWarningBanner, { type: "invalid" }),
@@ -4615,6 +4657,75 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		};
 	}
 
+//#endregion
+//#region src/v2/hooks/use-subagent.tsx
+	const warnedAmbiguousNames = /* @__PURE__ */ new Set();
+	function resolveSubagent(subagents, subagentRunId, subagentName) {
+		if (subagentRunId) {
+			const match = subagents[subagentRunId];
+			return match ? { ...match } : void 0;
+		}
+		if (subagentName) {
+			const matches = Object.values(subagents).filter((s) => s.name === subagentName);
+			if (matches.length === 0) return;
+			const chosen = matches[matches.length - 1];
+			return matches.length > 1 ? {
+				...chosen,
+				isAmbiguous: true,
+				matchCount: matches.length
+			} : { ...chosen };
+		}
+	}
+	/**
+	* Read a subagent's live lifecycle state (name, description, running status)
+	* from the CopilotKit core subagent registry, by id or by declared name.
+	*
+	* @example
+	* const sub = useSubagent({ subagentRunId: message.subagentRunId });
+	* // sub?.name, sub?.description, sub?.status
+	*/
+	function useSubagent(params) {
+		const { subagentRunId, subagentName, agentId } = params;
+		const { copilotkit } = useCopilotKit();
+		const config = useCopilotChatConfiguration();
+		const resolvedAgentId = (0, react.useMemo)(() => agentId ?? config?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID, [agentId, config?.agentId]);
+		const [subagent, setSubagent] = (0, react.useState)(() => resolveSubagent(copilotkit.getSubagents(resolvedAgentId), subagentRunId, subagentName));
+		(0, react.useEffect)(() => {
+			setSubagent(resolveSubagent(copilotkit.getSubagents(resolvedAgentId), subagentRunId, subagentName));
+		}, [
+			copilotkit,
+			resolvedAgentId,
+			subagentRunId,
+			subagentName
+		]);
+		(0, react.useEffect)(() => {
+			const subscription = copilotkit.subscribe({ onSubagentsChanged: ({ agentId: changedAgentId, subagents }) => {
+				if (changedAgentId !== resolvedAgentId) return;
+				setSubagent(resolveSubagent(subagents, subagentRunId, subagentName));
+			} });
+			return () => {
+				subscription.unsubscribe();
+			};
+		}, [
+			copilotkit,
+			resolvedAgentId,
+			subagentRunId,
+			subagentName
+		]);
+		(0, react.useEffect)(() => {
+			if (process.env.NODE_ENV === "production" || !subagentName || !subagent?.isAmbiguous) return;
+			const key = `${subagentName}:${subagent.matchCount}`;
+			if (warnedAmbiguousNames.has(key)) return;
+			warnedAmbiguousNames.add(key);
+			console.warn(`[CopilotKit] useSubagent({ subagentName: ${JSON.stringify(subagentName)} }) matched ${subagent.matchCount} subagents. Returning the most recently started one; pass a subagentRunId for a stable reference.`);
+		}, [
+			subagentName,
+			subagent?.isAmbiguous,
+			subagent?.matchCount
+		]);
+		return subagent;
+	}
+
 //#endregion
 //#region src/v2/hooks/use-capabilities.tsx
 /**
@@ -5910,14 +6021,21 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 
 //#endregion
 //#region src/v2/components/chat/CopilotChatAssistantMessage.tsx
-	function CopilotChatAssistantMessage({ message, messages, isRunning, onThumbsUp, onThumbsDown, onReadAloud, onRegenerate, additionalToolbarItems, toolbarVisible = true, markdownRenderer, toolbar, copyButton, thumbsUpButton, thumbsDownButton, readAloudButton, regenerateButton, toolCallsView, children, className, ...props }) {
+	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 { isLocalInspectorEnabled, openInspector } = useCopilotKitInspector();
+		const chatConfiguration = useCopilotChatConfiguration();
 		const boundMarkdownRenderer = renderSlot(markdownRenderer, CopilotChatAssistantMessage.MarkdownRenderer, { content: message.content || "" });
 		const boundCopyButton = renderSlot(copyButton, CopilotChatAssistantMessage.CopyButton, { onClick: async () => {
 			if (message.content) return await (0, _copilotkit_shared.copyToClipboard)(message.content);
 			return false;
 		} });
 		const boundThumbsUpButton = renderSlot(thumbsUpButton, CopilotChatAssistantMessage.ThumbsUpButton, { onClick: onThumbsUp ? () => onThumbsUp(message) : void 0 });
+		const boundInspectorButton = renderSlot(inspectorButton, CopilotChatAssistantMessage.InspectorButton, { onClick: () => openInspector({
+			messageId: message.id,
+			threadId: chatConfiguration?.threadId,
+			agentId: chatConfiguration?.agentId
+		}) });
 		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 });
@@ -5925,6 +6043,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			className: "cpk:flex cpk:items-center cpk:gap-1",
 			children: [
 				boundCopyButton,
+				isLocalInspectorEnabled && boundInspectorButton,
 				(onThumbsUp || thumbsUpButton) && boundThumbsUpButton,
 				(onThumbsDown || thumbsDownButton) && boundThumbsDownButton,
 				(onReadAloud || readAloudButton) && boundReadAloudButton,
@@ -5947,6 +6066,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 				toolbar: boundToolbar,
 				toolCallsView: boundToolCallsView,
 				copyButton: boundCopyButton,
+				inspectorButton: boundInspectorButton,
 				thumbsUpButton: boundThumbsUpButton,
 				thumbsDownButton: boundThumbsDownButton,
 				readAloudButton: boundReadAloudButton,
@@ -5978,6 +6098,110 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			]
 		});
 	}
+	function CopilotKitColoredIcon() {
+		const gradientId = (0, react.useId)().replace(/:/g, "");
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
+			"aria-hidden": "true",
+			className: "cpk:size-5",
+			"data-testid": "copilot-inspector-icon",
+			viewBox: "0 0 24 24",
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsxs)("defs", { children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("linearGradient", {
+						gradientUnits: "userSpaceOnUse",
+						id: `${gradientId}-purple`,
+						x1: "17.852",
+						x2: "14.202",
+						y1: "1.467",
+						y2: "11.504",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("stop", { className: "cpk:[stop-color:#6430AB] cpk:dark:[stop-color:#B792F0]" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("stop", {
+							className: "cpk:[stop-color:#AA89D8] cpk:dark:[stop-color:#D3BDF7]",
+							offset: "1"
+						})]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("linearGradient", {
+						gradientUnits: "userSpaceOnUse",
+						id: `${gradientId}-blue`,
+						x1: "15.024",
+						x2: "10.324",
+						y1: "7.125",
+						y2: "16.204",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("stop", { className: "cpk:[stop-color:#005DBB] cpk:dark:[stop-color:#4D9FEF]" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("stop", {
+							className: "cpk:[stop-color:#3D92E8] cpk:dark:[stop-color:#84C0FA]",
+							offset: "1"
+						})]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("linearGradient", {
+						gradientUnits: "userSpaceOnUse",
+						id: `${gradientId}-light-blue`,
+						x1: "17.122",
+						x2: "15.707",
+						y1: "1.467",
+						y2: "5.892",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("stop", { className: "cpk:[stop-color:#1B70C4] cpk:dark:[stop-color:#61ACF2]" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("stop", {
+							className: "cpk:[stop-color:#54A4F2] cpk:dark:[stop-color:#9ACDFF]",
+							offset: "1"
+						})]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("linearGradient", {
+						gradientUnits: "userSpaceOnUse",
+						id: `${gradientId}-tail`,
+						x1: "6.577",
+						x2: "21.506",
+						y1: "21.758",
+						y2: "21.758",
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("stop", { className: "cpk:[stop-color:#4497EA] cpk:dark:[stop-color:#79BCF5]" }),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("stop", {
+								className: "cpk:[stop-color:#1463B2] cpk:dark:[stop-color:#4594D8]",
+								offset: ".255"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("stop", {
+								className: "cpk:[stop-color:#0A437D] cpk:dark:[stop-color:#347CB7]",
+								offset: ".499"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("stop", {
+								className: "cpk:[stop-color:#2476C8] cpk:dark:[stop-color:#58A4E5]",
+								offset: ".667"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("stop", {
+								className: "cpk:[stop-color:#0C549A] cpk:dark:[stop-color:#3C87C7]",
+								offset: ".973"
+							})
+						]
+					})
+				] })
+			]
+		});
+	}
 	(function(_CopilotChatAssistantMessage) {
 		_CopilotChatAssistantMessage.MarkdownRenderer = ({ content, className, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(streamdown.Streamdown, {
 			className,
@@ -5989,7 +6213,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			className: (0, tailwind_merge.twMerge)("cpk:w-full cpk:bg-transparent cpk:flex cpk:items-center cpk:-ml-[5px] cpk:-mt-[0px]", className),
 			...props
 		});
-		const ToolbarButton = _CopilotChatAssistantMessage.ToolbarButton = ({ title, children, ...props }) => {
+		const ToolbarButton = _CopilotChatAssistantMessage.ToolbarButton = ({ title, tooltip, children, ...props }) => {
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(Tooltip, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TooltipTrigger, {
 				asChild: true,
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Button, {
@@ -6001,7 +6225,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 				})
 			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TooltipContent, {
 				side: "bottom",
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: title })
+				children: tooltip ?? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: title })
 			})] });
 		};
 		_CopilotChatAssistantMessage.CopyButton = ({ className, title, onClick, ...props }) => {
@@ -6034,6 +6258,25 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 				children: copied ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(lucide_react.Check, { className: "cpk:size-[18px]" }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(lucide_react.Copy, { className: "cpk:size-[18px]" })
 			});
 		};
+		_CopilotChatAssistantMessage.InspectorButton = ({ title, ...props }) => {
+			const labels = useCopilotChatConfiguration()?.labels ?? CopilotChatDefaultLabels;
+			const primaryLabel = title || labels.assistantMessageToolbarInspectorLabel;
+			const localOnlyLabel = labels.assistantMessageToolbarInspectorLocalOnlyLabel;
+			const accessibleLabel = `${primaryLabel} (${localOnlyLabel})`;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolbarButton, {
+				"data-testid": "copilot-inspector-button",
+				title: accessibleLabel,
+				tooltip: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "cpk:flex cpk:flex-col cpk:gap-0.5",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: primaryLabel }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "cpk:text-[10px] cpk:opacity-65",
+						children: localOnlyLabel
+					})]
+				}),
+				...props,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotKitColoredIcon, {})
+			});
+		};
 		_CopilotChatAssistantMessage.ThumbsUpButton = ({ title, ...props }) => {
 			const labels = useCopilotChatConfiguration()?.labels ?? CopilotChatDefaultLabels;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolbarButton, {
@@ -6074,6 +6317,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	CopilotChatAssistantMessage.MarkdownRenderer.displayName = "CopilotChatAssistantMessage.MarkdownRenderer";
 	CopilotChatAssistantMessage.Toolbar.displayName = "CopilotChatAssistantMessage.Toolbar";
 	CopilotChatAssistantMessage.CopyButton.displayName = "CopilotChatAssistantMessage.CopyButton";
+	CopilotChatAssistantMessage.InspectorButton.displayName = "CopilotChatAssistantMessage.InspectorButton";
 	CopilotChatAssistantMessage.ThumbsUpButton.displayName = "CopilotChatAssistantMessage.ThumbsUpButton";
 	CopilotChatAssistantMessage.ThumbsDownButton.displayName = "CopilotChatAssistantMessage.ThumbsDownButton";
 	CopilotChatAssistantMessage.ReadAloudButton.displayName = "CopilotChatAssistantMessage.ReadAloudButton";
@@ -8175,7 +8419,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		const providedThreadId = threadId ?? existingConfig?.threadId;
 		const resolvedThreadId = (0, react.useMemo)(() => providedThreadId ?? (0, _copilotkit_shared.randomUUID)(), [providedThreadId]);
 		const hasExplicitThreadId = !!threadId || !!existingConfig?.hasExplicitThreadId;
-		const { agent } = useAgent({
+		const { agent, isReady } = useAgent({
 			agentId: resolvedAgentId,
 			throttleMs
 		});
@@ -8621,8 +8865,8 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		}, []);
 		const mergedProps = {
 			isRunning: agent.isRunning,
-			suggestions: autoSuggestions,
-			onSelectSuggestion: handleSelectSuggestion,
+			suggestions: isReady ? autoSuggestions : [],
+			onSelectSuggestion: isReady ? handleSelectSuggestion : void 0,
 			suggestionView: stableSuggestionView,
 			...restProps
 		};
@@ -8655,7 +8899,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		const RenderedChatView = renderSlot(chatView, CopilotChatView, {
 			...mergedProps,
 			messages,
-			onSubmitMessage: onSubmitInput,
+			onSubmitMessage: isReady ? onSubmitInput : void 0,
 			onStop: effectiveStopHandler,
 			inputMode: effectiveMode,
 			inputValue,
@@ -11779,6 +12023,7 @@ exports.useRenderCustomMessages = useRenderCustomMessages;
 exports.useRenderTool = useRenderTool;
 exports.useRenderToolCall = useRenderToolCall;
 exports.useSandboxFunctions = useSandboxFunctions;
+exports.useSubagent = useSubagent;
 exports.useSuggestions = useSuggestions;
 exports.useThreads = useThreads;
 exports.ɵrunMcpFollowUp = ɵrunMcpFollowUp;