@copilotkit/react-core 1.68.3 → 1.69.1

package/dist/v2/index.umd.js

@@ -92,6 +92,7 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 		assistantMessageToolbarCopyMessageLabel: "Copy",
 		assistantMessageToolbarInspectorLabel: "View in Inspector",
 		assistantMessageToolbarInspectorLocalOnlyLabel: "Local Only",
+		assistantMessageToolbarSaveSnippetLabel: "Save as snippet",
 		assistantMessageToolbarThumbsUpLabel: "Good response",
 		assistantMessageToolbarThumbsDownLabel: "Bad response",
 		assistantMessageToolbarReadAloudLabel: "Read aloud",
@@ -1670,7 +1671,8 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 //#region src/v2/components/CopilotKitInspectorContext.tsx
 	const CopilotKitInspectorContext = react.createContext({
 		isLocalInspectorEnabled: false,
-		openInspector: () => void 0
+		openInspector: () => void 0,
+		saveEventSnippet: async () => void 0
 	});
 	const CopilotKitInspectorContextProvider = CopilotKitInspectorContext.Provider;
 	function useCopilotKitInspector() {
@@ -2484,6 +2486,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	const OpenGenerativeUIActivityRendererInner = react.default.memo(function OpenGenerativeUIActivityRendererInner({ content }) {
 		const initialHeight = content.initialHeight ?? 200;
 		const [autoHeight, setAutoHeight] = (0, react.useState)(null);
+		const [sandboxReady, setSandboxReady] = (0, react.useState)(false);
 		const sandboxFunctions = useSandboxFunctions();
 		const localApi = (0, react.useMemo)(() => {
 			const api = {};
@@ -2585,6 +2588,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 				sandbox.promise.then(() => {
 					if (cancelled) return;
 					sandboxReadyRef.current = true;
+					setSandboxReady(true);
 					sandbox.run(`
             var s = document.createElement('style');
             s.textContent = 'html, body { overflow: hidden !important; }';
@@ -2609,6 +2613,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 					sandboxRef.current = null;
 				}
 				sandboxReadyRef.current = false;
+				setSandboxReady(false);
 				setAutoHeight(null);
 			};
 		}, [
@@ -2639,7 +2644,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		const generationDone = content.generating === false;
 		(0, react.useEffect)(() => {
 			const sandbox = sandboxRef.current;
-			if (!generationDone || !sandbox) return;
+			if (!generationDone || !sandboxReady || !sandbox) return;
 			let handled = false;
 			const onMessage = (e) => {
 				if (handled) return;
@@ -2668,7 +2673,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			return () => {
 				window.removeEventListener("message", onMessage);
 			};
-		}, [generationDone]);
+		}, [generationDone, sandboxReady]);
 		const height = autoHeight ?? initialHeight;
 		const isGenerating = content.generating !== false;
 		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -3556,10 +3561,46 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		const requestInspectorOpen = (0, react.useCallback)((request) => {
 			setInspectorOpenRequest({ ...request });
 		}, []);
+		const saveEventSnippet = (0, react.useCallback)(async (request) => {
+			try {
+				const mod = await import("@copilotkit/web-inspector");
+				const threadId = request.threadId ?? "inspector-snippet";
+				const runId = `inspector-snippet-${Date.now()}`;
+				const compiled = mod.compileChatSnippet({
+					...request,
+					threadId,
+					runId
+				});
+				const now = (/* @__PURE__ */ new Date()).toISOString();
+				const snippet = {
+					id: crypto.randomUUID(),
+					name: compiled.name,
+					recipe: compiled.recipe,
+					events: compiled.events,
+					createdAt: now,
+					updatedAt: now
+				};
+				mod.upsertEventSnippet(snippet);
+				requestInspectorOpen({
+					messageId: request.messageId,
+					threadId: request.threadId,
+					agentId: request.agentId,
+					menu: "event-snippets",
+					snippetId: snippet.id
+				});
+			} catch (error) {
+				console.error("[CopilotKit] Could not save the event snippet.", error);
+			}
+		}, [requestInspectorOpen]);
 		const inspectorContextValue = (0, react.useMemo)(() => ({
 			isLocalInspectorEnabled,
-			openInspector: requestInspectorOpen
-		}), [isLocalInspectorEnabled, requestInspectorOpen]);
+			openInspector: requestInspectorOpen,
+			saveEventSnippet
+		}), [
+			isLocalInspectorEnabled,
+			requestInspectorOpen,
+			saveEventSnippet
+		]);
 		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));
@@ -3614,7 +3655,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		const hasLocalAgents = mergedAgents && Object.keys(mergedAgents).length > 0;
 		const hasSelfManagedAgents = Object.keys(selfManagedAgents).length > 0;
 		(0, react.useEffect)(() => {
-			if (hasSelfManagedAgents && !resolvedPublicKey) console.warn("[CopilotKit] `selfManagedAgents` is part of CopilotKit's Enterprise Intelligence offering. Provide a `publicLicenseKey` for production use — contact the CopilotKit team about licensing.");
+			if (hasSelfManagedAgents && !resolvedPublicKey) console.warn("[CopilotKit] `selfManagedAgents` is part of CopilotKit's Enterprise Intelligence tier. Provide a `publicLicenseKey` for production use — contact the CopilotKit team about licensing.");
 		}, [hasSelfManagedAgents, resolvedPublicKey]);
 		const headers = typeof headersProp === "function" ? headersProp() : headersProp;
 		const mergedHeaders = (0, react.useMemo)(() => {
@@ -5211,10 +5252,10 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		}, [store, selector]), () => selector(store.getState()), () => selector(store.getServerState()));
 	}
 	/**
-	* React hook for listing and managing Intelligence platform threads.
+	* React hook for listing and managing CopilotKit Intelligence threads.
 	*
 	* On mount the hook fetches the thread list for the runtime-authenticated user
-	* and the given `agentId`. When the Intelligence platform exposes a WebSocket
+	* and the given `agentId`. When CopilotKit Intelligence exposes a WebSocket
 	* URL, it also opens a realtime subscription so the `threads` array stays
 	* current without polling — thread creates, renames, archives, and deletes
 	* from any client are reflected immediately.
@@ -5510,7 +5551,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 //#endregion
 //#region src/v2/hooks/use-learn-from-user-action.tsx
 /**
-	* Record a user UI interaction in the Intelligence platform's user-actions
+	* Record a user UI interaction in CopilotKit Intelligence's user-actions
 	* stream. The platform's auto-curated knowledge base agent reads these
 	* (alongside finished agent runs) and writes free-form Obsidian-flavored
 	* markdown to `/project`, where any agent in the same project can later
@@ -5936,25 +5977,191 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		});
 	}
 
+//#endregion
+//#region src/v2/components/chat/save-snippet-beside.ts
+	const SAVE_SNIPPET_ICON_SLOT_PX = 36;
+	const SAVE_SNIPPET_BESIDE_WRAP_CLASS = "cpk:relative cpk:w-full cpk:overflow-visible";
+	const SAVE_SNIPPET_BESIDE_BODY_CLASS = "cpk:w-full";
+	const SAVE_SNIPPET_BESIDE_SAVE_CLASS = "cpk:absolute cpk:top-0 cpk:z-10";
+	function saveSnippetBesideStyle(side) {
+		if (side === "left") return {
+			left: "auto",
+			right: "100%",
+			marginLeft: 0,
+			marginRight: 4
+		};
+		return {
+			left: "100%",
+			right: "auto",
+			marginLeft: 4,
+			marginRight: 0
+		};
+	}
+	function pickSaveSnippetSide(roomRight, roomLeft, slotPx = SAVE_SNIPPET_ICON_SLOT_PX) {
+		if (roomRight >= slotPx) return "right";
+		if (roomLeft >= slotPx) return "left";
+		return "right";
+	}
+	function findOverflowAncestor(el) {
+		let node = el.parentElement;
+		while (node) {
+			const style = getComputedStyle(node);
+			const overflowX = style.overflowX;
+			const overflow = style.overflow;
+			if (overflowX === "hidden" || overflowX === "auto" || overflowX === "scroll" || overflow === "hidden" || overflow === "auto" || overflow === "scroll") return node;
+			node = node.parentElement;
+		}
+		return document.documentElement;
+	}
+	function measurableBox(el) {
+		let node = el;
+		while (node && getComputedStyle(node).display === "contents") node = node.firstElementChild;
+		return node ?? el;
+	}
+	function measureSaveSnippetSide(wrap, body) {
+		const clipRect = findOverflowAncestor(wrap).getBoundingClientRect();
+		const bodyRect = measurableBox(body.firstElementChild ?? body).getBoundingClientRect();
+		return pickSaveSnippetSide(clipRect.right - bodyRect.right, bodyRect.left - clipRect.left);
+	}
+
+//#endregion
+//#region src/v2/components/chat/SaveSnippetIconButton.tsx
+	function SaveSnippetIconButton({ title, className, ...props }) {
+		const labels = useCopilotChatConfiguration()?.labels ?? CopilotChatDefaultLabels;
+		const primaryLabel = title || labels.assistantMessageToolbarSaveSnippetLabel;
+		const localOnlyLabel = labels.assistantMessageToolbarInspectorLocalOnlyLabel;
+		const accessibleLabel = `${primaryLabel} (${localOnlyLabel})`;
+		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, {
+				type: "button",
+				variant: "assistantMessageToolbarButton",
+				"aria-label": accessibleLabel,
+				title: accessibleLabel,
+				className,
+				...props,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(lucide_react.Bookmark, { className: "cpk:size-[18px]" })
+			})
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TooltipContent, {
+			side: "bottom",
+			children: /* @__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
+				})]
+			})
+		})] });
+	}
+	function SaveSnippetBesideChrome({ children, showSave, saveButton }) {
+		const wrapRef = (0, react.useRef)(null);
+		const bodyRef = (0, react.useRef)(null);
+		const [side, setSide] = (0, react.useState)("right");
+		(0, react.useLayoutEffect)(() => {
+			if (!showSave) return;
+			const wrap = wrapRef.current;
+			const body = bodyRef.current;
+			if (!wrap || !body) return;
+			const measure = () => {
+				setSide(measureSaveSnippetSide(wrap, body));
+			};
+			measure();
+			if (typeof ResizeObserver === "undefined") return;
+			const observer = new ResizeObserver(measure);
+			observer.observe(wrap);
+			observer.observe(body);
+			const clip = findOverflowAncestor(wrap);
+			if (clip !== wrap) observer.observe(clip);
+			window.addEventListener("resize", measure);
+			return () => {
+				observer.disconnect();
+				window.removeEventListener("resize", measure);
+			};
+		}, [showSave]);
+		if (!showSave) return children;
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			ref: wrapRef,
+			className: SAVE_SNIPPET_BESIDE_WRAP_CLASS,
+			"data-save-snippet-side": side,
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				ref: bodyRef,
+				className: SAVE_SNIPPET_BESIDE_BODY_CLASS,
+				children
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: SAVE_SNIPPET_BESIDE_SAVE_CLASS,
+				style: saveSnippetBesideStyle(side),
+				children: saveButton
+			})]
+		});
+	}
+
 //#endregion
 //#region src/v2/components/chat/CopilotChatToolCallsView.tsx
 	function CopilotChatToolCallsView({ message, messages = [] }) {
 		const renderToolCall = useRenderToolCall();
+		const { isLocalInspectorEnabled, saveEventSnippet } = useCopilotKitInspector();
+		const chatConfiguration = useCopilotChatConfiguration();
+		const labels = chatConfiguration?.labels ?? CopilotChatDefaultLabels;
 		if (!message.toolCalls || message.toolCalls.length === 0) return null;
 		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: message.toolCalls.map((toolCall) => {
-			const toolMessage = messages.find((m) => m.role === "tool" && m.toolCallId === toolCall.id);
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.default.Fragment, { children: renderToolCall({
+			const rendered = renderToolCall({
 				toolCall,
-				toolMessage
-			}) }, toolCall.id);
+				toolMessage: messages.find((m) => m.role === "tool" && m.toolCallId === toolCall.id)
+			});
+			if (!isLocalInspectorEnabled || !hasCompleteArgs(toolCall.function.arguments)) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.default.Fragment, { children: rendered }, toolCall.id);
+			const primaryLabel = labels.assistantMessageToolbarSaveSnippetLabel;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCallSnippetChrome, {
+				label: primaryLabel,
+				onSave: () => void saveEventSnippet({
+					kind: "tool-call",
+					messageId: message.id,
+					toolCallId: toolCall.id,
+					toolName: toolCall.function.name,
+					argsJson: toolCall.function.arguments || "{}",
+					threadId: chatConfiguration?.threadId,
+					agentId: chatConfiguration?.agentId
+				}),
+				children: rendered
+			}, toolCall.id);
 		}) });
 	}
+	function hasCompleteArgs(args) {
+		const trimmed = (args ?? "").trim();
+		if (!trimmed) return true;
+		try {
+			JSON.parse(trimmed);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	function ToolCallSnippetChrome({ children, label, onSave }) {
+		const bodyRef = (0, react.useRef)(null);
+		const [showSave, setShowSave] = (0, react.useState)(false);
+		(0, react.useLayoutEffect)(() => {
+			const el = bodyRef.current;
+			setShowSave(!!el && el.childElementCount > 0);
+		});
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SaveSnippetBesideChrome, {
+			showSave,
+			saveButton: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SaveSnippetIconButton, {
+				"data-testid": "copilot-tool-save-snippet-button",
+				title: label,
+				onClick: onSave
+			}),
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				ref: bodyRef,
+				className: "cpk:contents",
+				children
+			})
+		});
+	}
 
 //#endregion
 //#region src/v2/components/chat/CopilotChatAssistantMessage.tsx
-	function CopilotChatAssistantMessage({ message, messages, isRunning, onThumbsUp, onThumbsDown, onReadAloud, onRegenerate, additionalToolbarItems, toolbarVisible = true, markdownRenderer, toolbar, copyButton, inspectorButton, thumbsUpButton, thumbsDownButton, readAloudButton, regenerateButton, toolCallsView, children, className, ...props }) {
+	function CopilotChatAssistantMessage({ message, messages, isRunning, onThumbsUp, onThumbsDown, onReadAloud, onRegenerate, additionalToolbarItems, toolbarVisible = true, markdownRenderer, toolbar, copyButton, inspectorButton, saveSnippetButton, thumbsUpButton, thumbsDownButton, readAloudButton, regenerateButton, toolCallsView, children, className, ...props }) {
 		useKatexStyles();
-		const { isLocalInspectorEnabled, openInspector } = useCopilotKitInspector();
+		const { isLocalInspectorEnabled, openInspector, saveEventSnippet } = useCopilotKitInspector();
 		const chatConfiguration = useCopilotChatConfiguration();
 		const boundMarkdownRenderer = renderSlot(markdownRenderer, CopilotChatAssistantMessage.MarkdownRenderer, { content: message.content || "" });
 		const boundCopyButton = renderSlot(copyButton, CopilotChatAssistantMessage.CopyButton, { onClick: async () => {
@@ -5967,6 +6174,17 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			threadId: chatConfiguration?.threadId,
 			agentId: chatConfiguration?.agentId
 		}) });
+		const hasContent = !!(message.content && message.content.trim().length > 0);
+		const boundSaveSnippetButton = renderSlot(saveSnippetButton, CopilotChatAssistantMessage.SaveSnippetButton, { onClick: () => {
+			if (!hasContent) return;
+			saveEventSnippet({
+				kind: "text",
+				messageId: message.id,
+				content: message.content ?? "",
+				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 });
@@ -5975,6 +6193,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			children: [
 				boundCopyButton,
 				isLocalInspectorEnabled && boundInspectorButton,
+				isLocalInspectorEnabled && hasContent && boundSaveSnippetButton,
 				(onThumbsUp || thumbsUpButton) && boundThumbsUpButton,
 				(onThumbsDown || thumbsDownButton) && boundThumbsDownButton,
 				(onReadAloud || readAloudButton) && boundReadAloudButton,
@@ -5986,9 +6205,8 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			message,
 			messages
 		});
-		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 && !(isRunning && isLatestAssistantMessage);
+		const shouldShowToolbar = toolbarVisible && (hasContent || isLocalInspectorEnabled) && !(isRunning && isLatestAssistantMessage);
 		if (children) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 			"data-copilotkit": true,
 			style: { display: "contents" },
@@ -5998,6 +6216,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 				toolCallsView: boundToolCallsView,
 				copyButton: boundCopyButton,
 				inspectorButton: boundInspectorButton,
+				saveSnippetButton: boundSaveSnippetButton,
 				thumbsUpButton: boundThumbsUpButton,
 				thumbsDownButton: boundThumbsDownButton,
 				readAloudButton: boundReadAloudButton,
@@ -6208,6 +6427,10 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotKitColoredIcon, {})
 			});
 		};
+		_CopilotChatAssistantMessage.SaveSnippetButton = (props) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SaveSnippetIconButton, {
+			"data-testid": "copilot-save-snippet-button",
+			...props
+		});
 		_CopilotChatAssistantMessage.ThumbsUpButton = ({ title, ...props }) => {
 			const labels = useCopilotChatConfiguration()?.labels ?? CopilotChatDefaultLabels;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolbarButton, {
@@ -6249,6 +6472,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	CopilotChatAssistantMessage.Toolbar.displayName = "CopilotChatAssistantMessage.Toolbar";
 	CopilotChatAssistantMessage.CopyButton.displayName = "CopilotChatAssistantMessage.CopyButton";
 	CopilotChatAssistantMessage.InspectorButton.displayName = "CopilotChatAssistantMessage.InspectorButton";
+	CopilotChatAssistantMessage.SaveSnippetButton.displayName = "CopilotChatAssistantMessage.SaveSnippetButton";
 	CopilotChatAssistantMessage.ThumbsUpButton.displayName = "CopilotChatAssistantMessage.ThumbsUpButton";
 	CopilotChatAssistantMessage.ThumbsDownButton.displayName = "CopilotChatAssistantMessage.ThumbsDownButton";
 	CopilotChatAssistantMessage.ReadAloudButton.displayName = "CopilotChatAssistantMessage.ReadAloudButton";
@@ -6619,6 +6843,8 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		const isLatest = messages?.[messages.length - 1]?.id === message.id;
 		const isStreaming = !!(isRunning && isLatest);
 		const hasContent = !!(message.content && message.content.length > 0);
+		const { isLocalInspectorEnabled, saveEventSnippet } = useCopilotKitInspector();
+		const chatConfiguration = useCopilotChatConfiguration();
 		const startTimeRef = (0, react.useRef)(null);
 		const [elapsed, setElapsed] = (0, react.useState)(0);
 		(0, react.useEffect)(() => {
@@ -6678,7 +6904,16 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			className: (0, tailwind_merge.twMerge)("cpk:my-1", className),
 			"data-message-id": message.id,
 			...props,
-			children: [boundHeader, boundToggle]
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "cpk:flex cpk:items-center cpk:gap-1",
+				children: [boundHeader, isLocalInspectorEnabled && hasContent && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotChatAssistantMessage_default.SaveSnippetButton, { onClick: () => void saveEventSnippet({
+					kind: "reasoning",
+					messageId: message.id,
+					content: message.content ?? "",
+					threadId: chatConfiguration?.threadId,
+					agentId: chatConfiguration?.agentId
+				}) })]
+			}), boundToggle]
 		});
 	}
 	(function(_CopilotChatReasoningMessage) {
@@ -7197,8 +7432,33 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	/**
 	* Memoized wrapper for activity messages to prevent re-renders when other messages change.
 	*/
+	function ActivitySnippetChrome({ message, children }) {
+		const { isLocalInspectorEnabled, saveEventSnippet } = useCopilotKitInspector();
+		const chatConfiguration = useCopilotChatConfiguration();
+		if (!(isLocalInspectorEnabled && (message.activityType === "a2ui-surface" || message.activityType === "open-generative-ui"))) return children;
+		const primaryLabel = (chatConfiguration?.labels ?? CopilotChatDefaultLabels).assistantMessageToolbarSaveSnippetLabel;
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SaveSnippetBesideChrome, {
+			showSave: true,
+			saveButton: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SaveSnippetIconButton, {
+				"data-testid": "copilot-activity-save-snippet-button",
+				title: primaryLabel,
+				onClick: () => void saveEventSnippet({
+					kind: "activity",
+					messageId: message.id,
+					activityType: message.activityType,
+					content: message.content,
+					threadId: chatConfiguration?.threadId,
+					agentId: chatConfiguration?.agentId
+				})
+			}),
+			children
+		});
+	}
 	const MemoizedActivityMessage = react.default.memo(function MemoizedActivityMessage({ message, renderActivityMessage }) {
-		return renderActivityMessage(message);
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ActivitySnippetChrome, {
+			message,
+			children: renderActivityMessage(message)
+		});
 	}, (prevProps, nextProps) => {
 		if (prevProps.message.id !== nextProps.message.id) return false;
 		if (prevProps.message.activityType !== nextProps.message.activityType) return false;
@@ -7339,6 +7599,30 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		const deduplicatedMessages = (0, react.useMemo)(() => deduplicateMessages(messages), [messages]);
 		if (process.env.NODE_ENV === "development" && deduplicatedMessages.length < messages.length) console.warn(`CopilotChatMessageView: Merged ${messages.length - deduplicatedMessages.length} message(s) with duplicate IDs.`);
 		const { Component: AssistantComponent, slotProps: assistantSlotProps } = (0, react.useMemo)(() => resolveSlotComponent(assistantMessage, CopilotChatAssistantMessage_default), [assistantMessage]);
+		const agentId = config?.agentId;
+		const threadId = config?.threadId;
+		const assistantSlotPropsWithFeedback = (0, react.useMemo)(() => {
+			const onThumbsUp = assistantSlotProps?.onThumbsUp;
+			const onThumbsDown = assistantSlotProps?.onThumbsDown;
+			if (!onThumbsUp && !onThumbsDown) return assistantSlotProps;
+			const withRawEvent = (message) => {
+				const rawEvent = agentId === void 0 || threadId === void 0 ? void 0 : copilotkit.getRawEventForMessage(agentId, threadId, message.id);
+				return rawEvent === void 0 ? message : {
+					...message,
+					rawEvent
+				};
+			};
+			return {
+				...assistantSlotProps,
+				...onThumbsUp && { onThumbsUp: (message) => onThumbsUp(withRawEvent(message)) },
+				...onThumbsDown && { onThumbsDown: (message) => onThumbsDown(withRawEvent(message)) }
+			};
+		}, [
+			assistantSlotProps,
+			agentId,
+			threadId,
+			copilotkit
+		]);
 		const { Component: UserComponent, slotProps: userSlotProps } = (0, react.useMemo)(() => resolveSlotComponent(userMessage, CopilotChatUserMessage_default), [userMessage]);
 		const { Component: ReasoningComponent, slotProps: reasoningSlotProps } = (0, react.useMemo)(() => resolveSlotComponent(reasoningMessage, CopilotChatReasoningMessage_default), [reasoningMessage]);
 		const scrollElementFromCtx = (0, react.useContext)(ScrollElementContext);
@@ -7378,7 +7662,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 				messages,
 				isRunning,
 				AssistantMessageComponent: AssistantComponent,
-				slotProps: assistantSlotProps
+				slotProps: assistantSlotPropsWithFeedback
 			}, message.id));
 			else if (message.role === "user") elements.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(MemoizedUserMessage, {
 				message,
@@ -8342,14 +8626,109 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		return await response.json();
 	}
 
+//#endregion
+//#region src/v2/providers/use-inspector-thread-override.ts
+	function useInspectorThreadOverride(args) {
+		const [override, setOverride] = (0, react.useState)(null);
+		const latestRef = (0, react.useRef)({
+			...args,
+			override
+		});
+		latestRef.current = {
+			...args,
+			override
+		};
+		const restoreOverride = (0, react.useCallback)((current, nextThreadId) => {
+			setOverride(null);
+			(0, _copilotkit_core.emitInspectorActiveThread)({
+				requestId: current.requestId,
+				threadId: nextThreadId,
+				agentId: current.agentId,
+				source: "app"
+			});
+		}, []);
+		const failInspectorOverride = (0, react.useCallback)((requestId) => {
+			const current = latestRef.current.override;
+			if (!current || current.requestId !== requestId) return;
+			(0, _copilotkit_core.emitInspectorViewThreadResult)({
+				requestId,
+				threadId: current.threadId,
+				agentId: current.agentId,
+				ok: false,
+				reason: "connect-failed"
+			});
+			restoreOverride(current, current.previousThreadId);
+		}, [restoreOverride]);
+		(0, react.useEffect)(() => {
+			if (!(0, _copilotkit_core.isInspectorThreadBridgeEnabled)()) return;
+			const offView = (0, _copilotkit_core.onInspectorViewThread)((payload) => {
+				const current = latestRef.current;
+				if (payload.agentId !== current.agentId) return false;
+				setOverride(current.override ? {
+					...current.override,
+					...payload
+				} : {
+					...payload,
+					previousThreadId: current.baseThreadId
+				});
+				(0, _copilotkit_core.emitInspectorViewThreadResult)({
+					...payload,
+					ok: true
+				});
+				(0, _copilotkit_core.emitInspectorActiveThread)({
+					...payload,
+					source: "override"
+				});
+				return true;
+			});
+			const offStop = (0, _copilotkit_core.onInspectorStopViewing)((payload) => {
+				const current = latestRef.current.override;
+				if (!current) return;
+				if (payload.requestId !== current.requestId) return;
+				if (payload.agentId !== current.agentId) return;
+				restoreOverride(current, current.previousThreadId);
+			});
+			return () => {
+				offView();
+				offStop();
+			};
+		}, [restoreOverride]);
+		(0, react.useEffect)(() => {
+			if (!override) return;
+			if (args.agentId !== override.agentId) {
+				restoreOverride(override, override.previousThreadId);
+				return;
+			}
+			if (args.baseThreadId === override.previousThreadId) return;
+			if (args.baseThreadId === override.threadId) return;
+			restoreOverride(override, args.baseThreadId);
+		}, [
+			args.agentId,
+			args.baseThreadId,
+			override,
+			restoreOverride
+		]);
+		return {
+			inspectorThreadId: override?.threadId ?? null,
+			inspectorRequestId: override?.requestId ?? null,
+			failInspectorOverride
+		};
+	}
+
 //#endregion
 //#region src/v2/components/chat/CopilotChat.tsx
 	function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen, attachments: attachmentsConfig, onError, throttleMs, ...props }) {
 		const existingConfig = useCopilotChatConfiguration();
 		const resolvedAgentId = agentId ?? existingConfig?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
 		const providedThreadId = threadId ?? existingConfig?.threadId;
-		const resolvedThreadId = (0, react.useMemo)(() => providedThreadId ?? (0, _copilotkit_shared.randomUUID)(), [providedThreadId]);
-		const hasExplicitThreadId = !!threadId || !!existingConfig?.hasExplicitThreadId;
+		const baseThreadId = (0, react.useMemo)(() => providedThreadId ?? (0, _copilotkit_shared.randomUUID)(), [providedThreadId]);
+		const baseHasExplicitThreadId = !!threadId || !!existingConfig?.hasExplicitThreadId;
+		const { inspectorThreadId, inspectorRequestId, failInspectorOverride } = useInspectorThreadOverride({
+			agentId: resolvedAgentId,
+			baseThreadId
+		});
+		const resolvedThreadId = inspectorThreadId ?? baseThreadId;
+		const hasExplicitThreadId = inspectorThreadId !== null || baseHasExplicitThreadId;
 		const { agent, isReady } = useAgent({
 			agentId: resolvedAgentId,
 			throttleMs
@@ -8378,6 +8757,24 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 				subscription.unsubscribe();
 			};
 		}, [copilotkit, resolvedAgentId]);
+		(0, react.useEffect)(() => {
+			if (!inspectorRequestId) return;
+			const requestId = inspectorRequestId;
+			const expectedThreadId = resolvedThreadId;
+			const subscription = copilotkit.subscribe({ onError: (event) => {
+				if (event.code !== _copilotkit_core.CopilotKitCoreErrorCode.AGENT_CONNECT_FAILED) return;
+				if (event.context?.agentId !== resolvedAgentId) return;
+				if (event.context?.threadId !== expectedThreadId) return;
+				failInspectorOverride(requestId);
+			} });
+			return () => subscription.unsubscribe();
+		}, [
+			copilotkit,
+			failInspectorOverride,
+			inspectorRequestId,
+			resolvedAgentId,
+			resolvedThreadId
+		]);
 		const [transcribeMode, setTranscribeMode] = (0, react.useState)("input");
 		const [inputValue, setInputValue] = (0, react.useState)("");
 		const [transcriptionError, setTranscriptionError] = (0, react.useState)(null);
@@ -8404,7 +8801,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		const runtimeStatus = copilotkit.runtimeConnectionStatus === _copilotkit_core.CopilotKitCoreRuntimeConnectionStatus.Connected ? "Connected" : copilotkit.runtimeConnectionStatus;
 		const hasNativeIntelligenceRunActivity = hasExplicitThreadId && runtimeStatus === "Connected" && !!copilotkit.intelligence?.wsUrl && copilotkit.threadEndpoints?.realtimeMetadata === true;
 		const [standaloneRunActivityStore] = (0, react.useState)(() => (0, _copilotkit_core.ɵcreateThreadStore)({ fetch: globalThis.fetch }));
-		const previousThreadIdRef = (0, react.useRef)(null);
+		const previousThreadRef = (0, react.useRef)(null);
 		const hasExplicitThreadIdRef = (0, react.useRef)(hasExplicitThreadId);
 		hasExplicitThreadIdRef.current = hasExplicitThreadId;
 		const rememberRecentlyLocalRunId = (0, react.useCallback)((runId) => {
@@ -8444,8 +8841,15 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			};
 		}, []);
 		(0, react.useEffect)(() => {
-			const threadChanged = previousThreadIdRef.current !== resolvedThreadId;
-			previousThreadIdRef.current = resolvedThreadId;
+			const previousThread = previousThreadRef.current;
+			const threadChanged = previousThread?.threadId !== resolvedThreadId;
+			const inspectorTransition = threadChanged && previousThread !== null && previousThread.inspectorRequestId !== inspectorRequestId && (previousThread.inspectorRequestId !== null || inspectorRequestId !== null);
+			previousThreadRef.current = {
+				threadId: resolvedThreadId,
+				inspectorRequestId
+			};
+			if (inspectorTransition) if (typeof copilotkit.stopAgent === "function") copilotkit.stopAgent({ agent });
+			else agent.abortRun?.();
 			agent.threadId = resolvedThreadId;
 			if (!hasExplicitThreadId) {
 				if (threadChanged && agent.messages.length > 0) agent.setMessages([]);
@@ -8461,6 +8865,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 				} catch (error) {
 					if (detached) return;
 					console.error("CopilotChat: connectAgent failed", error);
+					if (inspectorRequestId) failInspectorOverride(inspectorRequestId);
 				} finally {
 					if (!detached) (typeof requestAnimationFrame === "function" ? requestAnimationFrame : (cb) => setTimeout(cb, 16))(() => {
 						if (!detached) setLastConnectedThreadId(resolvedThreadId);
@@ -8486,7 +8891,9 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			resolvedThreadId,
 			agent,
 			resolvedAgentId,
-			hasExplicitThreadId
+			hasExplicitThreadId,
+			inspectorRequestId,
+			failInspectorOverride
 		]);
 		(0, react.useEffect)(() => {
 			if (!hasNativeIntelligenceRunActivity) return;
@@ -9843,7 +10250,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	});
 
 //#endregion
-//#region src/context/copilot-context.tsx
+//#region src/v1-deprecated/context/copilot-context.tsx
 	const emptyCopilotContext$1 = {
 		actions: {},
 		setAction: () => {},
@@ -9923,7 +10330,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	}
 
 //#endregion
-//#region src/hooks/use-tree.ts
+//#region src/v1-deprecated/hooks/use-tree.ts
 	const removeNode = (nodes, id) => {
 		return nodes.reduce((result, node) => {
 			if (node.id !== id) {
@@ -10036,7 +10443,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	}
 
 //#endregion
-//#region src/hooks/use-flat-category-store.ts
+//#region src/v1-deprecated/hooks/use-flat-category-store.ts
 	const useFlatCategoryStore = () => {
 		const [elements, dispatch] = (0, react.useReducer)(flatCategoryStoreReducer, /* @__PURE__ */ new Map());
 		return {
@@ -10094,7 +10501,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	}
 
 //#endregion
-//#region src/context/copilot-messages-context.tsx
+//#region src/v1-deprecated/context/copilot-messages-context.tsx
 	const emptyCopilotContext = {
 		messages: [],
 		setMessages: () => [],
@@ -10104,7 +10511,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	const CopilotMessagesContext = react.default.createContext(emptyCopilotContext);
 
 //#endregion
-//#region src/components/toast/toast-provider.tsx
+//#region src/v1-deprecated/components/toast/toast-provider.tsx
 	const ToastContext = (0, react.createContext)(void 0);
 	function getErrorSeverity(error) {
 		if (error.severity) switch (error.severity) {
@@ -10411,7 +10818,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	}
 
 //#endregion
-//#region src/utils/dev-console.ts
+//#region src/v1-deprecated/utils/dev-console.ts
 	function isLocalhost() {
 		if (typeof window === "undefined") return false;
 		return window.location.hostname === "localhost" || window.location.hostname === "127.0.0.1" || window.location.hostname === "0.0.0.0";
@@ -10422,7 +10829,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	}
 
 //#endregion
-//#region src/components/copilot-provider/copilot-messages.tsx
+//#region src/v1-deprecated/components/copilot-provider/copilot-messages.tsx
 /**
 	* An internal context to separate the messages state (which is constantly changing) from the rest of CopilotKit context
 	*/
@@ -10572,7 +10979,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	}
 
 //#endregion
-//#region src/components/usage-banner.tsx
+//#region src/v1-deprecated/components/usage-banner.tsx
 	function UsageBanner({ severity = _copilotkit_shared.Severity.CRITICAL, message = "", onClose, actions }) {
 		if (!message || !severity) return null;
 		const theme = {
@@ -10769,7 +11176,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	};
 
 //#endregion
-//#region src/lib/status-checker.ts
+//#region src/v1-deprecated/lib/status-checker.ts
 	const STATUS_CHECK_INTERVAL = 1e3 * 60 * 5;
 	var StatusChecker = class {
 		constructor() {
@@ -10791,7 +11198,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 					this.lastResponse = response;
 					onUpdate?.(response);
 					return response;
-				} catch (error) {
+				} catch {
 					return null;
 				}
 			};
@@ -10817,7 +11224,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	};
 
 //#endregion
-//#region src/components/error-boundary/error-boundary.tsx
+//#region src/v1-deprecated/components/error-boundary/error-boundary.tsx
 	const statusChecker = new StatusChecker();
 	var CopilotErrorBoundary = class extends react.default.Component {
 		constructor(props) {
@@ -10858,7 +11265,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	};
 
 //#endregion
-//#region src/context/coagent-state-renders-context.tsx
+//#region src/v1-deprecated/context/coagent-state-renders-context.tsx
 	const CoAgentStateRendersContext = (0, react.createContext)(void 0);
 	function CoAgentStateRendersProvider({ children }) {
 		const [coAgentStateRenders, setCoAgentStateRenders] = (0, react.useState)({});
@@ -10893,7 +11300,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	}
 
 //#endregion
-//#region src/context/threads-context.tsx
+//#region src/v1-deprecated/context/threads-context.tsx
 	const ThreadsContext = (0, react.createContext)(void 0);
 	function ThreadsProvider({ children, threadId: explicitThreadId }) {
 		const [internalThreadId, setInternalThreadId] = (0, react.useState)(() => (0, _copilotkit_shared.randomUUID)());
@@ -10920,7 +11327,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	}
 
 //#endregion
-//#region src/hooks/use-coagent-state-render-bridge.helpers.ts
+//#region src/v1-deprecated/hooks/use-coagent-state-render-bridge.helpers.ts
 	let RenderStatus = /* @__PURE__ */ function(RenderStatus) {
 		RenderStatus["InProgress"] = "inProgress";
 		RenderStatus["Complete"] = "complete";
@@ -11085,7 +11492,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	}
 
 //#endregion
-//#region src/hooks/use-coagent-state-render-registry.ts
+//#region src/v1-deprecated/hooks/use-coagent-state-render-registry.ts
 	const LAST_SNAPSHOTS_BY_RENDER_AND_RUN = "__lastSnapshotsByStateRenderIdAndRun";
 	const LAST_SNAPSHOTS_BY_MESSAGE = "__lastSnapshotsByMessageId";
 	function getClaimsStore(claimsRef) {
@@ -11207,7 +11614,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	}
 
 //#endregion
-//#region src/hooks/use-coagent-state-render-bridge.tsx
+//#region src/v1-deprecated/hooks/use-coagent-state-render-bridge.tsx
 	function useCoagentStateRenderBridge(agentId, props) {
 		const { stateSnapshot, message } = props;
 		const { coAgentStateRenders, claimsRef } = useCoAgentStateRenders();
@@ -11291,7 +11698,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	}
 
 //#endregion
-//#region src/components/CopilotListeners.tsx
+//#region src/v1-deprecated/components/CopilotListeners.tsx
 	const usePredictStateSubscription = (agent) => {
 		const predictStateToolsRef = (0, react.useRef)([]);
 		const getSubscriber = (0, react.useCallback)((agent) => ({
@@ -11361,7 +11768,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	}
 
 //#endregion
-//#region src/components/copilot-provider/copilotkit.tsx
+//#region src/v1-deprecated/components/copilot-provider/copilotkit.tsx
 	function CopilotKit({ children, ...props }) {
 		const enabled = shouldShowDevConsole(props.showDevConsole);
 		const showInspector = shouldShowDevConsole(props.enableInspector);
@@ -11379,7 +11786,6 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 						...v2Props,
 						showDevConsole: showInspector,
 						renderCustomMessages: renderArr,
-						useSingleEndpoint: props.useSingleEndpoint ?? true,
 						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotKitInternal, {
 							...props,
 							children