@copilotkit/react-core 1.69.0 → 1.69.2

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

@@ -3600,7 +3600,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 +5197,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 +5496,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
@@ -5974,7 +5974,7 @@ function CopilotChatAssistantMessage({ message, messages, isRunning, onThumbsUp,
 	});
 	const hasContent = !!(message.content && message.content.trim().length > 0);
 	const isLatestAssistantMessage = message.role === "assistant" && messages?.[messages.length - 1]?.id === message.id;
-	const shouldShowToolbar = toolbarVisible && hasContent && !(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" },
@@ -6130,7 +6130,7 @@ function CopilotKitColoredIcon() {
 		className: (0, tailwind_merge.twMerge)("cpk:w-full cpk:bg-transparent cpk:flex cpk:items-center cpk:-ml-[5px] cpk:-mt-[0px]", className),
 		...props
 	});
-	const ToolbarButton = _CopilotChatAssistantMessage.ToolbarButton = ({ title, tooltip, children, ...props }) => {
+	const ToolbarButton = _CopilotChatAssistantMessage.ToolbarButton = ({ title, tooltip, tooltipClassName, children, ...props }) => {
 		return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(Tooltip, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TooltipTrigger, {
 			asChild: true,
 			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Button, {
@@ -6142,6 +6142,7 @@ function CopilotKitColoredIcon() {
 			})
 		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TooltipContent, {
 			side: "bottom",
+			className: tooltipClassName,
 			children: tooltip ?? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: title })
 		})] });
 	};
@@ -6175,23 +6176,28 @@ function CopilotKitColoredIcon() {
 			children: copied ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(lucide_react.Check, { className: "cpk:size-[18px]" }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(lucide_react.Copy, { className: "cpk:size-[18px]" })
 		});
 	};
-	_CopilotChatAssistantMessage.InspectorButton = ({ title, ...props }) => {
+	_CopilotChatAssistantMessage.InspectorButton = ({ title, className, ...props }) => {
 		const labels = useCopilotChatConfiguration()?.labels ?? CopilotChatDefaultLabels;
 		const primaryLabel = title || labels.assistantMessageToolbarInspectorLabel;
-		const localOnlyLabel = labels.assistantMessageToolbarInspectorLocalOnlyLabel;
-		const accessibleLabel = `${primaryLabel} (${localOnlyLabel})`;
-		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolbarButton, {
+		const accessibleLabel = `${primaryLabel} (local only)`;
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(ToolbarButton, {
 			"data-testid": "copilot-inspector-button",
 			title: accessibleLabel,
-			tooltip: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-				className: "cpk:flex cpk:flex-col cpk:gap-0.5",
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: primaryLabel }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-					className: "cpk:text-[10px] cpk:opacity-65",
-					children: localOnlyLabel
-				})]
-			}),
+			className: (0, tailwind_merge.twMerge)("cpk:w-auto cpk:gap-1.5 cpk:px-2", className),
+			tooltipClassName: "cpk:max-w-64 cpk:text-left cpk:leading-4",
+			tooltip: "View this message in the Inspector to get more information. This button and the inspector only display during local development (localhost, dev env).",
 			...props,
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotKitColoredIcon, {})
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotKitColoredIcon, {}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: "cpk:font-medium",
+					children: primaryLabel
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: "cpk:text-xs cpk:text-muted-foreground",
+					children: "(local only)"
+				})
+			]
 		});
 	};
 	_CopilotChatAssistantMessage.ThumbsUpButton = ({ title, ...props }) => {
@@ -8352,14 +8358,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 +8489,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 +8533,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 +8573,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 +8597,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 +8623,9 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 		resolvedThreadId,
 		agent,
 		resolvedAgentId,
-		hasExplicitThreadId
+		hasExplicitThreadId,
+		inspectorRequestId,
+		failInspectorOverride
 	]);
 	(0, react.useEffect)(() => {
 		if (!hasNativeIntelligenceRunActivity) return;
@@ -9853,7 +9982,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 +10062,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 +10175,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 +10233,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 +10248,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 +10555,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 +10566,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 +10716,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 +10913,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 +10935,7 @@ var StatusChecker = class {
 				this.lastResponse = response;
 				onUpdate?.(response);
 				return response;
-			} catch (error) {
+			} catch {
 				return null;
 			}
 		};
@@ -10832,7 +10961,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 +10996,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 +11070,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 +11111,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 +11146,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 +11173,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 +11338,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 +11460,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 +11544,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 +11614,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 +12622,4 @@ Object.defineProperty(exports, 'ɵrunMcpFollowUp', {
     return ɵrunMcpFollowUp;
   }
 });
-//# sourceMappingURL=copilotkit-DOMr3DRO.cjs.map
+//# sourceMappingURL=copilotkit-Ba7qwYt3.cjs.map