@copilotkit/react-core 1.70.0 → 1.70.2

package/dist/{copilotkit-B7aFKfQR.mjs → copilotkit-B1jSvZeb.mjs}

@@ -268,6 +268,62 @@ const CopilotChatConfigurationProvider = ({ children, labels, agentId, threadId,
 const useCopilotChatConfiguration = () => {
 	return useContext(CopilotChatConfiguration);
 };
+/**
+* Reports modal open/close requests to the host, and — when `open` is
+* supplied — makes the modal state of an already-established chat
+* configuration **controlled** for the subtree it wraps.
+*
+* This is deliberately a scope component rather than another mode inside
+* {@link CopilotChatConfigurationProvider}. The provider resolves modal state
+* across a nested chain (own state, parent sync, drawer mutual-exclusion, the
+* modal-closer registry); a controlled branch inside that resolution would add
+* a fourth interacting mode. Overriding the context for the subtree instead
+* leaves every one of those paths untouched:
+*
+* - `isModalOpen` is replaced with the host's `open`, so the rendered surface
+*   follows the prop from the very first frame (no open-then-close flash).
+* - `setModalOpen` still calls the underlying setter, so the existing
+*   parent-sync and drawer mutual-exclusion side effects continue to run, and
+*   *then* reports the request through `onOpenChange`.
+* - The wrapped setter is registered as the modal closer, so the drawer's
+*   mobile mutual-exclusion reaches the host instead of silently flipping
+*   state that nothing displays.
+*
+* A host that supplies `open` and ignores `onOpenChange` gets a modal pinned
+* to `open`, which is the standard controlled-component contract. A host that
+* supplies only `onOpenChange` is notified while the modal keeps managing
+* itself.
+*
+* Renders `children` unchanged when no chat configuration is in scope.
+*/
+const ControlledModalOpenScope = ({ children, open, onOpenChange }) => {
+	const parentConfig = useContext(CopilotChatConfiguration);
+	const parentSetModalOpen = parentConfig?.setModalOpen;
+	const registerModalCloser = parentConfig?.ɵregisterModalCloser;
+	const setModalOpen = useCallback((next) => {
+		parentSetModalOpen?.(next);
+		onOpenChange?.(next);
+	}, [parentSetModalOpen, onOpenChange]);
+	useEffect(() => {
+		if (!registerModalCloser) return;
+		return registerModalCloser(setModalOpen);
+	}, [registerModalCloser, setModalOpen]);
+	const configurationValue = useMemo(() => parentConfig ? {
+		...parentConfig,
+		isModalOpen: open ?? parentConfig.isModalOpen,
+		setModalOpen
+	} : null, [
+		parentConfig,
+		open,
+		setModalOpen
+	]);
+	if (!configurationValue) return /* @__PURE__ */ jsx(Fragment$1, { children });
+	return /* @__PURE__ */ jsx(CopilotChatConfiguration.Provider, {
+		value: configurationValue,
+		children
+	});
+};
+ControlledModalOpenScope.displayName = "ControlledModalOpenScope";
 
 //#endregion
 //#region src/v2/lib/utils.ts
@@ -1735,7 +1791,6 @@ async function ɵrunMcpFollowUp({ host, agent, capturedThreadId }) {
 		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:*";
 	const baseFrameSrc = "* blob: data: http://localhost:* https://localhost:*";
@@ -1847,6 +1902,13 @@ var MCPAppsRequestQueue = class {
 	}
 };
 const mcpAppsRequestQueue = new MCPAppsRequestQueue();
+const MCP_OPEN_LINK_BLOCKED_SCHEMES = new Set([
+	"javascript:",
+	"data:",
+	"vbscript:",
+	"blob:",
+	"file:"
+]);
 /**
 * Activity type for MCP Apps events - must match the middleware's MCPAppsActivityType
 */
@@ -1862,18 +1924,32 @@ const MCPAppsActivityContentSchema = z.object({
 	serverId: z.string().optional(),
 	toolInput: z.record(z.string(), z.unknown()).optional()
 });
-function isRequest(msg) {
-	return "id" in msg && "method" in msg;
-}
-function isNotification(msg) {
-	return !("id" in msg) && "method" in msg;
-}
 /**
 * MCP Apps Extension Activity Renderer
 *
 * Renders MCP Apps UI in a sandboxed iframe with full protocol support.
 * Fetches resource content on-demand via proxied MCP requests.
 */
+/**
+* Permissive `ui/message` schema. ext-apps restricts the request to
+* `role: "user"` with no `followUp`, but CopilotKit intentionally extends
+* `ui/message` with `role` ("user" | "assistant") and `followUp` (documented
+* behavior with dedicated tests). We register our own handler (instead of the
+* bridge's strict `onmessage`) so those extensions survive the migration.
+*
+* Going forward, widgets SHOULD pass the extensions under
+* `params._meta.copilotkit`; the top-level `role`/`followUp` fields are the
+* legacy channel, kept for backward compatibility and slated for deprecation.
+*/
+const CopilotKitUiMessageSchema = z.object({
+	method: z.literal("ui/message"),
+	params: z.object({
+		role: z.string().optional(),
+		content: z.array(z.any()).optional(),
+		followUp: z.boolean().optional(),
+		_meta: z.record(z.string(), z.any()).optional()
+	}).passthrough()
+});
 const MCPAppsActivityRenderer = function MCPAppsActivityRenderer({ content, agent }) {
 	const { copilotkit } = useCopilotKit$1();
 	const containerRef = useRef(null);
@@ -1887,41 +1963,12 @@ const MCPAppsActivityRenderer = function MCPAppsActivityRenderer({ content, agen
 	contentRef.current = content;
 	const agentRef = useRef(agent);
 	agentRef.current = agent;
+	const bridgeRef = useRef(null);
 	const fetchStateRef = useRef({
 		inProgress: false,
 		promise: null,
 		resourceUri: null
 	});
-	const sendToIframe = useCallback((msg) => {
-		if (iframeRef.current?.contentWindow) {
-			console.log("[MCPAppsRenderer] Sending to iframe:", msg);
-			iframeRef.current.contentWindow.postMessage(msg, "*");
-		}
-	}, []);
-	const sendResponse = useCallback((id, result) => {
-		sendToIframe({
-			jsonrpc: "2.0",
-			id,
-			result
-		});
-	}, [sendToIframe]);
-	const sendErrorResponse = useCallback((id, code, message) => {
-		sendToIframe({
-			jsonrpc: "2.0",
-			id,
-			error: {
-				code,
-				message
-			}
-		});
-	}, [sendToIframe]);
-	const sendNotification = useCallback((method, params) => {
-		sendToIframe({
-			jsonrpc: "2.0",
-			method,
-			params: params || {}
-		});
-	}, [sendToIframe]);
 	useEffect(() => {
 		const { resourceUri, serverHash, serverId } = content;
 		if (fetchStateRef.current.inProgress && fetchStateRef.current.resourceUri === resourceUri) {
@@ -1976,11 +2023,15 @@ const MCPAppsActivityRenderer = function MCPAppsActivityRenderer({ content, agen
 		const container = containerRef.current;
 		if (!container) return;
 		let mounted = true;
-		let messageHandler = null;
-		let initialListener = null;
+		let bridge = null;
 		let createdIframe = null;
 		const setup = async () => {
 			try {
+				const bridgeModule = await import("@modelcontextprotocol/ext-apps/app-bridge").catch((importErr) => {
+					throw new Error("MCP Apps require '@modelcontextprotocol/ext-apps' and its peer '@modelcontextprotocol/sdk'. Install them with: npm install @modelcontextprotocol/ext-apps @modelcontextprotocol/sdk", { cause: importErr });
+				});
+				if (!mounted) return;
+				const { AppBridge, PostMessageTransport } = bridgeModule;
 				const iframe = document.createElement("iframe");
 				createdIframe = iframe;
 				iframe.style.width = "100%";
@@ -1991,151 +2042,108 @@ const MCPAppsActivityRenderer = function MCPAppsActivityRenderer({ content, agen
 				iframe.setAttribute("sandbox", "allow-scripts allow-same-origin allow-forms");
 				iframe.setAttribute("data-testid", "mcp-app-iframe");
 				iframe.setAttribute("title", "Interactive MCP application");
-				const sandboxReady = new Promise((resolve) => {
-					initialListener = (event) => {
-						if (event.source === iframe.contentWindow) {
-							if (event.data?.method === "ui/notifications/sandbox-proxy-ready") {
-								if (initialListener) {
-									window.removeEventListener("message", initialListener);
-									initialListener = null;
-								}
-								resolve();
-							}
-						}
-					};
-					window.addEventListener("message", initialListener);
-				});
-				if (!mounted) {
-					if (initialListener) {
-						window.removeEventListener("message", initialListener);
-						initialListener = null;
-					}
-					return;
-				}
 				const cspDomains = fetchedResource._meta?.ui?.csp?.resourceDomains;
 				iframe.srcdoc = buildSandboxHTML(cspDomains);
 				iframeRef.current = iframe;
 				container.appendChild(iframe);
-				await sandboxReady;
-				if (!mounted) return;
-				console.log("[MCPAppsRenderer] Sandbox proxy ready");
-				messageHandler = async (event) => {
-					if (event.source !== iframe.contentWindow) return;
-					const msg = event.data;
-					if (!msg || typeof msg !== "object" || msg.jsonrpc !== "2.0") return;
-					console.log("[MCPAppsRenderer] Received from iframe:", msg);
-					if (isRequest(msg)) switch (msg.method) {
-						case "ui/initialize":
-							sendResponse(msg.id, {
-								protocolVersion: PROTOCOL_VERSION,
-								hostInfo: {
-									name: "CopilotKit MCP Apps Host",
-									version: "1.0.0"
-								},
-								hostCapabilities: {
-									openLinks: {},
-									logging: {}
-								},
-								hostContext: {
-									theme: "light",
-									platform: "web"
-								}
-							});
-							break;
-						case "ui/message": {
-							const currentAgent = agentRef.current;
-							if (!currentAgent) {
-								console.warn("[MCPAppsRenderer] ui/message: No agent available");
-								sendResponse(msg.id, { isError: false });
-								break;
-							}
-							try {
-								const params = msg.params;
-								const role = params.role || "user";
-								const textContent = params.content?.filter((c) => c.type === "text" && c.text).map((c) => c.text).join("\n") || "";
-								if (textContent) currentAgent.addMessage({
-									id: crypto.randomUUID(),
-									role,
-									content: textContent
-								});
-								sendResponse(msg.id, { isError: false });
-								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 });
-							}
-							break;
-						}
-						case "ui/open-link": {
-							const url = msg.params?.url;
-							if (url) {
-								window.open(url, "_blank", "noopener,noreferrer");
-								sendResponse(msg.id, { isError: false });
-							} else sendErrorResponse(msg.id, -32602, "Missing url parameter");
-							break;
-						}
-						case "tools/call": {
-							const { serverHash, serverId } = contentRef.current;
-							const currentAgent = agentRef.current;
-							if (!serverHash) {
-								sendErrorResponse(msg.id, -32603, "No server hash available for proxying");
-								break;
-							}
-							if (!currentAgent) {
-								sendErrorResponse(msg.id, -32603, "No agent available for proxying");
-								break;
-							}
-							try {
-								const runResult = await mcpAppsRequestQueue.enqueue(currentAgent, () => currentAgent.runAgent({ forwardedProps: { __proxiedMCPRequest: {
-									serverHash,
-									serverId,
-									method: "tools/call",
-									params: msg.params
-								} } }));
-								sendResponse(msg.id, runResult.result || {});
-							} catch (err) {
-								console.error("[MCPAppsRenderer] tools/call error:", err);
-								sendErrorResponse(msg.id, -32603, String(err));
-							}
-							break;
-						}
-						default: sendErrorResponse(msg.id, -32601, `Method not found: ${msg.method}`);
-					}
-					if (isNotification(msg)) switch (msg.method) {
-						case "ui/notifications/initialized":
-							console.log("[MCPAppsRenderer] Inner iframe initialized");
-							if (mounted) setIframeReady(true);
-							break;
-						case "ui/notifications/size-changed": {
-							const { width, height } = msg.params || {};
-							console.log("[MCPAppsRenderer] Size change:", {
-								width,
-								height
-							});
-							if (mounted) setIframeSize({
-								width: typeof width === "number" ? width : void 0,
-								height: typeof height === "number" ? height : void 0
-							});
-							break;
-						}
-						case "notifications/message":
-							console.log("[MCPAppsRenderer] App log:", msg.params);
-							break;
-					}
-				};
-				window.addEventListener("message", messageHandler);
+				const win = iframe.contentWindow;
+				if (!win) throw new Error("Sandbox iframe has no contentWindow");
 				let html;
 				if (fetchedResource.text) html = fetchedResource.text;
 				else if (fetchedResource.blob) html = atob(fetchedResource.blob);
 				else throw new Error("Resource has no text or blob content");
-				sendNotification("ui/notifications/sandbox-resource-ready", { html });
+				bridge = new AppBridge(null, {
+					name: "CopilotKit MCP Apps Host",
+					version: "1.0.0"
+				}, {
+					openLinks: {},
+					logging: {},
+					message: { text: {} }
+				}, { hostContext: {
+					theme: "light",
+					platform: "web"
+				} });
+				bridge.onsandboxready = () => {
+					bridge?.sendSandboxResourceReady({ html });
+				};
+				bridge.setRequestHandler(CopilotKitUiMessageSchema, async (req) => {
+					const currentAgent = agentRef.current;
+					if (!currentAgent) {
+						console.warn("[MCPAppsRenderer] ui/message: No agent available");
+						return { isError: false };
+					}
+					try {
+						const params = req.params;
+						const ck = params._meta?.copilotkit ?? {};
+						const role = ck.role || params.role || "user";
+						const textContent = params.content?.filter((c) => c.type === "text" && c.text).map((c) => c.text).join("\n") || "";
+						if (textContent) currentAgent.addMessage({
+							id: crypto.randomUUID(),
+							role,
+							content: textContent
+						});
+						if ((ck.followUp ?? 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));
+						}
+						return { isError: false };
+					} catch (err) {
+						console.error("[MCPAppsRenderer] ui/message error:", err);
+						return { isError: true };
+					}
+				});
+				bridge.onopenlink = async ({ url }) => {
+					let parsed;
+					try {
+						parsed = new URL(url);
+					} catch {
+						console.warn("[MCPAppsRenderer] ui/open-link rejected: unparseable url");
+						return { isError: true };
+					}
+					if (MCP_OPEN_LINK_BLOCKED_SCHEMES.has(parsed.protocol)) {
+						console.warn("[MCPAppsRenderer] ui/open-link rejected: blocked scheme", parsed.protocol);
+						return { isError: true };
+					}
+					window.open(url, "_blank", "noopener,noreferrer");
+					return { isError: false };
+				};
+				bridge.oncalltool = async (params) => {
+					const { serverHash, serverId } = contentRef.current;
+					const currentAgent = agentRef.current;
+					if (!serverHash) throw new Error("No server hash available for proxying");
+					if (!currentAgent) throw new Error("No agent available for proxying");
+					return (await mcpAppsRequestQueue.enqueue(currentAgent, () => currentAgent.runAgent({ forwardedProps: { __proxiedMCPRequest: {
+						serverHash,
+						serverId,
+						method: "tools/call",
+						params
+					} } }))).result || { content: [] };
+				};
+				bridge.onsizechange = (p) => {
+					if (!mounted) return;
+					const { width, height } = p || {};
+					setIframeSize({
+						width: typeof width === "number" ? width : void 0,
+						height: typeof height === "number" ? height : void 0
+					});
+				};
+				bridge.oninitialized = () => {
+					if (mounted) setIframeReady(true);
+				};
+				bridge.onloggingmessage = (p) => {
+					console.log("[MCPAppsRenderer] App log:", p);
+				};
+				const transport = new PostMessageTransport(win, win);
+				await bridge.connect(transport);
+				if (!mounted) {
+					await bridge.close();
+					return;
+				}
+				bridgeRef.current = bridge;
 			} catch (err) {
 				console.error("[MCPAppsRenderer] Setup error:", err);
 				if (mounted) setError(err instanceof Error ? err : new Error(String(err)));
@@ -2144,11 +2152,8 @@ const MCPAppsActivityRenderer = function MCPAppsActivityRenderer({ content, agen
 		setup();
 		return () => {
 			mounted = false;
-			if (initialListener) {
-				window.removeEventListener("message", initialListener);
-				initialListener = null;
-			}
-			if (messageHandler) window.removeEventListener("message", messageHandler);
+			bridgeRef.current = null;
+			bridge?.close();
 			if (createdIframe) {
 				createdIframe.remove();
 				createdIframe = null;
@@ -2158,9 +2163,7 @@ const MCPAppsActivityRenderer = function MCPAppsActivityRenderer({ content, agen
 	}, [
 		isLoading,
 		fetchedResource,
-		sendNotification,
-		sendResponse,
-		sendErrorResponse
+		copilotkit
 	]);
 	useEffect(() => {
 		if (iframeRef.current) {
@@ -2172,25 +2175,11 @@ const MCPAppsActivityRenderer = function MCPAppsActivityRenderer({ content, agen
 		}
 	}, [iframeSize]);
 	useEffect(() => {
-		if (iframeReady && content.toolInput) {
-			console.log("[MCPAppsRenderer] Sending tool input:", content.toolInput);
-			sendNotification("ui/notifications/tool-input", { arguments: content.toolInput });
-		}
-	}, [
-		iframeReady,
-		content.toolInput,
-		sendNotification
-	]);
+		if (iframeReady && content.toolInput) bridgeRef.current?.sendToolInput({ arguments: content.toolInput });
+	}, [iframeReady, content.toolInput]);
 	useEffect(() => {
-		if (iframeReady && content.result) {
-			console.log("[MCPAppsRenderer] Sending tool result:", content.result);
-			sendNotification("ui/notifications/tool-result", content.result);
-		}
-	}, [
-		iframeReady,
-		content.result,
-		sendNotification
-	]);
+		if (iframeReady && content.result) bridgeRef.current?.sendToolResult(content.result);
+	}, [iframeReady, content.result]);
 	const borderStyle = fetchedResource?._meta?.ui?.prefersBorder === true ? {
 		borderRadius: "8px",
 		backgroundColor: "#f9f9f9",
@@ -4005,7 +3994,8 @@ function useFrontendTool(tool, deps) {
 		tool.name,
 		tool.available,
 		copilotkit,
-		JSON.stringify(extraDeps)
+		JSON.stringify(extraDeps),
+		JSON.stringify(tool.webmcp ?? null)
 	]);
 }
 
@@ -5460,7 +5450,7 @@ function useMemories() {
 *         at the call site.
 */
 async function recordAnnotation(args) {
-	const { runtimeUrl, headers, type, payload, threadId, occurredAt } = args;
+	const { runtimeUrl, headers, type, payload, threadId, occurredAt, fetch: fetchImplementation = globalThis.fetch } = args;
 	const body = {
 		type,
 		threadId,
@@ -5468,7 +5458,7 @@ async function recordAnnotation(args) {
 		...payload !== void 0 ? { payload } : {},
 		...occurredAt !== void 0 ? { occurredAt } : {}
 	};
-	const response = await fetch(`${runtimeUrl}/annotate`, {
+	const response = await fetchImplementation(`${runtimeUrl}/annotate`, {
 		method: "POST",
 		headers: {
 			"Content-Type": "application/json",
@@ -5537,6 +5527,7 @@ function useLearnFromUserAction() {
 			...input.data !== void 0 ? { data: input.data } : {}
 		};
 		return recordAnnotation({
+			fetch: copilotkit.ɵruntimeFetch,
 			runtimeUrl,
 			headers: copilotkit.headers ?? {},
 			type: "user_action",
@@ -5606,6 +5597,21 @@ function useLearnFromUserActionInCurrentThread() {
 
 //#endregion
 //#region src/v2/hooks/use-attachments.tsx
+const DEFAULT_MAX_SIZE = 20 * 1024 * 1024;
+/**
+* How many uploads run at once when `maxConcurrentUploads` is unset. One, because
+* `onUpload` is a public callback an app may have written expecting the previous
+* file to have finished — concurrency is something the app asks for.
+*/
+const DEFAULT_MAX_CONCURRENT_UPLOADS = 1;
+/**
+* At least one upload at a time, whole files only; `NaN` or a non-number falls back to the
+* default, and `Infinity` means "no limit" — bounded in practice by how many files are queued.
+*/
+function resolveMaxConcurrentUploads(configured) {
+	if (typeof configured !== "number" || Number.isNaN(configured)) return DEFAULT_MAX_CONCURRENT_UPLOADS;
+	return Math.max(1, Math.floor(configured));
+}
 /**
 * Hook that manages file attachment state — uploads, drag-and-drop, paste,
 * and lifecycle. All returned callbacks are referentially stable across
@@ -5621,10 +5627,62 @@ function useAttachments({ config }) {
 	configRef.current = config;
 	const attachmentsRef = useRef([]);
 	attachmentsRef.current = attachments;
+	const uploadQueueRef = useRef([]);
+	const activeWorkersRef = useRef(0);
+	const uploadFile = useCallback(async (file, placeholder, cfg) => {
+		try {
+			let source;
+			let uploadMetadata;
+			if (cfg?.onUpload) {
+				const { metadata: meta, ...uploadSource } = await cfg.onUpload(file);
+				source = uploadSource;
+				uploadMetadata = meta;
+			} else source = {
+				type: "data",
+				value: await readFileAsBase64(file),
+				mimeType: file.type
+			};
+			let thumbnail;
+			if (placeholder.type === "video") thumbnail = await generateVideoThumbnail(file);
+			setAttachments((prev) => prev.map((att) => att.id === placeholder.id ? {
+				...att,
+				source,
+				status: "ready",
+				thumbnail,
+				metadata: uploadMetadata
+			} : att));
+		} catch (error) {
+			setAttachments((prev) => prev.filter((att) => att.id !== placeholder.id));
+			console.error(`[CopilotKit] Failed to upload "${file.name}":`, error);
+			cfg?.onUploadFailed?.({
+				reason: "upload-failed",
+				file,
+				message: error instanceof Error ? error.message : `Failed to upload "${file.name}"`
+			});
+		}
+	}, []);
+	const drainUploadQueue = useCallback(async () => {
+		activeWorkersRef.current++;
+		try {
+			for (;;) {
+				const item = uploadQueueRef.current.shift();
+				if (!item) return;
+				try {
+					await uploadFile(item.file, item.placeholder, item.cfg);
+				} catch (error) {
+					console.error("[CopilotKit] Upload worker error:", error);
+				} finally {
+					item.settle();
+				}
+			}
+		} finally {
+			activeWorkersRef.current--;
+		}
+	}, [uploadFile]);
 	const processFiles = useCallback(async (files) => {
 		const cfg = configRef.current;
 		const accept = cfg?.accept ?? "*/*";
-		const maxSize = cfg?.maxSize ?? 20 * 1024 * 1024;
+		const maxSize = cfg?.maxSize ?? DEFAULT_MAX_SIZE;
 		const rejectedFiles = files.filter((file) => !matchesAcceptFilter(file, accept));
 		for (const file of rejectedFiles) cfg?.onUploadFailed?.({
 			reason: "invalid-type",
@@ -5632,6 +5690,7 @@ function useAttachments({ config }) {
 			message: `File "${file.name}" is not accepted. Supported types: ${accept}`
 		});
 		const validFiles = files.filter((file) => matchesAcceptFilter(file, accept));
+		const queued = [];
 		for (const file of validFiles) {
 			if (exceedsMaxSize(file, maxSize)) {
 				cfg?.onUploadFailed?.({
@@ -5641,53 +5700,37 @@ function useAttachments({ config }) {
 				});
 				continue;
 			}
-			const modality = getModalityFromMimeType(file.type);
-			const placeholderId = randomUUID$1();
-			const placeholder = {
-				id: placeholderId,
-				type: modality,
-				source: {
-					type: "data",
-					value: "",
-					mimeType: file.type
-				},
-				filename: file.name,
-				size: file.size,
-				status: "uploading"
-			};
-			setAttachments((prev) => [...prev, placeholder]);
-			try {
-				let source;
-				let uploadMetadata;
-				if (cfg?.onUpload) {
-					const { metadata: meta, ...uploadSource } = await cfg.onUpload(file);
-					source = uploadSource;
-					uploadMetadata = meta;
-				} else source = {
-					type: "data",
-					value: await readFileAsBase64(file),
-					mimeType: file.type
-				};
-				let thumbnail;
-				if (modality === "video") thumbnail = await generateVideoThumbnail(file);
-				setAttachments((prev) => prev.map((att) => att.id === placeholderId ? {
-					...att,
-					source,
-					status: "ready",
-					thumbnail,
-					metadata: uploadMetadata
-				} : att));
-			} catch (error) {
-				setAttachments((prev) => prev.filter((att) => att.id !== placeholderId));
-				console.error(`[CopilotKit] Failed to upload "${file.name}":`, error);
-				cfg?.onUploadFailed?.({
-					reason: "upload-failed",
-					file,
-					message: error instanceof Error ? error.message : `Failed to upload "${file.name}"`
-				});
-			}
+			queued.push({
+				file,
+				placeholder: {
+					id: randomUUID$1(),
+					type: getModalityFromMimeType(file.type),
+					source: {
+						type: "data",
+						value: "",
+						mimeType: file.type
+					},
+					filename: file.name,
+					size: file.size,
+					status: "uploading"
+				}
+			});
 		}
-	}, []);
+		if (queued.length === 0) return;
+		setAttachments((prev) => [...prev, ...queued.map((q) => q.placeholder)]);
+		const settled = queued.map(({ file, placeholder }) => new Promise((resolve) => {
+			uploadQueueRef.current.push({
+				file,
+				placeholder,
+				cfg,
+				settle: resolve
+			});
+		}));
+		const limit = resolveMaxConcurrentUploads(cfg?.maxConcurrentUploads);
+		const toSpawn = Math.min(uploadQueueRef.current.length, Math.max(0, limit - activeWorkersRef.current));
+		for (let i = 0; i < toSpawn; i++) drainUploadQueue();
+		await Promise.all(settled);
+	}, [drainUploadQueue]);
 	const handleFileUpload = useCallback(async (e) => {
 		if (!e.target.files?.length) return;
 		try {
@@ -5799,9 +5842,9 @@ const DEFAULT_CONTAINERS = ["project"];
 * }
 * ```
 *
-* @deprecated Legacy plural-container annotation compatibility only. New
-* Intelligence runtimes assign one container with `ɵlearning.containerId` on
-* `CopilotRuntime`.
+* @deprecated This hook supports only the legacy plural-container annotation.
+* Configure `getLearningContainerId` on `CopilotKitIntelligence` for new
+* Intelligence runtimes.
 */
 function useLearningContainers({ threadId, learningContainers }) {
 	const { copilotkit } = useCopilotKit();
@@ -5815,8 +5858,10 @@ function useLearningContainers({ threadId, learningContainers }) {
 	const warnedMissingUrlRef = useRef(false);
 	const runtimeUrlRef = useRef(copilotkit.runtimeUrl);
 	const headersRef = useRef(copilotkit.headers ?? {});
+	const runtimeFetchRef = useRef(copilotkit.ɵruntimeFetch);
 	runtimeUrlRef.current = copilotkit.runtimeUrl;
 	headersRef.current = copilotkit.headers ?? {};
+	runtimeFetchRef.current = copilotkit.ɵruntimeFetch;
 	const key = JSON.stringify(learningContainers);
 	const defaultKey = JSON.stringify(DEFAULT_CONTAINERS);
 	useEffect(() => {
@@ -5836,6 +5881,7 @@ function useLearningContainers({ threadId, learningContainers }) {
 				return;
 			}
 			recordAnnotation({
+				fetch: copilotkit.ɵruntimeFetch,
 				runtimeUrl,
 				headers,
 				type: "set_learning_containers",
@@ -5863,6 +5909,7 @@ function useLearningContainers({ threadId, learningContainers }) {
 			const capturedRuntimeUrl = runtimeUrlRef.current;
 			const capturedHeaders = headersRef.current;
 			if (capturedRuntimeUrl) recordAnnotation({
+				fetch: runtimeFetchRef.current,
 				runtimeUrl: capturedRuntimeUrl,
 				headers: capturedHeaders,
 				type: "set_learning_containers",
@@ -5905,9 +5952,9 @@ function useLearningContainers({ threadId, learningContainers }) {
 * }
 * ```
 *
-* @deprecated Legacy plural-container annotation compatibility only. New
-* Intelligence runtimes assign one container with `ɵlearning.containerId` on
-* `CopilotRuntime`.
+* @deprecated This hook supports only the legacy plural-container annotation.
+* Configure `getLearningContainerId` on `CopilotKitIntelligence` for new
+* Intelligence runtimes.
 */
 function useLearningContainersInCurrentThread({ learningContainers }) {
 	const threadId = useCopilotChatConfiguration()?.threadId;
@@ -9125,6 +9172,41 @@ const CopilotChatToggleButton = React.forwardRef(function CopilotChatToggleButto
 });
 CopilotChatToggleButton.displayName = "CopilotChatToggleButton";
 
+//#endregion
+//#region src/v2/components/chat/modal-open-control.tsx
+const ModalOpenControlContext = createContext({});
+/**
+* Carries `open` / `onOpenChange` from a prebuilt surface down to the view that
+* owns the modal state.
+*
+* A context is required rather than plain props because `<CopilotSidebar>`
+* hands its view to `<CopilotChat>` as a `chatView` **component**. Threading a
+* value that changes (like `open`) through that component's identity would mint
+* a new element type on every toggle, and React unmounts and remounts the whole
+* chat subtree when the element type changes. That is the remount class of bug
+* already fixed for `<CopilotPopup>` on resize. Context keeps the override
+* identity stable while still re-rendering the view when `open` changes.
+*/
+function ModalOpenControlProvider({ open, onOpenChange, children }) {
+	const value = useMemo(() => ({
+		open,
+		onOpenChange
+	}), [open, onOpenChange]);
+	return /* @__PURE__ */ jsx(ModalOpenControlContext.Provider, {
+		value,
+		children
+	});
+}
+/**
+* Reads the controlled open state supplied by the surrounding prebuilt
+* surface. Returns an empty control (uncontrolled) when there is none.
+*
+* @returns The host's `open` / `onOpenChange` pair.
+*/
+function useModalOpenControl() {
+	return useContext(ModalOpenControlContext);
+}
+
 //#endregion
 //#region src/v2/components/chat/CopilotModalHeader.tsx
 /**
@@ -9234,15 +9316,22 @@ CopilotModalHeader.DrawerLauncher.displayName = "CopilotModalHeader.DrawerLaunch
 const DEFAULT_SIDEBAR_WIDTH = 480;
 const SIDEBAR_TRANSITION_MS = 260;
 function CopilotSidebarView({ header, toggleButton, width, defaultOpen = true, position = "right", ...props }) {
+	const { open, onOpenChange } = useModalOpenControl();
+	const hasOpenControl = open !== void 0 || onOpenChange !== void 0;
+	const internal = /* @__PURE__ */ jsx(CopilotSidebarViewInternal, {
+		header,
+		toggleButton,
+		width,
+		position,
+		...props
+	});
 	return /* @__PURE__ */ jsx(CopilotChatConfigurationProvider, {
-		isModalDefaultOpen: defaultOpen,
-		children: /* @__PURE__ */ jsx(CopilotSidebarViewInternal, {
-			header,
-			toggleButton,
-			width,
-			position,
-			...props
-		})
+		isModalDefaultOpen: open ?? defaultOpen,
+		children: hasOpenControl ? /* @__PURE__ */ jsx(ControlledModalOpenScope, {
+			open,
+			onOpenChange,
+			children: internal
+		}) : internal
 	});
 }
 function CopilotSidebarViewInternal({ header, toggleButton, width, position = "right", ...props }) {
@@ -9306,7 +9395,7 @@ function CopilotSidebarViewInternal({ header, toggleButton, width, position = "r
 		"data-position": position,
 		className: cn("copilotKitSidebar copilotKitWindow", "cpk:fixed cpk:top-0 cpk:z-[1200] cpk:flex", position === "left" ? "cpk:left-0" : "cpk:right-0", "cpk:h-[100vh] cpk:h-[100dvh] cpk:max-h-screen", "cpk:w-full", position === "left" ? "cpk:border-r" : "cpk:border-l", "cpk:border-border cpk:bg-background cpk:text-foreground cpk:shadow-xl", "cpk:transition-transform cpk:duration-300 cpk:ease-out", isSidebarOpen ? "cpk:translate-x-0" : position === "left" ? "cpk:-translate-x-full cpk:pointer-events-none" : "cpk:translate-x-full cpk:pointer-events-none"),
 		style: {
-			["--sidebar-width"]: widthToCss(sidebarWidth),
+			"--sidebar-width": widthToCss(sidebarWidth),
 			paddingTop: "env(safe-area-inset-top)",
 			paddingBottom: "env(safe-area-inset-bottom)"
 		},
@@ -9368,17 +9457,24 @@ const dimensionToCss = (value, fallback) => {
 	return `${fallback}px`;
 };
 function CopilotPopupView({ header, toggleButton, width, height, clickOutsideToClose, defaultOpen = true, className, ...restProps }) {
+	const { open, onOpenChange } = useModalOpenControl();
+	const hasOpenControl = open !== void 0 || onOpenChange !== void 0;
+	const internal = /* @__PURE__ */ jsx(CopilotPopupViewInternal, {
+		header,
+		toggleButton,
+		width,
+		height,
+		clickOutsideToClose,
+		className,
+		...restProps
+	});
 	return /* @__PURE__ */ jsx(CopilotChatConfigurationProvider, {
-		isModalDefaultOpen: defaultOpen,
-		children: /* @__PURE__ */ jsx(CopilotPopupViewInternal, {
-			header,
-			toggleButton,
-			width,
-			height,
-			clickOutsideToClose,
-			className,
-			...restProps
-		})
+		isModalDefaultOpen: open ?? defaultOpen,
+		children: hasOpenControl ? /* @__PURE__ */ jsx(ControlledModalOpenScope, {
+			open,
+			onOpenChange,
+			children: internal
+		}) : internal
 	});
 }
 function CopilotPopupViewInternal({ header, toggleButton, width, height, clickOutsideToClose, className, ...restProps }) {
@@ -9511,7 +9607,7 @@ var CopilotPopupView_default = CopilotPopupView;
 
 //#endregion
 //#region src/v2/components/chat/CopilotSidebar.tsx
-function CopilotSidebar({ header, toggleButton, defaultOpen, width, position, ...chatProps }) {
+function CopilotSidebar({ header, toggleButton, defaultOpen, open, onOpenChange, width, position, ...chatProps }) {
 	const { checkFeature } = useLicenseContext$1();
 	const isSidebarLicensed = checkFeature("sidebar");
 	useEffect(() => {
@@ -9537,11 +9633,15 @@ function CopilotSidebar({ header, toggleButton, defaultOpen, width, position, ..
 		defaultOpen,
 		position
 	]);
-	return /* @__PURE__ */ jsxs(Fragment$1, { children: [!isSidebarLicensed && /* @__PURE__ */ jsx(InlineFeatureWarning, { featureName: "Sidebar" }), /* @__PURE__ */ jsx(CopilotChat, {
-		welcomeScreen: CopilotSidebarView.WelcomeScreen,
-		...chatProps,
-		isModalDefaultOpen: defaultOpen,
-		chatView: SidebarViewOverride
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [!isSidebarLicensed && /* @__PURE__ */ jsx(InlineFeatureWarning, { featureName: "Sidebar" }), /* @__PURE__ */ jsx(ModalOpenControlProvider, {
+		open,
+		onOpenChange,
+		children: /* @__PURE__ */ jsx(CopilotChat, {
+			welcomeScreen: CopilotSidebarView.WelcomeScreen,
+			...chatProps,
+			isModalDefaultOpen: defaultOpen,
+			chatView: SidebarViewOverride
+		})
 	})] });
 }
 CopilotSidebar.displayName = "CopilotSidebar";
@@ -9563,7 +9663,7 @@ const PopupViewOverride = (viewProps) => {
 	});
 };
 const PopupViewOverrideWithStatics = Object.assign(PopupViewOverride, CopilotChatView_default);
-function CopilotPopup({ header, toggleButton, defaultOpen, width, height, clickOutsideToClose, ...chatProps }) {
+function CopilotPopup({ header, toggleButton, defaultOpen, open, onOpenChange, width, height, clickOutsideToClose, ...chatProps }) {
 	const { checkFeature } = useLicenseContext$1();
 	const isPopupLicensed = checkFeature("popup");
 	useEffect(() => {
@@ -9586,11 +9686,15 @@ function CopilotPopup({ header, toggleButton, defaultOpen, width, height, clickO
 	]);
 	return /* @__PURE__ */ jsxs(Fragment$1, { children: [!isPopupLicensed && /* @__PURE__ */ jsx(InlineFeatureWarning, { featureName: "Popup" }), /* @__PURE__ */ jsx(PopupShellPropsContext.Provider, {
 		value: shellProps,
-		children: /* @__PURE__ */ jsx(CopilotChat, {
-			welcomeScreen: CopilotPopupView_default.WelcomeScreen,
-			...chatProps,
-			isModalDefaultOpen: defaultOpen,
-			chatView: PopupViewOverrideWithStatics
+		children: /* @__PURE__ */ jsx(ModalOpenControlProvider, {
+			open,
+			onOpenChange,
+			children: /* @__PURE__ */ jsx(CopilotChat, {
+				welcomeScreen: CopilotPopupView_default.WelcomeScreen,
+				...chatProps,
+				isModalDefaultOpen: defaultOpen,
+				chatView: PopupViewOverrideWithStatics
+			})
 		})
 	})] });
 }
@@ -10912,7 +11016,7 @@ const getErrorActions = (error) => {
 	switch (error.code) {
 		case CopilotKitErrorCode.MISSING_PUBLIC_API_KEY_ERROR: return { primary: {
 			label: "Show me how",
-			onClick: () => window.open("https://docs.copilotkit.ai/premium/overview#getting-access", "_blank", "noopener,noreferrer")
+			onClick: () => window.open("https://docs.copilotkit.ai/intelligence/overview#plans-and-access", "_blank", "noopener,noreferrer")
 		} };
 		case CopilotKitErrorCode.UPGRADE_REQUIRED_ERROR: return { primary: {
 			label: "Upgrade",
@@ -12144,4 +12248,4 @@ function validateProps(props) {
 
 //#endregion
 export { useAgentContext as $, CopilotChatMessageView as A, AudioRecorderError as At, CopilotChatAssistantMessage_default as B, CopilotModalHeader as C, MCPAppsActivityContentSchema as Ct, CopilotChat as D, CopilotKitInspector as Dt, DefaultOpenIcon as E, ɵrunMcpFollowUp 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, CopilotChatConfigurationProvider as Mt, getIntelligenceTurnAnchors as N, useCopilotChatConfiguration as Nt, CopilotChatView_default as O, useRenderToolCall as Ot, IntelligenceIndicatorView as P, useSuggestions as Q, CopilotChatUserMessage_default as R, CopilotSidebarView as S, useSandboxFunctions as St, DefaultCloseIcon as T, MCPAppsActivityType as Tt, useLearningContainers as U, CopilotChatToolCallsView as V, useAttachments as W, INTERRUPT_EVENT_NAME as X, useInterrupt as Y, useConfigureSuggestions as Z, WildcardToolCallRender as _, OpenGenerativeUIActivityRenderer as _t, ThreadsProvider as a, useRenderTool as at, CopilotSidebar as b, OpenGenerativeUIToolRenderer as bt, CoAgentStateRendersProvider as c, useRenderActivityMessage as ct, shouldShowDevConsole as d, useCopilotKit$1 as dt, useCapabilities as et, useToast as f, useLicenseContext$1 as ft, useCopilotContext as g, GenerateSandboxedUiArgsSchema as gt, CopilotContext as h, createA2UIMessageRenderer as ht, ThreadsContext as i, useDefaultRenderTool as it, INTELLIGENCE_TURN_HEAD as j, CopilotChatAudioRecorder as jt, CopilotChatAttachmentQueue as k, CopilotChatInput_default as kt, useCoAgentStateRenders as l, useRenderCustomMessages as lt, useCopilotMessagesContext as m, defineToolCallRenderer as mt, defaultCopilotContextCategories as n, useAgent as nt, useThreads as o, useComponent as ot, CopilotMessagesContext as p, CopilotKitCoreReact as pt, useMemories as q, CoAgentStateRenderBridge as r, useHumanInTheLoop as rt, CoAgentStateRendersContext as s, useFrontendTool as st, CopilotKit as t, UseAgentUpdate as tt, useAsyncCallback as u, CopilotKitProvider as ut, CopilotThreadsDrawer as v, OpenGenerativeUIActivityType as vt, CopilotChatToggleButton as w, MCPAppsActivityRenderer as wt, CopilotPopupView as x, SandboxFunctionsContext as xt, CopilotPopup as y, OpenGenerativeUIContentSchema as yt, CopilotChatAttachmentRenderer as z };
-//# sourceMappingURL=copilotkit-B7aFKfQR.mjs.map
+//# sourceMappingURL=copilotkit-B1jSvZeb.mjs.map