@copilotkit/react-core 1.62.2 → 1.63.0

package/dist/{copilotkit-lHheGQWt.cjs → copilotkit-nu7NwzH6.cjs}

@@ -1830,6 +1830,34 @@ function InlineFeatureWarning({ featureName }) {
 
 //#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:*";
@@ -2152,7 +2180,14 @@ const MCPAppsActivityRenderer = function MCPAppsActivityRenderer({ content, agen
 									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 });
@@ -3635,6 +3670,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 	if (copilotkitRef.current === null) {
 		copilotkitRef.current = new CopilotKitCoreReact({
 			runtimeUrl: chatApiEndpoint,
+			deferInitialConnection: true,
 			runtimeTransport: useSingleEndpoint === true ? "single" : useSingleEndpoint === false ? "rest" : "auto",
 			headers: mergedHeaders,
 			credentials,
@@ -3718,6 +3754,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 		} : properties);
 		copilotkit.setAgents__unsafe_dev_only(mergedAgents);
 		copilotkit.setDebug(debug);
+		copilotkit.connect();
 	}, [
 		copilotkit,
 		chatApiEndpoint,
@@ -4382,57 +4419,58 @@ const ALL_UPDATES = [
 	UseAgentUpdate.OnRunStatusChanged
 ];
 function useAgent({ agentId, updates, throttleMs } = {}) {
-	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,
@@ -4477,7 +4515,6 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 	(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)(() => {
@@ -4494,13 +4531,15 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 //#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.
 */
@@ -5073,6 +5112,7 @@ function useThreads$1({ agentId, includeArchived, limit, enabled = true }) {
 	})), [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);
@@ -5178,6 +5218,7 @@ function useThreads$1({ agentId, includeArchived, limit, enabled = true }) {
 		isLoading,
 		error,
 		listError,
+		fetchMoreError,
 		hasMoreThreads,
 		isFetchingMoreThreads,
 		isMutating,
@@ -5194,6 +5235,70 @@ function useThreads$1({ agentId, includeArchived, limit, enabled = true }) {
 	};
 }
 
+//#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
 /**
@@ -9055,7 +9160,7 @@ function findChatInput(origin) {
 *   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
@@ -9082,16 +9187,16 @@ function findChatInput(origin) {
 * </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$1({
+	const { threads, isLoading, listError, fetchMoreError, hasMoreThreads, isFetchingMoreThreads, archiveThread, unarchiveThread, deleteThread, fetchMoreThreads, refetchThreads, startNewThread } = useThreads$1({
 		agentId: resolvedAgentId,
 		includeArchived: true,
 		enabled: licensed,
@@ -9172,6 +9277,9 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 	const handleLoadMore = (0, react.useCallback)(() => {
 		fetchMoreThreads();
 	}, [fetchMoreThreads]);
+	const handleCollapseChange = (0, react.useCallback)((collapsed) => {
+		onCollapseChange?.(collapsed);
+	}, [onCollapseChange]);
 	const handlersRef = (0, react.useRef)({
 		handleThreadSelected,
 		handleNewThread,
@@ -9182,7 +9290,8 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 		handleRetry,
 		handleOpenChange,
 		handleLicensed,
-		handleLoadMore
+		handleLoadMore,
+		handleCollapseChange
 	});
 	handlersRef.current = {
 		handleThreadSelected,
@@ -9194,7 +9303,8 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 		handleRetry,
 		handleOpenChange,
 		handleLicensed,
-		handleLoadMore
+		handleLoadMore,
+		handleCollapseChange
 	};
 	(0, react.useEffect)(() => {
 		const el = elementRef.current;
@@ -9229,6 +9339,10 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 		};
 		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);
@@ -9239,6 +9353,7 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 		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);
@@ -9250,6 +9365,7 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 			el.removeEventListener("retry", onRetry);
 			el.removeEventListener("licensed", onLicensedEvent);
 			el.removeEventListener("load-more", onLoadMore);
+			el.removeEventListener("collapse-change", onCollapseChangeEvent);
 		};
 	}, [mounted]);
 	(0, react.useEffect)(() => {
@@ -9266,9 +9382,11 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 		el.licensed = licensed || licensePending;
 		el.hasMore = hasMoreThreads;
 		el.fetchingMore = isFetchingMoreThreads;
+		el.fetchMoreError = fetchMoreError ? fetchMoreError.message : null;
 	}, [
 		isLoading,
 		listError,
+		fetchMoreError,
 		activeThreadId,
 		licensed,
 		licensePending,
@@ -9291,6 +9409,11 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 		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) => {
@@ -9311,7 +9434,8 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 	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";
@@ -10964,8 +11088,18 @@ const usePredictStateSubscription = (agent) => {
 	}, [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;
 }
@@ -11696,6 +11830,12 @@ Object.defineProperty(exports, 'DefaultOpenIcon', {
     return DefaultOpenIcon;
   }
 });
+Object.defineProperty(exports, 'GenerateSandboxedUiArgsSchema', {
+  enumerable: true,
+  get: function () {
+    return GenerateSandboxedUiArgsSchema;
+  }
+});
 Object.defineProperty(exports, 'INTELLIGENCE_TURN_HEAD', {
   enumerable: true,
   get: function () {
@@ -11732,6 +11872,30 @@ Object.defineProperty(exports, 'MCPAppsActivityType', {
     return MCPAppsActivityType;
   }
 });
+Object.defineProperty(exports, 'OpenGenerativeUIActivityRenderer', {
+  enumerable: true,
+  get: function () {
+    return OpenGenerativeUIActivityRenderer;
+  }
+});
+Object.defineProperty(exports, 'OpenGenerativeUIActivityType', {
+  enumerable: true,
+  get: function () {
+    return OpenGenerativeUIActivityType;
+  }
+});
+Object.defineProperty(exports, 'OpenGenerativeUIContentSchema', {
+  enumerable: true,
+  get: function () {
+    return OpenGenerativeUIContentSchema;
+  }
+});
+Object.defineProperty(exports, 'OpenGenerativeUIToolRenderer', {
+  enumerable: true,
+  get: function () {
+    return OpenGenerativeUIToolRenderer;
+  }
+});
 Object.defineProperty(exports, 'SandboxFunctionsContext', {
   enumerable: true,
   get: function () {
@@ -11918,6 +12082,12 @@ Object.defineProperty(exports, 'useLearningContainersInCurrentThread', {
     return useLearningContainersInCurrentThread;
   }
 });
+Object.defineProperty(exports, 'useMemories', {
+  enumerable: true,
+  get: function () {
+    return useMemories;
+  }
+});
 Object.defineProperty(exports, 'useRenderActivityMessage', {
   enumerable: true,
   get: function () {
@@ -11972,4 +12142,10 @@ Object.defineProperty(exports, 'useToast', {
     return useToast;
   }
 });
-//# sourceMappingURL=copilotkit-lHheGQWt.cjs.map
+Object.defineProperty(exports, 'ɵrunMcpFollowUp', {
+  enumerable: true,
+  get: function () {
+    return ɵrunMcpFollowUp;
+  }
+});
+//# sourceMappingURL=copilotkit-nu7NwzH6.cjs.map