@copilotkit/react-core 1.69.0 → 1.69.1

package/dist/{copilotkit-ykQW_VJZ.mjs → copilotkit-Dr6g885f.mjs}

@@ -1,9 +1,9 @@
 import * as React$1 from "react";
 import React, { createContext, forwardRef, memo, useCallback, useContext, useEffect, useId, useImperativeHandle, useLayoutEffect, useMemo, useReducer, useRef, useState, useSyncExternalStore } from "react";
-import { CopilotKitCore, CopilotKitCoreRuntimeConnectionStatus, ProxiedCopilotRuntimeAgent, ToolCallStatus, isRunCompletionAware, ɵInterruptState, ɵcreateThreadStore, ɵselectFetchMoreError, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectIsMutating, ɵselectMemories, ɵselectMemoriesAvailable, ɵselectMemoriesError, ɵselectMemoriesIsLoading, ɵselectMemoriesRealtimeStatus, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading } from "@copilotkit/core";
+import { CopilotKitCore, CopilotKitCoreErrorCode, CopilotKitCoreRuntimeConnectionStatus, ProxiedCopilotRuntimeAgent, ToolCallStatus, emitInspectorActiveThread, emitInspectorViewThreadResult, isInspectorThreadBridgeEnabled, isRunCompletionAware, onInspectorStopViewing, onInspectorViewThread, ɵInterruptState, ɵcreateThreadStore, ɵselectFetchMoreError, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectIsMutating, ɵselectMemories, ɵselectMemoriesAvailable, ɵselectMemoriesError, ɵselectMemoriesIsLoading, ɵselectMemoriesRealtimeStatus, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading } from "@copilotkit/core";
 import { HttpAgent, randomUUID } from "@ag-ui/client";
 import { extendTailwindMerge, twMerge } from "tailwind-merge";
-import { ArrowUp, Check, ChevronDown, ChevronLeft, ChevronRight, ChevronRightIcon, Copy, Edit, Loader2, MessageCircle, Mic, PanelLeftOpen, Play, Plus, RefreshCw, Square, ThumbsDown, ThumbsUp, Upload, Volume2, X } from "lucide-react";
+import { ArrowUp, Bookmark, Check, ChevronDown, ChevronLeft, ChevronRight, ChevronRightIcon, Copy, Edit, Loader2, MessageCircle, Mic, PanelLeftOpen, Play, Plus, RefreshCw, Square, ThumbsDown, ThumbsUp, Upload, Volume2, X } from "lucide-react";
 import { A2UI_DEFAULT_DESIGN_GUIDELINES, A2UI_DEFAULT_GENERATION_GUIDELINES, COPILOT_CLOUD_API_URL, COPILOT_CLOUD_CHAT_URL, COPILOT_CLOUD_PUBLIC_API_KEY_HEADER, ConfigurationError, CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitRemoteEndpointDiscoveryError, DEFAULT_AGENT_ID, ErrorVisibility, MissingPublicApiKeyError, Severity, TranscriptionErrorCode, TranscriptionErrorCode as TranscriptionErrorCode$1, copyToClipboard, createLicenseContextValue, dataToUUID, exceedsMaxSize, formatFileSize, generateVideoThumbnail, getDocumentIcon, getModalityFromMimeType, getSourceUrl, matchesAcceptFilter, parseJson, partialJSONParse, randomId, randomUUID as randomUUID$1, readFileAsBase64, schemaToJsonSchema } from "@copilotkit/shared";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { Slot } from "@radix-ui/react-slot";
