@copilotkit/react-core 1.62.2 → 1.63.0

package/dist/v2/index.umd.js

@@ -1815,6 +1815,34 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 
 //#endregion
 //#region src/v2/components/MCPAppsActivityRenderer.tsx
+/**
+	* Run an MCP app `ui/message` follow-up, scoped to the thread it was enqueued
+	* for (issue #5819).
+	*
+	* The MCP request queue delays follow-up work until the agent is idle. There is
+	* a single shared registry agent per id, and switching threads overwrites its
+	* `threadId`/`messages` in place. So if the host switches threads while a
+	* follow-up is queued, running it now would execute against — and stream into —
+	* the now-foreground thread.
+	*
+	* - **Same thread** (the common case): run on the shared agent, unchanged.
+	* - **Thread changed**: the shared agent has moved on, so the follow-up can no
+	*   longer run in its originating thread's context. Drop it rather than leak it
+	*   into the current thread. (The MCP app already received its `ui/message` ack
+	*   at enqueue time; only the optional agent turn is skipped.)
+	*
+	* @internal exported for testing.
+	*/
+	async function ɵrunMcpFollowUp({ host, agent, capturedThreadId }) {
+		const currentThreadId = agent.threadId || "default";
+		const originThreadId = capturedThreadId || "default";
+		if (currentThreadId === originThreadId) return host.runAgent({ agent });
+		console.warn(`[MCPAppsRenderer] ui/message follow-up dropped: the thread changed (${originThreadId} → ${currentThreadId}) between enqueue and execution, so running it would leak into the now-foreground thread.`);
+		return {
+			result: void 0,
+			newMessages: []
+		};
+	}
 	const PROTOCOL_VERSION = "2025-06-18";
 	function buildSandboxHTML(extraCspDomains) {
 		const baseScriptSrc = "'self' 'wasm-unsafe-eval' 'unsafe-inline' 'unsafe-eval' blob: data: http://localhost:* https://localhost:*";
@@ -2137,7 +2165,14 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 										content: textContent
 									});
 									sendResponse(msg.id, { isError: false });
