@copilotkit/react-core 1.69.0 → 1.69.1

package/dist/{copilotkit-DOMr3DRO.cjs → copilotkit-Dr0speVK.cjs}

@@ -108,6 +108,7 @@ const CopilotChatDefaultLabels = {
 	assistantMessageToolbarCopyMessageLabel: "Copy",
 	assistantMessageToolbarInspectorLabel: "View in Inspector",
 	assistantMessageToolbarInspectorLocalOnlyLabel: "Local Only",
+	assistantMessageToolbarSaveSnippetLabel: "Save as snippet",
 	assistantMessageToolbarThumbsUpLabel: "Good response",
 	assistantMessageToolbarThumbsDownLabel: "Bad response",
 	assistantMessageToolbarReadAloudLabel: "Read aloud",
@@ -1560,7 +1561,8 @@ CopilotKitInspector.displayName = "CopilotKitInspector";
 //#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() {
@@ -2374,6 +2376,7 @@ function injectCssIntoHtml(html, css) {
 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 = {};
@@ -2475,6 +2478,7 @@ const OpenGenerativeUIActivityRendererInner = react.default.memo(function OpenGe
 			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; }';
@@ -2499,6 +2503,7 @@ const OpenGenerativeUIActivityRendererInner = react.default.memo(function OpenGe
 				sandboxRef.current = null;
 			}
 			sandboxReadyRef.current = false;
+			setSandboxReady(false);
 			setAutoHeight(null);
 		};
 	}, [
@@ -2529,7 +2534,7 @@ const OpenGenerativeUIActivityRendererInner = react.default.memo(function OpenGe
 	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;
@@ -2558,7 +2563,7 @@ const OpenGenerativeUIActivityRendererInner = react.default.memo(function OpenGe
 		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", {
@@ -3542,10 +3547,46 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 	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));
@@ -3600,7 +3641,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 	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)(() => {
@@ -5197,10 +5238,10 @@ function useThreadStoreSelector(store, selector) {
 	}, [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.
@@ -5496,7 +5537,7 @@ async function recordAnnotation(args) {
 //#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
@@ -5922,25 +5963,191 @@ function useLearningContainersInCurrentThread({ learningContainers }) {
 	});
 }
 
+//#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 () => {
@@ -5953,6 +6160,17 @@ function CopilotChatAssistantMessage({ message, messages, isRunning, onThumbsUp,
 		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 });
@@ -5961,6 +6179,7 @@ function CopilotChatAssistantMessage({ message, messages, isRunning, onThumbsUp,
 		children: [
 			boundCopyButton,
 			isLocalInspectorEnabled && boundInspectorButton,
+			isLocalInspectorEnabled && hasContent && boundSaveSnippetButton,
 			(onThumbsUp || thumbsUpButton) && boundThumbsUpButton,
 			(onThumbsDown || thumbsDownButton) && boundThumbsDownButton,
 			(onReadAloud || readAloudButton) && boundReadAloudButton,
@@ -5972,9 +6191,8 @@ function CopilotChatAssistantMessage({ message, messages, isRunning, onThumbsUp,
 		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" },
@@ -5984,6 +6202,7 @@ function CopilotChatAssistantMessage({ message, messages, isRunning, onThumbsUp,
 			toolCallsView: boundToolCallsView,
 			copyButton: boundCopyButton,
 			inspectorButton: boundInspectorButton,
+			saveSnippetButton: boundSaveSnippetButton,
 			thumbsUpButton: boundThumbsUpButton,
 			thumbsDownButton: boundThumbsDownButton,
 			readAloudButton: boundReadAloudButton,
@@ -6194,6 +6413,10 @@ function CopilotKitColoredIcon() {
 			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, {
@@ -6235,6 +6458,7 @@ CopilotChatAssistantMessage.MarkdownRenderer.displayName = "CopilotChatAssistant
 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";
@@ -6605,6 +6829,8 @@ function CopilotChatReasoningMessage({ message, messages, isRunning, header, con
 	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)(() => {
@@ -6664,7 +6890,16 @@ function CopilotChatReasoningMessage({ message, messages, isRunning, header, con
 		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) {
@@ -7183,8 +7418,33 @@ const MemoizedUserMessage = react.default.memo(function MemoizedUserMessage({ me
 /**
 * 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;
@@ -8352,14 +8612,109 @@ async function transcribeAudio(core, audioBlob, filename = "recording.webm") {
 	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
@@ -8388,6 +8743,24 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 			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);
@@ -8414,7 +8787,7 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 	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) => {
@@ -8454,8 +8827,15 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 		};
 	}, []);
 	(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([]);
@@ -8471,6 +8851,7 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 			} 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);
@@ -8496,7 +8877,9 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 		resolvedThreadId,
 		agent,
 		resolvedAgentId,
-		hasExplicitThreadId
+		hasExplicitThreadId,
+		inspectorRequestId,
+		failInspectorOverride
 	]);
 	(0, react.useEffect)(() => {
 		if (!hasNativeIntelligenceRunActivity) return;
@@ -9853,7 +10236,7 @@ const WildcardToolCallRender = defineToolCallRenderer({
 });
 
 //#endregion
-//#region src/context/copilot-context.tsx
+//#region src/v1-deprecated/context/copilot-context.tsx
 const emptyCopilotContext$1 = {
 	actions: {},
 	setAction: () => {},
@@ -9933,7 +10316,7 @@ function returnAndThrowInDebug(_value) {
 }
 
 //#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) {
@@ -10046,7 +10429,7 @@ function setsHaveIntersection$1(setA, setB) {
 }
 
 //#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 {
@@ -10104,7 +10487,7 @@ function setsHaveIntersection(setA, setB) {
 }
 
 //#endregion
-//#region src/context/copilot-messages-context.tsx
+//#region src/v1-deprecated/context/copilot-messages-context.tsx
 const emptyCopilotContext = {
 	messages: [],
 	setMessages: () => [],
@@ -10119,7 +10502,7 @@ function useCopilotMessagesContext() {
 }
 
 //#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) {
@@ -10426,7 +10809,7 @@ function ToastProvider({ enabled, children }) {
 }
 
 //#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";
@@ -10437,7 +10820,7 @@ function shouldShowDevConsole(showDevConsole) {
 }
 
 //#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
 */
@@ -10587,7 +10970,7 @@ function CopilotMessages({ children }) {
 }
 
 //#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 = {
@@ -10784,7 +11167,7 @@ const getErrorActions = (error) => {
 };
 
 //#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() {
@@ -10806,7 +11189,7 @@ var StatusChecker = class {
 				this.lastResponse = response;
 				onUpdate?.(response);
 				return response;
-			} catch (error) {
+			} catch {
 				return null;
 			}
 		};
@@ -10832,7 +11215,7 @@ var StatusChecker = class {
 };
 
 //#endregion
-//#region src/components/toast/exclamation-mark-icon.tsx
+//#region src/v1-deprecated/components/toast/exclamation-mark-icon.tsx
 const ExclamationMarkIcon = ({ className, style }) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
 	xmlns: "http://www.w3.org/2000/svg",
 	width: "24",
@@ -10867,7 +11250,7 @@ const ExclamationMarkIcon = ({ className, style }) => /* @__PURE__ */ (0, react_
 });
 
 //#endregion
-//#region src/components/error-boundary/error-utils.tsx
+//#region src/v1-deprecated/components/error-boundary/error-utils.tsx
 function ErrorToast({ errors }) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		style: {
@@ -10941,7 +11324,7 @@ function useAsyncCallback(callback, deps) {
 }
 
 //#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) {
@@ -10982,7 +11365,7 @@ var CopilotErrorBoundary = class extends react.default.Component {
 };
 
 //#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)({});
@@ -11017,7 +11400,7 @@ function useCoAgentStateRenders() {
 }
 
 //#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)());
@@ -11044,7 +11427,7 @@ function useThreads() {
 }
 
 //#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";
@@ -11209,7 +11592,7 @@ function selectSnapshot({ messageId, messageName, allowLiveState, skipLatestCach
 }
 
 //#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) {
@@ -11331,7 +11714,7 @@ function useStateRenderRegistry({ agentId, stateRenderId, message, messageIndex,
 }
 
 //#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();
@@ -11415,7 +11798,7 @@ function CoAgentStateRenderBridge(props) {
 }
 
 //#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) => ({
@@ -11485,7 +11868,7 @@ function CopilotListeners() {
 }
 
 //#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);
@@ -12493,4 +12876,4 @@ Object.defineProperty(exports, 'ɵrunMcpFollowUp', {
     return ɵrunMcpFollowUp;
   }
 });
-//# sourceMappingURL=copilotkit-DOMr3DRO.cjs.map
+//# sourceMappingURL=copilotkit-Dr0speVK.cjs.map