@@ -78,6 +78,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",
@@ -1530,7 +1531,8 @@ CopilotKitInspector.displayName = "CopilotKitInspector";
 //#region src/v2/components/CopilotKitInspectorContext.tsx
 const CopilotKitInspectorContext = React$1.createContext({
 	isLocalInspectorEnabled: false,
-	openInspector: () => void 0
+	openInspector: () => void 0,
+	saveEventSnippet: async () => void 0
 });
 const CopilotKitInspectorContextProvider = CopilotKitInspectorContext.Provider;
 function useCopilotKitInspector() {
@@ -2344,6 +2346,7 @@ function injectCssIntoHtml(html, css) {
 const OpenGenerativeUIActivityRendererInner = React.memo(function OpenGenerativeUIActivityRendererInner({ content }) {
 	const initialHeight = content.initialHeight ?? 200;
 	const [autoHeight, setAutoHeight] = useState(null);
+	const [sandboxReady, setSandboxReady] = useState(false);
 	const sandboxFunctions = useSandboxFunctions();
 	const localApi = useMemo(() => {
 		const api = {};
@@ -2445,6 +2448,7 @@ const OpenGenerativeUIActivityRendererInner = React.memo(function OpenGenerative
 			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; }';
@@ -2469,6 +2473,7 @@ const OpenGenerativeUIActivityRendererInner = React.memo(function OpenGenerative
 				sandboxRef.current = null;
 			}
 			sandboxReadyRef.current = false;
+			setSandboxReady(false);
 			setAutoHeight(null);
 		};
 	}, [
@@ -2499,7 +2504,7 @@ const OpenGenerativeUIActivityRendererInner = React.memo(function OpenGenerative
 	const generationDone = content.generating === false;
 	useEffect(() => {
 		const sandbox = sandboxRef.current;
-		if (!generationDone || !sandbox) return;
+		if (!generationDone || !sandboxReady || !sandbox) return;
 		let handled = false;
 		const onMessage = (e) => {
 			if (handled) return;
@@ -2528,7 +2533,7 @@ const OpenGenerativeUIActivityRendererInner = React.memo(function OpenGenerative
 		return () => {
 			window.removeEventListener("message", onMessage);
 		};
-	}, [generationDone]);
+	}, [generationDone, sandboxReady]);
 	const height = autoHeight ?? initialHeight;
 	const isGenerating = content.generating !== false;
 	return /* @__PURE__ */ jsx("div", {
@@ -3512,10 +3517,46 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 	const requestInspectorOpen = useCallback((request) => {
 		setInspectorOpenRequest({ ...request });
 	}, []);
+	const saveEventSnippet = 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 = 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));
@@ -3570,7 +3611,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 	const hasLocalAgents = mergedAgents && Object.keys(mergedAgents).length > 0;
 	const hasSelfManagedAgents = Object.keys(selfManagedAgents).length > 0;
 	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 = useMemo(() => {
@@ -5167,10 +5208,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.
@@ -5466,7 +5507,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
@@ -5892,25 +5933,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__ */ jsxs(Tooltip, { children: [/* @__PURE__ */ jsx(TooltipTrigger, {
+		asChild: true,
+		children: /* @__PURE__ */ jsx(Button, {
+			type: "button",
+			variant: "assistantMessageToolbarButton",
+			"aria-label": accessibleLabel,
+			title: accessibleLabel,
+			className,
+			...props,
+			children: /* @__PURE__ */ jsx(Bookmark, { className: "cpk:size-[18px]" })
+		})
+	}), /* @__PURE__ */ jsx(TooltipContent, {
+		side: "bottom",
+		children: /* @__PURE__ */ jsxs("div", {
+			className: "cpk:flex cpk:flex-col cpk:gap-0.5",
+			children: [/* @__PURE__ */ jsx("span", { children: primaryLabel }), /* @__PURE__ */ jsx("span", {
+				className: "cpk:text-[10px] cpk:opacity-65",
+				children: localOnlyLabel
+			})]
+		})
+	})] });
+}
+function SaveSnippetBesideChrome({ children, showSave, saveButton }) {
+	const wrapRef = useRef(null);
+	const bodyRef = useRef(null);
+	const [side, setSide] = useState("right");
+	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__ */ jsxs("div", {
+		ref: wrapRef,
+		className: SAVE_SNIPPET_BESIDE_WRAP_CLASS,
+		"data-save-snippet-side": side,
+		children: [/* @__PURE__ */ jsx("div", {
+			ref: bodyRef,
+			className: SAVE_SNIPPET_BESIDE_BODY_CLASS,
+			children
+		}), /* @__PURE__ */ 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__ */ jsx(Fragment$1, { children: message.toolCalls.map((toolCall) => {
-		const toolMessage = messages.find((m) => m.role === "tool" && m.toolCallId === toolCall.id);
-		return /* @__PURE__ */ jsx(React.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__ */ jsx(React.Fragment, { children: rendered }, toolCall.id);
+		const primaryLabel = labels.assistantMessageToolbarSaveSnippetLabel;
+		return /* @__PURE__ */ 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 = useRef(null);
+	const [showSave, setShowSave] = useState(false);
+	useLayoutEffect(() => {
+		const el = bodyRef.current;
+		setShowSave(!!el && el.childElementCount > 0);
+	});
+	return /* @__PURE__ */ jsx(SaveSnippetBesideChrome, {
+		showSave,
+		saveButton: /* @__PURE__ */ jsx(SaveSnippetIconButton, {
+			"data-testid": "copilot-tool-save-snippet-button",
+			title: label,
+			onClick: onSave
+		}),
+		children: /* @__PURE__ */ 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 () => {
@@ -5923,6 +6130,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 });
@@ -5931,6 +6149,7 @@ function CopilotChatAssistantMessage({ message, messages, isRunning, onThumbsUp,
 		children: [
 			boundCopyButton,
 			isLocalInspectorEnabled && boundInspectorButton,
+			isLocalInspectorEnabled && hasContent && boundSaveSnippetButton,
 			(onThumbsUp || thumbsUpButton) && boundThumbsUpButton,
 			(onThumbsDown || thumbsDownButton) && boundThumbsDownButton,
 			(onReadAloud || readAloudButton) && boundReadAloudButton,
@@ -5942,9 +6161,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__ */ jsx("div", {
 		"data-copilotkit": true,
 		style: { display: "contents" },
@@ -5954,6 +6172,7 @@ function CopilotChatAssistantMessage({ message, messages, isRunning, onThumbsUp,
 			toolCallsView: boundToolCallsView,
 			copyButton: boundCopyButton,
 			inspectorButton: boundInspectorButton,
+			saveSnippetButton: boundSaveSnippetButton,
 			thumbsUpButton: boundThumbsUpButton,
 			thumbsDownButton: boundThumbsDownButton,
 			readAloudButton: boundReadAloudButton,
@@ -6164,6 +6383,10 @@ function CopilotKitColoredIcon() {
 			children: /* @__PURE__ */ jsx(CopilotKitColoredIcon, {})
 		});
 	};
+	_CopilotChatAssistantMessage.SaveSnippetButton = (props) => /* @__PURE__ */ jsx(SaveSnippetIconButton, {
+		"data-testid": "copilot-save-snippet-button",
+		...props
+	});
 	_CopilotChatAssistantMessage.ThumbsUpButton = ({ title, ...props }) => {
 		const labels = useCopilotChatConfiguration()?.labels ?? CopilotChatDefaultLabels;
 		return /* @__PURE__ */ jsx(ToolbarButton, {
@@ -6205,6 +6428,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";
@@ -6575,6 +6799,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 = useRef(null);
 	const [elapsed, setElapsed] = useState(0);
 	useEffect(() => {
@@ -6634,7 +6860,16 @@ function CopilotChatReasoningMessage({ message, messages, isRunning, header, con
 		className: twMerge("cpk:my-1", className),
 		"data-message-id": message.id,
 		...props,
-		children: [boundHeader, boundToggle]
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "cpk:flex cpk:items-center cpk:gap-1",
+			children: [boundHeader, isLocalInspectorEnabled && hasContent && /* @__PURE__ */ jsx(CopilotChatAssistantMessage_default.SaveSnippetButton, { onClick: () => void saveEventSnippet({
+				kind: "reasoning",
+				messageId: message.id,
+				content: message.content ?? "",
+				threadId: chatConfiguration?.threadId,
+				agentId: chatConfiguration?.agentId
+			}) })]
+		}), boundToggle]
 	});
 }
 (function(_CopilotChatReasoningMessage) {
@@ -7153,8 +7388,33 @@ const MemoizedUserMessage = React.memo(function MemoizedUserMessage({ message, U
 /**
 * 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__ */ jsx(SaveSnippetBesideChrome, {
+		showSave: true,
+		saveButton: /* @__PURE__ */ 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.memo(function MemoizedActivityMessage({ message, renderActivityMessage }) {
-	return renderActivityMessage(message);
+	return /* @__PURE__ */ 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;
@@ -8322,14 +8582,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] = useState(null);
+	const latestRef = useRef({
+		...args,
+		override
+	});
+	latestRef.current = {
+		...args,
+		override
+	};
+	const restoreOverride = useCallback((current, nextThreadId) => {
+		setOverride(null);
+		emitInspectorActiveThread({
+			requestId: current.requestId,
+			threadId: nextThreadId,
+			agentId: current.agentId,
+			source: "app"
+		});
+	}, []);
+	const failInspectorOverride = useCallback((requestId) => {
+		const current = latestRef.current.override;
+		if (!current || current.requestId !== requestId) return;
+		emitInspectorViewThreadResult({
+			requestId,
+			threadId: current.threadId,
+			agentId: current.agentId,
+			ok: false,
+			reason: "connect-failed"
+		});
+		restoreOverride(current, current.previousThreadId);
+	}, [restoreOverride]);
+	useEffect(() => {
+		if (!isInspectorThreadBridgeEnabled()) return;
+		const offView = onInspectorViewThread((payload) => {
+			const current = latestRef.current;
+			if (payload.agentId !== current.agentId) return false;
+			setOverride(current.override ? {
+				...current.override,
+				...payload
+			} : {
+				...payload,
+				previousThreadId: current.baseThreadId
+			});
+			emitInspectorViewThreadResult({
+				...payload,
+				ok: true
+			});
+			emitInspectorActiveThread({
+				...payload,
+				source: "override"
+			});
+			return true;
+		});
+		const offStop = 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]);
+	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 ?? DEFAULT_AGENT_ID;
 	const providedThreadId = threadId ?? existingConfig?.threadId;
-	const resolvedThreadId = useMemo(() => providedThreadId ?? randomUUID$1(), [providedThreadId]);
-	const hasExplicitThreadId = !!threadId || !!existingConfig?.hasExplicitThreadId;
+	const baseThreadId = useMemo(() => providedThreadId ?? randomUUID$1(), [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
@@ -8358,6 +8713,24 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 			subscription.unsubscribe();
 		};
 	}, [copilotkit, resolvedAgentId]);
+	useEffect(() => {
+		if (!inspectorRequestId) return;
+		const requestId = inspectorRequestId;
+		const expectedThreadId = resolvedThreadId;
+		const subscription = copilotkit.subscribe({ onError: (event) => {
+			if (event.code !== 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] = useState("input");
 	const [inputValue, setInputValue] = useState("");
 	const [transcriptionError, setTranscriptionError] = useState(null);
@@ -8384,7 +8757,7 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 	const runtimeStatus = copilotkit.runtimeConnectionStatus === CopilotKitCoreRuntimeConnectionStatus.Connected ? "Connected" : copilotkit.runtimeConnectionStatus;
 	const hasNativeIntelligenceRunActivity = hasExplicitThreadId && runtimeStatus === "Connected" && !!copilotkit.intelligence?.wsUrl && copilotkit.threadEndpoints?.realtimeMetadata === true;
 	const [standaloneRunActivityStore] = useState(() => ɵcreateThreadStore({ fetch: globalThis.fetch }));
-	const previousThreadIdRef = useRef(null);
+	const previousThreadRef = useRef(null);
 	const hasExplicitThreadIdRef = useRef(hasExplicitThreadId);
 	hasExplicitThreadIdRef.current = hasExplicitThreadId;
 	const rememberRecentlyLocalRunId = useCallback((runId) => {
@@ -8424,8 +8797,15 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 		};
 	}, []);
 	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([]);
@@ -8441,6 +8821,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);
@@ -8466,7 +8847,9 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 		resolvedThreadId,
 		agent,
 		resolvedAgentId,
-		hasExplicitThreadId
+		hasExplicitThreadId,
+		inspectorRequestId,
+		failInspectorOverride
 	]);
 	useEffect(() => {
 		if (!hasNativeIntelligenceRunActivity) return;
@@ -9823,7 +10206,7 @@ const WildcardToolCallRender = defineToolCallRenderer({
 });
 
 //#endregion
-//#region src/context/copilot-context.tsx
+//#region src/v1-deprecated/context/copilot-context.tsx
 const emptyCopilotContext$1 = {
 	actions: {},
 	setAction: () => {},
@@ -9903,7 +10286,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) {
@@ -10016,7 +10399,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] = useReducer(flatCategoryStoreReducer, /* @__PURE__ */ new Map());
 	return {
@@ -10074,7 +10457,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: () => [],
@@ -10089,7 +10472,7 @@ function useCopilotMessagesContext() {
 }
 
 //#endregion
-//#region src/components/toast/toast-provider.tsx
+//#region src/v1-deprecated/components/toast/toast-provider.tsx
 const ToastContext = createContext(void 0);
 function getErrorSeverity(error) {
 	if (error.severity) switch (error.severity) {
@@ -10396,7 +10779,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";
@@ -10407,7 +10790,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
 */
@@ -10557,7 +10940,7 @@ function CopilotMessages({ children }) {
 }
 
 //#endregion
-//#region src/components/usage-banner.tsx
+//#region src/v1-deprecated/components/usage-banner.tsx
 function UsageBanner({ severity = Severity.CRITICAL, message = "", onClose, actions }) {
 	if (!message || !severity) return null;
 	const theme = {
@@ -10754,7 +11137,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() {
@@ -10776,7 +11159,7 @@ var StatusChecker = class {
 				this.lastResponse = response;
 				onUpdate?.(response);
 				return response;
-			} catch (error) {
+			} catch {
 				return null;
 			}
 		};
@@ -10802,7 +11185,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__ */ jsxs("svg", {
 	xmlns: "http://www.w3.org/2000/svg",
 	width: "24",
@@ -10837,7 +11220,7 @@ const ExclamationMarkIcon = ({ className, style }) => /* @__PURE__ */ jsxs("svg"
 });
 
 //#endregion
-//#region src/components/error-boundary/error-utils.tsx
+//#region src/v1-deprecated/components/error-boundary/error-utils.tsx
 function ErrorToast({ errors }) {
 	return /* @__PURE__ */ jsxs("div", {
 		style: {
@@ -10911,7 +11294,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.Component {
 	constructor(props) {
@@ -10952,7 +11335,7 @@ var CopilotErrorBoundary = class extends React.Component {
 };
 
 //#endregion
-//#region src/context/coagent-state-renders-context.tsx
+//#region src/v1-deprecated/context/coagent-state-renders-context.tsx
 const CoAgentStateRendersContext = createContext(void 0);
 function CoAgentStateRendersProvider({ children }) {
 	const [coAgentStateRenders, setCoAgentStateRenders] = useState({});
@@ -10987,7 +11370,7 @@ function useCoAgentStateRenders() {
 }
 
 //#endregion
-//#region src/context/threads-context.tsx
+//#region src/v1-deprecated/context/threads-context.tsx
 const ThreadsContext = createContext(void 0);
 function ThreadsProvider({ children, threadId: explicitThreadId }) {
 	const [internalThreadId, setInternalThreadId] = useState(() => randomUUID$1());
@@ -11014,7 +11397,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";
@@ -11179,7 +11562,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) {
@@ -11301,7 +11684,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();
@@ -11385,7 +11768,7 @@ function CoAgentStateRenderBridge(props) {
 }
 
 //#endregion
-//#region src/components/CopilotListeners.tsx
+//#region src/v1-deprecated/components/CopilotListeners.tsx
 const usePredictStateSubscription = (agent) => {
 	const predictStateToolsRef = useRef([]);
 	const getSubscriber = useCallback((agent) => ({
@@ -11455,7 +11838,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);
@@ -11954,4 +12337,4 @@ function validateProps(props) {
 
 //#endregion
 export { useCapabilities as $, CopilotChatMessageView as A, CopilotChatAudioRecorder as At, CopilotChatAssistantMessage_default as B, CopilotModalHeader as C, MCPAppsActivityRenderer as Ct, CopilotChat as D, useRenderToolCall as Dt, DefaultOpenIcon as E, CopilotKitInspector as Et, CopilotChatSuggestionView as F, useLearnFromUserActionInCurrentThread as G, useLearningContainersInCurrentThread as H, CopilotChatSuggestionPill as I, useThreads$1 as J, useLearnFromUserAction as K, CopilotChatReasoningMessage_default as L, IntelligenceIndicator as M, useCopilotChatConfiguration as Mt, getIntelligenceTurnAnchors as N, CopilotChatView_default as O, CopilotChatInput_default as Ot, IntelligenceIndicatorView as P, useAgentContext as Q, CopilotChatUserMessage_default as R, CopilotSidebarView as S, MCPAppsActivityContentSchema as St, DefaultCloseIcon as T, ɵrunMcpFollowUp as Tt, useLearningContainers as U, CopilotChatToolCallsView as V, useAttachments as W, useConfigureSuggestions as X, useInterrupt as Y, useSuggestions as Z, WildcardToolCallRender as _, OpenGenerativeUIActivityType as _t, ThreadsProvider as a, useComponent as at, CopilotSidebar as b, SandboxFunctionsContext as bt, CoAgentStateRendersProvider as c, useRenderCustomMessages as ct, shouldShowDevConsole as d, useLicenseContext$1 as dt, UseAgentUpdate as et, useToast as f, CopilotKitCoreReact as ft, useCopilotContext as g, OpenGenerativeUIActivityRenderer as gt, CopilotContext as h, GenerateSandboxedUiArgsSchema as ht, ThreadsContext as i, useRenderTool as it, INTELLIGENCE_TURN_HEAD as j, CopilotChatConfigurationProvider as jt, CopilotChatAttachmentQueue as k, AudioRecorderError as kt, useCoAgentStateRenders as l, CopilotKitProvider as lt, useCopilotMessagesContext as m, createA2UIMessageRenderer as mt, defaultCopilotContextCategories as n, useHumanInTheLoop as nt, useThreads as o, useFrontendTool as ot, CopilotMessagesContext as p, defineToolCallRenderer as pt, useMemories as q, CoAgentStateRenderBridge as r, useDefaultRenderTool as rt, CoAgentStateRendersContext as s, useRenderActivityMessage as st, CopilotKit as t, useAgent as tt, useAsyncCallback as u, useCopilotKit$1 as ut, CopilotThreadsDrawer as v, OpenGenerativeUIContentSchema as vt, CopilotChatToggleButton as w, MCPAppsActivityType as wt, CopilotPopupView as x, useSandboxFunctions as xt, CopilotPopup as y, OpenGenerativeUIToolRenderer as yt, CopilotChatAttachmentRenderer as z };
-//# sourceMappingURL=copilotkit-ykQW_VJZ.mjs.map
+//# sourceMappingURL=copilotkit-Dr6g885f.mjs.map