-									if ((params.followUp ?? role === "user") && textContent) mcpAppsRequestQueue.enqueue(currentAgent, () => copilotkit.runAgent({ agent: currentAgent })).catch((err) => console.error("[MCPAppsRenderer] ui/message agent run failed:", err));
+									if ((params.followUp ?? role === "user") && textContent) {
+										const capturedThreadId = currentAgent.threadId || "default";
+										mcpAppsRequestQueue.enqueue(currentAgent, () => ɵrunMcpFollowUp({
+											host: copilotkit,
+											agent: currentAgent,
+											capturedThreadId
+										})).catch((err) => console.error("[MCPAppsRenderer] ui/message agent run failed:", err));
+									}
 								} catch (err) {
 									console.error("[MCPAppsRenderer] ui/message error:", err);
 									sendResponse(msg.id, { isError: true });
@@ -3620,6 +3655,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		if (copilotkitRef.current === null) {
 			copilotkitRef.current = new CopilotKitCoreReact({
 				runtimeUrl: chatApiEndpoint,
+				deferInitialConnection: true,
 				runtimeTransport: useSingleEndpoint === true ? "single" : useSingleEndpoint === false ? "rest" : "auto",
 				headers: mergedHeaders,
 				credentials,
@@ -3703,6 +3739,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			} : properties);
 			copilotkit.setAgents__unsafe_dev_only(mergedAgents);
 			copilotkit.setDebug(debug);
+			copilotkit.connect();
 		}, [
 			copilotkit,
 			chatApiEndpoint,
@@ -4367,57 +4404,58 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		UseAgentUpdate.OnRunStatusChanged
 	];
 	function useAgent({ agentId, updates, throttleMs } = {}) {
-		agentId ?? (agentId = _copilotkit_shared.DEFAULT_AGENT_ID);
+		const chatConfig = useCopilotChatConfiguration();
+		const resolvedAgentId = agentId ?? chatConfig?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
 		const { copilotkit } = useCopilotKit();
 		const providerThrottleMs = copilotkit.defaultThrottleMs;
 		const [, forceUpdate] = (0, react.useReducer)((x) => x + 1, 0);
 		const updateFlags = (0, react.useMemo)(() => updates ?? ALL_UPDATES, [JSON.stringify(updates)]);
 		const provisionalAgentCache = (0, react.useRef)(/* @__PURE__ */ new Map());
 		const agent = (0, react.useMemo)(() => {
-			const existing = copilotkit.getAgent(agentId);
+			const existing = copilotkit.getAgent(resolvedAgentId);
 			if (existing) {
-				provisionalAgentCache.current.delete(agentId);
+				provisionalAgentCache.current.delete(resolvedAgentId);
 				return existing;
 			}
 			const isRuntimeConfigured = copilotkit.runtimeUrl !== void 0;
 			const status = copilotkit.runtimeConnectionStatus;
 			if (isRuntimeConfigured && (status === _copilotkit_core.CopilotKitCoreRuntimeConnectionStatus.Disconnected || status === _copilotkit_core.CopilotKitCoreRuntimeConnectionStatus.Connecting)) {
-				const cached = provisionalAgentCache.current.get(agentId);
+				const cached = provisionalAgentCache.current.get(resolvedAgentId);
 				if (cached) {
 					copilotkit.applyHeadersToAgent(cached);
 					return cached;
 				}
 				const provisional = new _copilotkit_core.ProxiedCopilotRuntimeAgent({
 					runtimeUrl: copilotkit.runtimeUrl,
-					agentId,
+					agentId: resolvedAgentId,
 					transport: copilotkit.runtimeTransport,
 					runtimeMode: "pending"
 				});
 				copilotkit.applyHeadersToAgent(provisional);
-				provisionalAgentCache.current.set(agentId, provisional);
+				provisionalAgentCache.current.set(resolvedAgentId, provisional);
 				return provisional;
 			}
 			if (isRuntimeConfigured && status === _copilotkit_core.CopilotKitCoreRuntimeConnectionStatus.Error) {
-				const cached = provisionalAgentCache.current.get(agentId);
+				const cached = provisionalAgentCache.current.get(resolvedAgentId);
 				if (cached) {
 					copilotkit.applyHeadersToAgent(cached);
 					return cached;
 				}
 				const provisional = new _copilotkit_core.ProxiedCopilotRuntimeAgent({
 					runtimeUrl: copilotkit.runtimeUrl,
-					agentId,
+					agentId: resolvedAgentId,
 					transport: copilotkit.runtimeTransport,
 					runtimeMode: "pending"
 				});
 				copilotkit.applyHeadersToAgent(provisional);
-				provisionalAgentCache.current.set(agentId, provisional);
+				provisionalAgentCache.current.set(resolvedAgentId, provisional);
 				return provisional;
 			}
 			const knownAgents = Object.keys(copilotkit.agents ?? {});
 			const runtimePart = isRuntimeConfigured ? `runtimeUrl=${copilotkit.runtimeUrl}` : "no runtimeUrl";
-			throw new Error(`useAgent: Agent '${agentId}' not found after runtime sync (${runtimePart}). ` + (knownAgents.length ? `Known agents: [${knownAgents.join(", ")}]` : "No agents registered.") + " Verify your runtime /info and/or agents__unsafe_dev_only.");
+			throw new Error(`useAgent: Agent '${resolvedAgentId}' not found after runtime sync (${runtimePart}). ` + (knownAgents.length ? `Known agents: [${knownAgents.join(", ")}]` : "No agents registered.") + " Verify your runtime /info and/or agents__unsafe_dev_only.");
 		}, [
-			agentId,
+			resolvedAgentId,
 			copilotkit.agents,
 			copilotkit.runtimeConnectionStatus,
 			copilotkit.runtimeUrl,
@@ -4462,7 +4500,6 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		(0, react.useEffect)(() => {
 			if (agent instanceof _ag_ui_client.HttpAgent) copilotkit.applyHeadersToAgent(agent);
 		}, [agent, JSON.stringify(copilotkit.headers)]);
-		const chatConfig = useCopilotChatConfiguration();
 		const configThreadId = chatConfig?.threadId;
 		const configHasExplicitThreadId = chatConfig?.hasExplicitThreadId;
 		(0, react.useEffect)(() => {
@@ -4479,13 +4516,15 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 //#endregion
 //#region src/v2/hooks/use-capabilities.tsx
 /**
-	* Returns the capabilities declared by the given agent (or the default agent).
+	* Returns the capabilities declared by the given agent (or the agent resolved
+	* from the surrounding chat configuration, falling back to the default agent).
 	* Capabilities are populated from the runtime `/info` response at connection
 	* time. The hook reads them synchronously from the agent instance — there is
 	* no separate loading state, but the value will be `undefined` until the
 	* runtime handshake completes.
 	*
-	* @param agentId - Optional agent ID. If omitted, uses the default agent.
+	* @param agentId - Optional agent ID. If omitted, inherits the surrounding
+	*          chat configuration's agent, falling back to the default agent.
 	* @returns The agent's capabilities, or `undefined` if the agent doesn't
 	*          declare capabilities.
 	*/
@@ -5058,6 +5097,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		})), [coreThreads]);
 		const storeIsLoading = useThreadStoreSelector(store, _copilotkit_core.ɵselectThreadsIsLoading);
 		const storeError = useThreadStoreSelector(store, _copilotkit_core.ɵselectThreadsError);
+		const fetchMoreError = useThreadStoreSelector(store, _copilotkit_core.ɵselectFetchMoreError);
 		const hasMoreThreads = useThreadStoreSelector(store, _copilotkit_core.ɵselectHasNextPage);
 		const isFetchingMoreThreads = useThreadStoreSelector(store, _copilotkit_core.ɵselectIsFetchingNextPage);
 		const isMutating = useThreadStoreSelector(store, _copilotkit_core.ɵselectIsMutating);
@@ -5163,6 +5203,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			isLoading,
 			error,
 			listError,
+			fetchMoreError,
 			hasMoreThreads,
 			isFetchingMoreThreads,
 			isMutating,
@@ -5179,6 +5220,70 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		};
 	}
 
+//#endregion
+//#region src/v2/hooks/use-memories.tsx
+	function useMemoryStoreSelector(store, selector) {
+		return (0, react.useSyncExternalStore)((0, react.useCallback)((onStoreChange) => {
+			const subscription = store.select(selector).subscribe(onStoreChange);
+			return () => subscription.unsubscribe();
+		}, [store, selector]), () => selector(store.getState()), () => selector(store.getServerState()));
+	}
+	/**
+	* React hook for listing and managing platform memories.
+	*
+	* Reads the memory store owned and wired by `CopilotKitCore`. On mount the
+	* hook exposes the live list plus stable `addMemory` / `updateMemory` /
+	* `removeMemory` / `refresh` callbacks. Mutations are server-authoritative:
+	* each resolves once the platform confirms the operation and rejects with an
+	* `Error` on failure.
+	*
+	* Realtime updates are automatic: the core's memory store opens its own
+	* `user_meta:memories:<joinCode>` channel and applies `memory_metadata` deltas
+	* to the list. You can still call `refresh()` to re-pull the REST snapshot on
+	* demand.
+	*
+	* @returns Memory list state and stable mutation callbacks.
+	*
+	* @example
+	* ```tsx
+	* import { useMemories } from "@copilotkit/react-core";
+	*
+	* function MemoryList() {
+	*   const { memories, isLoading, isAvailable, addMemory, removeMemory } =
+	*     useMemories();
+	*
+	*   if (!isAvailable) return null;
+	*   if (isLoading) return <p>Loading…</p>;
+	*
+	*   return (
+	*     <ul>
+	*       {memories.map((m) => (
+	*         <li key={m.id}>
+	*           {m.content}
+	*           <button onClick={() => removeMemory(m.id)}>Delete</button>
+	*         </li>
+	*       ))}
+	*     </ul>
+	*   );
+	* }
+	* ```
+	*/
+	function useMemories() {
+		const { copilotkit } = useCopilotKit();
+		const store = copilotkit.getMemoryStore();
+		return {
+			memories: useMemoryStoreSelector(store, _copilotkit_core.ɵselectMemories),
+			isLoading: useMemoryStoreSelector(store, _copilotkit_core.ɵselectMemoriesIsLoading),
+			error: useMemoryStoreSelector(store, _copilotkit_core.ɵselectMemoriesError),
+			isAvailable: useMemoryStoreSelector(store, _copilotkit_core.ɵselectMemoriesAvailable),
+			realtimeStatus: useMemoryStoreSelector(store, _copilotkit_core.ɵselectMemoriesRealtimeStatus),
+			refresh: (0, react.useCallback)(() => store.refresh(), [store]),
+			addMemory: (0, react.useCallback)((input) => store.addMemory(input), [store]),
+			updateMemory: (0, react.useCallback)((id, changes) => store.updateMemory(id, changes), [store]),
+			removeMemory: (0, react.useCallback)((id) => store.removeMemory(id), [store])
+		};
+	}
+
 //#endregion
 //#region src/v2/lib/record-annotation.ts
 /**
@@ -9040,7 +9145,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	*   during prerender to avoid hydration mismatch).
 	* - Feeds the element domain data: `threads`, `loading`, `error`,
 	*   `activeThreadId`, `licensed`, fetch-more state.
-	* - Routes the element's nine outbound events to core thread operations
+	* - Routes the element's outbound events to core thread operations
 	*   ({@link useThreads}) and chat-configuration changes.
 	* - Registers with the surrounding chat configuration so the header
 	*   thread-list launcher appears, and binds the element `open` state to the
@@ -9067,16 +9172,16 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 	* </CopilotKitProvider>
 	* ```
 	*/
-	function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed, licenseUrl, renderRow, label, limit, "data-testid": dataTestId = "copilot-threads-drawer" }) {
+	function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed, licenseUrl, renderRow, label, recentLabel, collapsible, onCollapseChange, limit, "data-testid": dataTestId = "copilot-threads-drawer" }) {
 		const configuration = useCopilotChatConfiguration();
 		const { status, checkFeature } = useLicenseContext();
 		const licensePresent = status === "valid" || status === "expiring";
 		const featureLicensed = checkFeature("threads");
 		const licensed = licensePresent && featureLicensed;
 		const licensePending = status === null;
-		const resolvedAgentId = agentId ?? configuration?.agentId ?? "default";
+		const resolvedAgentId = agentId ?? configuration?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
 		const activeThreadId = configuration?.threadId ?? null;
-		const { threads, isLoading, listError, hasMoreThreads, isFetchingMoreThreads, archiveThread, unarchiveThread, deleteThread, fetchMoreThreads, refetchThreads, startNewThread } = useThreads({
+		const { threads, isLoading, listError, fetchMoreError, hasMoreThreads, isFetchingMoreThreads, archiveThread, unarchiveThread, deleteThread, fetchMoreThreads, refetchThreads, startNewThread } = useThreads({
 			agentId: resolvedAgentId,
 			includeArchived: true,
 			enabled: licensed,
@@ -9157,6 +9262,9 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		const handleLoadMore = (0, react.useCallback)(() => {
 			fetchMoreThreads();
 		}, [fetchMoreThreads]);
+		const handleCollapseChange = (0, react.useCallback)((collapsed) => {
+			onCollapseChange?.(collapsed);
+		}, [onCollapseChange]);
 		const handlersRef = (0, react.useRef)({
 			handleThreadSelected,
 			handleNewThread,
@@ -9167,7 +9275,8 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			handleRetry,
 			handleOpenChange,
 			handleLicensed,
-			handleLoadMore
+			handleLoadMore,
+			handleCollapseChange
 		});
 		handlersRef.current = {
 			handleThreadSelected,
@@ -9179,7 +9288,8 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			handleRetry,
 			handleOpenChange,
 			handleLicensed,
-			handleLoadMore
+			handleLoadMore,
+			handleCollapseChange
 		};
 		(0, react.useEffect)(() => {
 			const el = elementRef.current;
@@ -9214,6 +9324,10 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			};
 			const onLicensedEvent = () => handlersRef.current.handleLicensed();
 			const onLoadMore = () => handlersRef.current.handleLoadMore();
+			const onCollapseChangeEvent = (event) => {
+				const detail = event.detail;
+				handlersRef.current.handleCollapseChange(detail.collapsed);
+			};
 			el.addEventListener("thread-selected", onThreadSelected);
 			el.addEventListener("new-thread", onNewThreadEvent);
 			el.addEventListener("archive", onArchive);
@@ -9224,6 +9338,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			el.addEventListener("retry", onRetry);
 			el.addEventListener("licensed", onLicensedEvent);
 			el.addEventListener("load-more", onLoadMore);
+			el.addEventListener("collapse-change", onCollapseChangeEvent);
 			return () => {
 				el.removeEventListener("thread-selected", onThreadSelected);
 				el.removeEventListener("new-thread", onNewThreadEvent);
@@ -9235,6 +9350,7 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 				el.removeEventListener("retry", onRetry);
 				el.removeEventListener("licensed", onLicensedEvent);
 				el.removeEventListener("load-more", onLoadMore);
+				el.removeEventListener("collapse-change", onCollapseChangeEvent);
 			};
 		}, [mounted]);
 		(0, react.useEffect)(() => {
@@ -9251,9 +9367,11 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			el.licensed = licensed || licensePending;
 			el.hasMore = hasMoreThreads;
 			el.fetchingMore = isFetchingMoreThreads;
+			el.fetchMoreError = fetchMoreError ? fetchMoreError.message : null;
 		}, [
 			isLoading,
 			listError,
+			fetchMoreError,
 			activeThreadId,
 			licensed,
 			licensePending,
@@ -9276,6 +9394,11 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 			if (!el) return;
 			if (licenseUrl !== void 0) el.licenseUrl = licenseUrl;
 		}, [licenseUrl, mounted]);
+		(0, react.useEffect)(() => {
+			const el = elementRef.current;
+			if (!el) return;
+			if (collapsible !== void 0) el.collapsible = collapsible;
+		}, [collapsible, mounted]);
 		const rowChildren = (0, react.useMemo)(() => {
 			if (!renderRow) return null;
 			return drawerThreads.map((drawerThread) => {
@@ -9296,7 +9419,8 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		if (!mounted) return null;
 		return react.default.createElement(_copilotkit_web_components_threads_drawer.COPILOTKIT_THREADS_DRAWER_TAG, {
 			ref: elementRef,
-			"data-testid": dataTestId
+			"data-testid": dataTestId,
+			...recentLabel !== void 0 ? { "recent-label": recentLabel } : {}
 		}, rowChildren);
 	}
 	CopilotThreadsDrawer.displayName = "CopilotThreadsDrawer";
@@ -10835,8 +10959,18 @@ window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-
 		}, [agent, getSubscriber]);
 	};
 	function CopilotListenersAgentSubscription() {
-		const resolvedAgentId = useCopilotChatConfiguration()?.agentId;
-		const { agent } = useAgent({ agentId: resolvedAgentId });
+		const { copilotkit } = useCopilotKit();
+		const configAgentId = useCopilotChatConfiguration()?.agentId;
+		const { agent } = useAgent({ agentId: (0, react.useMemo)(() => {
+			const requested = configAgentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
+			const registered = copilotkit.agents ?? {};
+			if (registered[requested]) return requested;
+			if (requested === _copilotkit_shared.DEFAULT_AGENT_ID) {
+				const firstRegistered = Object.keys(registered)[0];
+				if (firstRegistered) return firstRegistered;
+			}
+			return requested;
+		}, [configAgentId, copilotkit.agents]) });
 		usePredictStateSubscription(agent);
 		return null;
 	}
@@ -11417,12 +11551,17 @@ Object.defineProperty(exports, 'CopilotSidebarView', {
   }
 });
 exports.CopilotThreadsDrawer = CopilotThreadsDrawer;
+exports.GenerateSandboxedUiArgsSchema = GenerateSandboxedUiArgsSchema;
 exports.INTELLIGENCE_TURN_HEAD = INTELLIGENCE_TURN_HEAD;
 exports.IntelligenceIndicator = IntelligenceIndicator;
 exports.IntelligenceIndicatorView = IntelligenceIndicatorView;
 exports.MCPAppsActivityContentSchema = MCPAppsActivityContentSchema;
 exports.MCPAppsActivityRenderer = MCPAppsActivityRenderer;
 exports.MCPAppsActivityType = MCPAppsActivityType;
+exports.OpenGenerativeUIActivityRenderer = OpenGenerativeUIActivityRenderer;
+exports.OpenGenerativeUIActivityType = OpenGenerativeUIActivityType;
+exports.OpenGenerativeUIContentSchema = OpenGenerativeUIContentSchema;
+exports.OpenGenerativeUIToolRenderer = OpenGenerativeUIToolRenderer;
 exports.SandboxFunctionsContext = SandboxFunctionsContext;
 exports.UseAgentUpdate = UseAgentUpdate;
 exports.WildcardToolCallRender = WildcardToolCallRender;
@@ -11451,6 +11590,7 @@ exports.useLearnFromUserAction = useLearnFromUserAction;
 exports.useLearnFromUserActionInCurrentThread = useLearnFromUserActionInCurrentThread;
 exports.useLearningContainers = useLearningContainers;
 exports.useLearningContainersInCurrentThread = useLearningContainersInCurrentThread;
+exports.useMemories = useMemories;
 exports.useRenderActivityMessage = useRenderActivityMessage;
 exports.useRenderCustomMessages = useRenderCustomMessages;
 exports.useRenderTool = useRenderTool;
@@ -11458,6 +11598,7 @@ exports.useRenderToolCall = useRenderToolCall;
 exports.useSandboxFunctions = useSandboxFunctions;
 exports.useSuggestions = useSuggestions;
 exports.useThreads = useThreads;
+exports.ɵrunMcpFollowUp = ɵrunMcpFollowUp;
 Object.keys(_copilotkit_core).forEach(function (k) {
   if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
     enumerable: true,