@copilotkit/react-core 1.57.0 → 1.57.1-canary.1778272612

package/dist/{copilotkit-DGbvw8n2.cjs → copilotkit-Dnj9pi4m.cjs}

@@ -1325,351 +1325,842 @@ function useKatexStyles() {
 }
 
 //#endregion
-//#region src/v2/components/CopilotKitInspector.tsx
-const CopilotKitInspector = ({ core, ...rest }) => {
-	const [InspectorComponent, setInspectorComponent] = react.useState(null);
-	react.useEffect(() => {
-		let mounted = true;
-		import("@copilotkit/web-inspector").then((mod) => {
-			mod.defineWebInspector?.();
-			const Component = (0, _lit_labs_react.createComponent)({
-				tagName: mod.WEB_INSPECTOR_TAG,
-				elementClass: mod.WebInspectorElement,
-				react
+//#region src/v2/lib/react-core.ts
+var CopilotKitCoreReact = class extends _copilotkit_core.CopilotKitCore {
+	constructor(config) {
+		super(config);
+		this._renderToolCalls = [];
+		this._hookRenderToolCalls = /* @__PURE__ */ new Map();
+		this._cachedMergedRenderToolCalls = null;
+		this._renderCustomMessages = [];
+		this._renderActivityMessages = [];
+		this._interruptElement = null;
+		this._renderToolCalls = config.renderToolCalls ?? [];
+		this._renderCustomMessages = config.renderCustomMessages ?? [];
+		this._renderActivityMessages = config.renderActivityMessages ?? [];
+	}
+	get renderCustomMessages() {
+		return this._renderCustomMessages;
+	}
+	get renderActivityMessages() {
+		return this._renderActivityMessages;
+	}
+	get renderToolCalls() {
+		if (this._hookRenderToolCalls.size === 0) return this._renderToolCalls;
+		if (this._cachedMergedRenderToolCalls) return this._cachedMergedRenderToolCalls;
+		const merged = /* @__PURE__ */ new Map();
+		for (const rc of this._renderToolCalls) merged.set(`${rc.agentId ?? ""}:${rc.name}`, rc);
+		for (const [key, rc] of this._hookRenderToolCalls) merged.set(key, rc);
+		this._cachedMergedRenderToolCalls = Array.from(merged.values());
+		return this._cachedMergedRenderToolCalls;
+	}
+	setRenderActivityMessages(renderers) {
+		this._renderActivityMessages = renderers;
+	}
+	setRenderCustomMessages(renderers) {
+		this._renderCustomMessages = renderers;
+	}
+	setRenderToolCalls(renderToolCalls) {
+		this._renderToolCalls = renderToolCalls;
+		this._cachedMergedRenderToolCalls = null;
+		this._notifyRenderToolCallsChanged();
+	}
+	addHookRenderToolCall(entry) {
+		const key = `${entry.agentId ?? ""}:${entry.name}`;
+		this._hookRenderToolCalls.set(key, entry);
+		this._cachedMergedRenderToolCalls = null;
+		this._notifyRenderToolCallsChanged();
+	}
+	removeHookRenderToolCall(name, agentId) {
+		const key = `${agentId ?? ""}:${name}`;
+		if (this._hookRenderToolCalls.delete(key)) {
+			this._cachedMergedRenderToolCalls = null;
+			this._notifyRenderToolCallsChanged();
+		}
+	}
+	_notifyRenderToolCallsChanged() {
+		this.notifySubscribers((subscriber) => {
+			const reactSubscriber = subscriber;
+			if (reactSubscriber.onRenderToolCallsChanged) reactSubscriber.onRenderToolCallsChanged({
+				copilotkit: this,
+				renderToolCalls: this.renderToolCalls
 			});
-			if (mounted) setInspectorComponent(() => Component);
-		});
-		return () => {
-			mounted = false;
-		};
-	}, []);
-	if (!InspectorComponent) return null;
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(InspectorComponent, {
-		...rest,
-		core: core ?? null
-	});
+		}, "Subscriber onRenderToolCallsChanged error:");
+	}
+	get interruptElement() {
+		return this._interruptElement;
+	}
+	setInterruptElement(element) {
+		this._interruptElement = element;
+		this.notifySubscribers((subscriber) => {
+			subscriber.onInterruptElementChanged?.({
+				copilotkit: this,
+				interruptElement: this._interruptElement
+			});
+		}, "Subscriber onInterruptElementChanged error:");
+	}
+	subscribe(subscriber) {
+		return super.subscribe(subscriber);
+	}
+	/**
+	* Wait for pending React state updates before the follow-up agent run.
+	*
+	* When a frontend tool handler calls setState(), React 18 batches the update
+	* and schedules a commit via its internal scheduler (MessageChannel). The
+	* useAgentContext hook registers context via useLayoutEffect, which runs
+	* synchronously after React commits that batch.
+	*
+	* Awaiting a zero-delay timeout yields to the macrotask queue. React's
+	* MessageChannel task runs first, committing the pending state and running
+	* useLayoutEffect (which updates the context store). The follow-up runAgent
+	* call then reads fresh context.
+	*/
+	async waitForPendingFrameworkUpdates() {
+		await new Promise((resolve) => setTimeout(resolve, 0));
+	}
 };
-CopilotKitInspector.displayName = "CopilotKitInspector";
 
 //#endregion
-//#region src/v2/components/license-warning-banner.tsx
-const LICENSE_BANNER_OFFSET_PX = 52;
-const LICENSE_BANNER_OFFSET_VAR = "--copilotkit-license-banner-offset";
-const BANNER_STYLES = {
-	base: {
-		position: "fixed",
-		bottom: "8px",
-		left: "50%",
-		transform: "translateX(-50%)",
-		zIndex: 99999,
-		display: "inline-flex",
-		alignItems: "center",
-		gap: "12px",
-		whiteSpace: "nowrap",
-		padding: "8px 16px",
-		fontSize: "13px",
-		fontFamily: "-apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif",
-		borderRadius: "6px",
-		boxShadow: "0 2px 8px rgba(0, 0, 0, 0.15)"
-	},
-	info: {
-		backgroundColor: "#eff6ff",
-		border: "1px solid #93c5fd",
-		color: "#1e40af"
-	},
-	warning: {
-		backgroundColor: "#fffbeb",
-		border: "1px solid #fbbf24",
-		color: "#92400e"
-	},
-	critical: {
-		backgroundColor: "#fef2f2",
-		border: "1px solid #fca5a5",
-		color: "#991b1b"
-	}
-};
-function getSeverityStyle(severity) {
-	switch (severity) {
-		case "warning": return BANNER_STYLES.warning;
-		case "critical": return BANNER_STYLES.critical;
-		default: return BANNER_STYLES.info;
-	}
-}
-function BannerShell({ severity, message, actionLabel, actionUrl, onDismiss }) {
+//#region src/v2/context.ts
+const CopilotKitContext = (0, react.createContext)(null);
+const useCopilotKit = () => {
+	const context = (0, react.useContext)(CopilotKitContext);
+	const [, forceUpdate] = (0, react.useReducer)((x) => x + 1, 0);
+	if (!context) throw new Error("useCopilotKit must be used within CopilotKitProvider");
 	(0, react.useEffect)(() => {
-		if (typeof document === "undefined") return;
-		const root = document.documentElement;
-		root.style.setProperty(LICENSE_BANNER_OFFSET_VAR, `${LICENSE_BANNER_OFFSET_PX}px`);
+		const subscription = context.copilotkit.subscribe({ onRuntimeConnectionStatusChanged: () => {
+			forceUpdate();
+		} });
 		return () => {
-			root.style.removeProperty(LICENSE_BANNER_OFFSET_VAR);
+			subscription.unsubscribe();
 		};
 	}, []);
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-		style: {
-			...BANNER_STYLES.base,
-			...getSeverityStyle(severity)
-		},
-		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: message }), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-			style: {
-				display: "flex",
-				gap: "8px",
-				alignItems: "center"
-			},
-			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
-				href: actionUrl,
-				target: "_blank",
-				rel: "noopener noreferrer",
-				style: {
-					fontWeight: 600,
-					textDecoration: "underline",
-					color: "inherit"
-				},
-				children: actionLabel
-			}), onDismiss && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-				onClick: onDismiss,
-				style: {
-					background: "none",
-					border: "none",
-					cursor: "pointer",
-					color: "inherit",
-					fontSize: "16px"
-				},
-				children: "×"
-			})]
-		})]
-	});
-}
-function LicenseWarningBanner({ type, featureName, expiryDate, graceRemaining, onDismiss }) {
-	switch (type) {
-		case "no_license": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BannerShell, {
-			severity: "info",
-			message: "Powered by CopilotKit",
-			actionLabel: "Get a license",
-			actionUrl: "https://copilotkit.ai/pricing",
-			onDismiss
-		});
-		case "feature_unlicensed": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BannerShell, {
-			severity: "warning",
-			message: `⚠ The "${featureName}" feature requires a CopilotKit license.`,
-			actionLabel: "Get a license",
-			actionUrl: "https://copilotkit.ai/pricing",
-			onDismiss
-		});
-		case "expiring": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BannerShell, {
-			severity: "warning",
-			message: `Your CopilotKit license expires in ${graceRemaining} day${graceRemaining !== 1 ? "s" : ""}. Please renew.`,
-			actionLabel: "Renew",
-			actionUrl: "https://cloud.copilotkit.ai",
-			onDismiss
-		});
-		case "expired": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BannerShell, {
-			severity: "critical",
-			message: `Your CopilotKit license expired${expiryDate ? ` on ${expiryDate}` : ""}. Please renew at copilotkit.ai/pricing`,
-			actionLabel: "Renew now",
-			actionUrl: "https://copilotkit.ai/pricing",
-			onDismiss
-		});
-		case "invalid": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BannerShell, {
-			severity: "critical",
-			message: "Invalid CopilotKit license token. Please check your configuration.",
-			actionLabel: "Get a license",
-			actionUrl: "https://copilotkit.ai/pricing",
-			onDismiss
-		});
-		default: return null;
-	}
-}
-function InlineFeatureWarning({ featureName }) {
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-		style: {
-			padding: "8px 12px",
-			backgroundColor: "#fffbeb",
-			border: "1px solid #fbbf24",
-			borderRadius: "6px",
-			fontSize: "13px",
-			color: "#92400e",
-			fontFamily: "-apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif"
-		},
-		children: [
-			"⚠ The \"",
-			featureName,
-			"\" feature requires a CopilotKit license.",
-			" ",
-			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
-				href: "https://copilotkit.ai/pricing",
-				target: "_blank",
-				rel: "noopener noreferrer",
-				style: {
-					color: "#b45309",
-					textDecoration: "underline"
-				},
-				children: "Get one at copilotkit.ai/pricing"
-			})
-		]
-	});
+	return context;
+};
+const LicenseContext = (0, react.createContext)({
+	status: null,
+	license: null,
+	checkFeature: () => true,
+	getLimit: () => null
+});
+const useLicenseContext = () => (0, react.useContext)(LicenseContext);
+
+//#endregion
+//#region src/v2/types/defineToolCallRenderer.ts
+function defineToolCallRenderer(def) {
+	const argsSchema = def.name === "*" && !def.args ? zod.z.any() : def.args;
+	return {
+		name: def.name,
+		args: argsSchema,
+		render: def.render,
+		...def.agentId ? { agentId: def.agentId } : {}
+	};
 }
 
 //#endregion
-//#region src/v2/components/MCPAppsActivityRenderer.tsx
-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:*";
-	const extra = extraCspDomains?.length ? " " + extraCspDomains.join(" ") : "";
-	return `<!doctype html>
-<html>
-<head>
-<meta charset="utf-8" />
-<meta http-equiv="Content-Security-Policy" content="default-src 'self'; img-src * data: blob: 'unsafe-inline'; media-src * blob: data:; font-src * blob: data:; script-src ${baseScriptSrc + extra}; style-src * blob: data: 'unsafe-inline'; connect-src *; frame-src ${baseFrameSrc + extra}; base-uri 'self';" />
-<style>html,body{margin:0;padding:0;height:100%;width:100%;overflow:hidden}*{box-sizing:border-box}iframe{background-color:transparent;border:none;padding:0;overflow:hidden;width:100%;height:100%}</style>
-</head>
-<body>
-<script>
-if(window.self===window.top){throw new Error("This file must be used in an iframe.")}
-const inner=document.createElement("iframe");
-inner.style="width:100%;height:100%;border:none;";
-inner.setAttribute("sandbox","allow-scripts allow-same-origin allow-forms");
-document.body.appendChild(inner);
-window.addEventListener("message",async(event)=>{
-if(event.source===window.parent){
-if(event.data&&event.data.method==="ui/notifications/sandbox-resource-ready"){
-const{html,sandbox}=event.data.params;
-if(typeof sandbox==="string")inner.setAttribute("sandbox",sandbox);
-if(typeof html==="string")inner.srcdoc=html;
-}else if(inner&&inner.contentWindow){
-inner.contentWindow.postMessage(event.data,"*");
-}
-}else if(event.source===inner.contentWindow){
-window.parent.postMessage(event.data,"*");
-}
-});
-window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-ready",params:{}},"*");
-<\/script>
-</body>
-</html>`;
-}
+//#region src/v2/hooks/use-render-tool.tsx
+const EMPTY_DEPS$1 = [];
 /**
-* Queue for serializing MCP app requests to an agent.
-* Ensures requests wait for the agent to stop running and are processed one at a time.
+* Registers a renderer entry in CopilotKit's `renderToolCalls` registry.
+*
+* Key behavior:
+* - deduplicates by `agentId:name` (latest registration wins),
+* - keeps renderer entries on cleanup so historical chat tool calls can still render,
+* - refreshes registration when `deps` change.
+*
+* @typeParam S - Schema type describing tool call parameters.
+* @param config - Renderer config for wildcard or named tools.
+* @param deps - Optional dependencies to refresh registration.
+*
+* @example
+* ```tsx
+* useRenderTool(
+*   {
+*     name: "searchDocs",
+*     parameters: z.object({ query: z.string() }),
+*     render: ({ status, parameters, result }) => {
+*       if (status === "executing") return <div>Searching {parameters.query}</div>;
+*       if (status === "complete") return <div>{result}</div>;
+*       return <div>Preparing...</div>;
+*     },
+*   },
+*   [],
+* );
+* ```
+*
+* @example
+* ```tsx
+* useRenderTool(
+*   {
+*     name: "summarize",
+*     parameters: z.object({ text: z.string() }),
+*     agentId: "research-agent",
+*     render: ({ name, status }) => <div>{name}: {status}</div>,
+*   },
+*   [selectedAgentId],
+* );
+* ```
 */
-var MCPAppsRequestQueue = class {
-	constructor() {
-		this.queues = /* @__PURE__ */ new Map();
-		this.processing = /* @__PURE__ */ new Map();
-	}
-	/**
-	* Add a request to the queue for a specific agent thread.
-	* Returns a promise that resolves when the request completes.
-	*/
-	async enqueue(agent, request) {
-		const threadId = agent.threadId || "default";
-		return new Promise((resolve, reject) => {
-			let queue = this.queues.get(threadId);
-			if (!queue) {
-				queue = [];
-				this.queues.set(threadId, queue);
-			}
-			queue.push({
-				execute: request,
-				resolve,
-				reject
-			});
-			this.processQueue(threadId, agent);
-		});
-	}
-	async processQueue(threadId, agent) {
-		if (this.processing.get(threadId)) return;
-		this.processing.set(threadId, true);
-		try {
-			const queue = this.queues.get(threadId);
-			if (!queue) return;
-			while (queue.length > 0) {
-				const item = queue[0];
-				try {
-					await this.waitForAgentIdle(agent);
-					const result = await item.execute();
-					item.resolve(result);
-				} catch (error) {
-					item.reject(error instanceof Error ? error : new Error(String(error)));
-				}
-				queue.shift();
-			}
-		} finally {
-			this.processing.set(threadId, false);
-		}
-	}
-	waitForAgentIdle(agent) {
-		return new Promise((resolve) => {
-			if (!agent.isRunning) {
-				resolve();
-				return;
-			}
-			let done = false;
-			const finish = () => {
-				if (done) return;
-				done = true;
-				clearInterval(checkInterval);
-				sub.unsubscribe();
-				resolve();
-			};
-			const sub = agent.subscribe({
-				onRunFinalized: finish,
-				onRunFailed: finish
-			});
-			const checkInterval = setInterval(() => {
-				if (!agent.isRunning) finish();
-			}, 500);
+function useRenderTool(config, deps) {
+	const { copilotkit } = useCopilotKit();
+	const extraDeps = deps ?? EMPTY_DEPS$1;
+	(0, react.useEffect)(() => {
+		const renderer = config.name === "*" && !config.parameters ? defineToolCallRenderer({
+			name: "*",
+			render: (props) => config.render({
+				...props,
+				parameters: props.args
+			}),
+			...config.agentId ? { agentId: config.agentId } : {}
+		}) : defineToolCallRenderer({
+			name: config.name,
+			args: config.parameters,
+			render: (props) => config.render({
+				...props,
+				parameters: props.args
+			}),
+			...config.agentId ? { agentId: config.agentId } : {}
 		});
-	}
-};
-const mcpAppsRequestQueue = new MCPAppsRequestQueue();
-/**
-* Activity type for MCP Apps events - must match the middleware's MCPAppsActivityType
-*/
-const MCPAppsActivityType = "mcp-apps";
-const MCPAppsActivityContentSchema = zod.z.object({
-	result: zod.z.object({
-		content: zod.z.array(zod.z.any()).optional(),
-		structuredContent: zod.z.any().optional(),
-		isError: zod.z.boolean().optional()
-	}),
-	resourceUri: zod.z.string(),
-	serverHash: zod.z.string(),
-	serverId: zod.z.string().optional(),
-	toolInput: zod.z.record(zod.z.unknown()).optional()
-});
-function isRequest(msg) {
-	return "id" in msg && "method" in msg;
-}
-function isNotification(msg) {
-	return !("id" in msg) && "method" in msg;
+		copilotkit.addHookRenderToolCall(renderer);
+	}, [
+		config.name,
+		copilotkit,
+		JSON.stringify(extraDeps)
+	]);
 }
+
+//#endregion
+//#region src/v2/hooks/use-default-render-tool.tsx
 /**
-* MCP Apps Extension Activity Renderer
+* Registers a wildcard (`"*"`) tool-call renderer via `useRenderTool`.
 *
-* Renders MCP Apps UI in a sandboxed iframe with full protocol support.
-* Fetches resource content on-demand via proxied MCP requests.
-*/
-const MCPAppsActivityRenderer = function MCPAppsActivityRenderer({ content, agent }) {
-	const { copilotkit } = useCopilotKit();
-	const containerRef = (0, react.useRef)(null);
-	const iframeRef = (0, react.useRef)(null);
-	const [iframeReady, setIframeReady] = (0, react.useState)(false);
-	const [error, setError] = (0, react.useState)(null);
-	const [isLoading, setIsLoading] = (0, react.useState)(true);
-	const [iframeSize, setIframeSize] = (0, react.useState)({});
-	const [fetchedResource, setFetchedResource] = (0, react.useState)(null);
-	const contentRef = (0, react.useRef)(content);
-	contentRef.current = content;
-	const agentRef = (0, react.useRef)(agent);
-	agentRef.current = agent;
-	const fetchStateRef = (0, react.useRef)({
-		inProgress: false,
-		promise: null,
-		resourceUri: null
-	});
-	const sendToIframe = (0, react.useCallback)((msg) => {
-		if (iframeRef.current?.contentWindow) {
+* - Call with no config to use CopilotKit's built-in default tool-call card.
+* - Pass `config.render` to replace the default UI with your own fallback renderer.
+*
+* This is useful when you want a generic renderer for tools that do not have a
+* dedicated `useRenderTool({ name: "..." })` registration.
+*
+* @param config - Optional custom wildcard render function.
+* @param deps - Optional dependencies to refresh registration.
+*
+* @example
+* ```tsx
+* useDefaultRenderTool();
+* ```
+*
+* @example
+* ```tsx
+* useDefaultRenderTool({
+*   render: ({ name, status }) => <div>{name}: {status}</div>,
+* });
+* ```
+*
+* @example
+* ```tsx
+* useDefaultRenderTool(
+*   {
+*     render: ({ name, result }) => (
+*       <ToolEventRow title={name} payload={result} compact={compactMode} />
+*     ),
+*   },
+*   [compactMode],
+* );
+* ```
+*/
+function useDefaultRenderTool(config, deps) {
+	useRenderTool({
+		name: "*",
+		render: config?.render ?? DefaultToolCallRenderer
+	}, deps);
+}
+function DefaultToolCallRenderer({ name, parameters, status, result }) {
+	const [isExpanded, setIsExpanded] = (0, react.useState)(false);
+	const statusString = String(status);
+	const isActive = statusString === "inProgress" || statusString === "executing";
+	const isComplete = statusString === "complete";
+	const statusLabel = isActive ? "Running" : isComplete ? "Done" : status;
+	const dotColor = isActive ? "#f59e0b" : isComplete ? "#10b981" : "#a1a1aa";
+	const badgeBg = isActive ? "#fef3c7" : isComplete ? "#d1fae5" : "#f4f4f5";
+	const badgeColor = isActive ? "#92400e" : isComplete ? "#065f46" : "#3f3f46";
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		"data-testid": "copilot-tool-render",
+		"data-tool-name": name,
+		"data-status": statusString,
+		"data-args": safeStringifyForAttr(parameters),
+		"data-result": safeStringifyForAttr(result),
+		style: {
+			marginTop: "8px",
+			paddingBottom: "8px"
+		},
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			style: {
+				borderRadius: "12px",
+				border: "1px solid #e4e4e7",
+				backgroundColor: "#fafafa",
+				padding: "14px 16px"
+			},
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				onClick: () => setIsExpanded(!isExpanded),
+				style: {
+					display: "flex",
+					alignItems: "center",
+					justifyContent: "space-between",
+					gap: "10px",
+					cursor: "pointer",
+					userSelect: "none"
+				},
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					style: {
+						display: "flex",
+						alignItems: "center",
+						gap: "8px",
+						minWidth: 0
+					},
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
+							style: {
+								height: "14px",
+								width: "14px",
+								color: "#71717a",
+								transition: "transform 0.15s",
+								transform: isExpanded ? "rotate(90deg)" : "rotate(0deg)",
+								flexShrink: 0
+							},
+							fill: "none",
+							viewBox: "0 0 24 24",
+							strokeWidth: 2,
+							stroke: "currentColor",
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
+								strokeLinecap: "round",
+								strokeLinejoin: "round",
+								d: "M8.25 4.5l7.5 7.5-7.5 7.5"
+							})
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { style: {
+							display: "inline-block",
+							height: "8px",
+							width: "8px",
+							borderRadius: "50%",
+							backgroundColor: dotColor,
+							flexShrink: 0
+						} }),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							"data-testid": "copilot-tool-render-name",
+							style: {
+								fontSize: "13px",
+								fontWeight: 600,
+								color: "#18181b",
+								overflow: "hidden",
+								textOverflow: "ellipsis",
+								whiteSpace: "nowrap"
+							},
+							children: name
+						})
+					]
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					"data-testid": "copilot-tool-render-status",
+					style: {
+						display: "inline-flex",
+						alignItems: "center",
+						borderRadius: "9999px",
+						padding: "2px 8px",
+						fontSize: "11px",
+						fontWeight: 500,
+						backgroundColor: badgeBg,
+						color: badgeColor,
+						flexShrink: 0
+					},
+					children: statusLabel
+				})]
+			}), isExpanded && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				style: {
+					marginTop: "12px",
+					display: "grid",
+					gap: "12px"
+				},
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					style: {
+						fontSize: "10px",
+						textTransform: "uppercase",
+						letterSpacing: "0.05em",
+						color: "#71717a"
+					},
+					children: "Arguments"
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
+					style: {
+						marginTop: "6px",
+						maxHeight: "200px",
+						overflow: "auto",
+						borderRadius: "6px",
+						backgroundColor: "#f4f4f5",
+						padding: "10px",
+						fontSize: "11px",
+						lineHeight: 1.6,
+						color: "#27272a",
+						whiteSpace: "pre-wrap",
+						wordBreak: "break-word"
+					},
+					children: JSON.stringify(parameters ?? {}, null, 2)
+				})] }), result !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					style: {
+						fontSize: "10px",
+						textTransform: "uppercase",
+						letterSpacing: "0.05em",
+						color: "#71717a"
+					},
+					children: "Result"
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
+					style: {
+						marginTop: "6px",
+						maxHeight: "200px",
+						overflow: "auto",
+						borderRadius: "6px",
+						backgroundColor: "#f4f4f5",
+						padding: "10px",
+						fontSize: "11px",
+						lineHeight: 1.6,
+						color: "#27272a",
+						whiteSpace: "pre-wrap",
+						wordBreak: "break-word"
+					},
+					children: typeof result === "string" ? result : JSON.stringify(result, null, 2)
+				})] })]
+			})]
+		})
+	});
+}
+function safeStringifyForAttr(value) {
+	if (value === void 0 || value === null) return "";
+	if (typeof value === "string") return value;
+	try {
+		return JSON.stringify(value);
+	} catch {
+		return String(value);
+	}
+}
+
+//#endregion
+//#region src/v2/hooks/use-render-tool-call.tsx
+/**
+* Memoized component that renders a single tool call.
+* This prevents unnecessary re-renders when parent components update
+* but the tool call data hasn't changed.
+*/
+const ToolCallRenderer = react.default.memo(function ToolCallRenderer({ toolCall, toolMessage, RenderComponent, isExecuting }) {
+	const args = (0, react.useMemo)(() => (0, _copilotkit_shared.partialJSONParse)(toolCall.function.arguments), [toolCall.function.arguments]);
+	const toolName = toolCall.function.name;
+	if (toolMessage) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderComponent, {
+		name: toolName,
+		toolCallId: toolCall.id,
+		args,
+		status: _copilotkit_core.ToolCallStatus.Complete,
+		result: toolMessage.content
+	});
+	else if (isExecuting) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderComponent, {
+		name: toolName,
+		toolCallId: toolCall.id,
+		args,
+		status: _copilotkit_core.ToolCallStatus.Executing,
+		result: void 0
+	});
+	else return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderComponent, {
+		name: toolName,
+		toolCallId: toolCall.id,
+		args,
+		status: _copilotkit_core.ToolCallStatus.InProgress,
+		result: void 0
+	});
+}, (prevProps, nextProps) => {
+	if (prevProps.toolCall.id !== nextProps.toolCall.id) return false;
+	if (prevProps.toolCall.function.name !== nextProps.toolCall.function.name) return false;
+	if (prevProps.toolCall.function.arguments !== nextProps.toolCall.function.arguments) return false;
+	if (prevProps.toolMessage?.content !== nextProps.toolMessage?.content) return false;
+	if (prevProps.isExecuting !== nextProps.isExecuting) return false;
+	if (prevProps.RenderComponent !== nextProps.RenderComponent) return false;
+	return true;
+});
+/**
+* Hook that returns a function to render tool calls based on the render functions
+* defined in CopilotKitProvider.
+*
+* @returns A function that takes a tool call and optional tool message and returns the rendered component
+*/
+function useRenderToolCall() {
+	const { copilotkit, executingToolCallIds } = useCopilotKit();
+	const agentId = useCopilotChatConfiguration()?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
+	const renderToolCalls = (0, react.useSyncExternalStore)((callback) => {
+		return copilotkit.subscribe({ onRenderToolCallsChanged: callback }).unsubscribe;
+	}, () => copilotkit.renderToolCalls, () => copilotkit.renderToolCalls);
+	return (0, react.useCallback)(({ toolCall, toolMessage }) => {
+		const exactMatches = renderToolCalls.filter((rc) => rc.name === toolCall.function.name);
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCallRenderer, {
+			toolCall,
+			toolMessage,
+			RenderComponent: (exactMatches.find((rc) => rc.agentId === agentId) || exactMatches.find((rc) => !rc.agentId) || exactMatches[0] || renderToolCalls.find((rc) => rc.name === "*"))?.render ?? defaultToolCallRenderAdapter,
+			isExecuting: executingToolCallIds.has(toolCall.id)
+		}, toolCall.id);
+	}, [
+		renderToolCalls,
+		executingToolCallIds,
+		agentId
+	]);
+}
+function defaultToolCallRenderAdapter(props) {
+	const status = props.status === _copilotkit_core.ToolCallStatus.Complete ? "complete" : props.status === _copilotkit_core.ToolCallStatus.Executing ? "executing" : "inProgress";
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DefaultToolCallRenderer, {
+		name: props.name,
+		parameters: props.args,
+		status,
+		result: props.result
+	});
+}
+
+//#endregion
+//#region src/v2/components/CopilotKitInspector.tsx
+const CopilotKitInspector = ({ core, ...rest }) => {
+	const [InspectorComponent, setInspectorComponent] = react.useState(null);
+	react.useEffect(() => {
+		let mounted = true;
+		import("@copilotkit/web-inspector").then((mod) => {
+			mod.defineWebInspector?.();
+			const Component = (0, _lit_labs_react.createComponent)({
+				tagName: mod.WEB_INSPECTOR_TAG,
+				elementClass: mod.WebInspectorElement,
+				react
+			});
+			if (mounted) setInspectorComponent(() => Component);
+		});
+		return () => {
+			mounted = false;
+		};
+	}, []);
+	if (!InspectorComponent) return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(InspectorComponent, {
+		...rest,
+		core: core ?? null
+	});
+};
+CopilotKitInspector.displayName = "CopilotKitInspector";
+
+//#endregion
+//#region src/v2/components/license-warning-banner.tsx
+const LICENSE_BANNER_OFFSET_PX = 52;
+const LICENSE_BANNER_OFFSET_VAR = "--copilotkit-license-banner-offset";
+const BANNER_STYLES = {
+	base: {
+		position: "fixed",
+		bottom: "8px",
+		left: "50%",
+		transform: "translateX(-50%)",
+		zIndex: 99999,
+		display: "inline-flex",
+		alignItems: "center",
+		gap: "12px",
+		whiteSpace: "nowrap",
+		padding: "8px 16px",
+		fontSize: "13px",
+		fontFamily: "-apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif",
+		borderRadius: "6px",
+		boxShadow: "0 2px 8px rgba(0, 0, 0, 0.15)"
+	},
+	info: {
+		backgroundColor: "#eff6ff",
+		border: "1px solid #93c5fd",
+		color: "#1e40af"
+	},
+	warning: {
+		backgroundColor: "#fffbeb",
+		border: "1px solid #fbbf24",
+		color: "#92400e"
+	},
+	critical: {
+		backgroundColor: "#fef2f2",
+		border: "1px solid #fca5a5",
+		color: "#991b1b"
+	}
+};
+function getSeverityStyle(severity) {
+	switch (severity) {
+		case "warning": return BANNER_STYLES.warning;
+		case "critical": return BANNER_STYLES.critical;
+		default: return BANNER_STYLES.info;
+	}
+}
+function BannerShell({ severity, message, actionLabel, actionUrl, onDismiss }) {
+	(0, react.useEffect)(() => {
+		if (typeof document === "undefined") return;
+		const root = document.documentElement;
+		root.style.setProperty(LICENSE_BANNER_OFFSET_VAR, `${LICENSE_BANNER_OFFSET_PX}px`);
+		return () => {
+			root.style.removeProperty(LICENSE_BANNER_OFFSET_VAR);
+		};
+	}, []);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		style: {
+			...BANNER_STYLES.base,
+			...getSeverityStyle(severity)
+		},
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: message }), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			style: {
+				display: "flex",
+				gap: "8px",
+				alignItems: "center"
+			},
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
+				href: actionUrl,
+				target: "_blank",
+				rel: "noopener noreferrer",
+				style: {
+					fontWeight: 600,
+					textDecoration: "underline",
+					color: "inherit"
+				},
+				children: actionLabel
+			}), onDismiss && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				onClick: onDismiss,
+				style: {
+					background: "none",
+					border: "none",
+					cursor: "pointer",
+					color: "inherit",
+					fontSize: "16px"
+				},
+				children: "×"
+			})]
+		})]
+	});
+}
+function LicenseWarningBanner({ type, featureName, expiryDate, graceRemaining, onDismiss }) {
+	switch (type) {
+		case "no_license": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BannerShell, {
+			severity: "info",
+			message: "Powered by CopilotKit",
+			actionLabel: "Get a license",
+			actionUrl: "https://copilotkit.ai/pricing",
+			onDismiss
+		});
+		case "feature_unlicensed": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BannerShell, {
+			severity: "warning",
+			message: `⚠ The "${featureName}" feature requires a CopilotKit license.`,
+			actionLabel: "Get a license",
+			actionUrl: "https://copilotkit.ai/pricing",
+			onDismiss
+		});
+		case "expiring": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BannerShell, {
+			severity: "warning",
+			message: `Your CopilotKit license expires in ${graceRemaining} day${graceRemaining !== 1 ? "s" : ""}. Please renew.`,
+			actionLabel: "Renew",
+			actionUrl: "https://cloud.copilotkit.ai",
+			onDismiss
+		});
+		case "expired": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BannerShell, {
+			severity: "critical",
+			message: `Your CopilotKit license expired${expiryDate ? ` on ${expiryDate}` : ""}. Please renew at copilotkit.ai/pricing`,
+			actionLabel: "Renew now",
+			actionUrl: "https://copilotkit.ai/pricing",
+			onDismiss
+		});
+		case "invalid": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BannerShell, {
+			severity: "critical",
+			message: "Invalid CopilotKit license token. Please check your configuration.",
+			actionLabel: "Get a license",
+			actionUrl: "https://copilotkit.ai/pricing",
+			onDismiss
+		});
+		default: return null;
+	}
+}
+function InlineFeatureWarning({ featureName }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		style: {
+			padding: "8px 12px",
+			backgroundColor: "#fffbeb",
+			border: "1px solid #fbbf24",
+			borderRadius: "6px",
+			fontSize: "13px",
+			color: "#92400e",
+			fontFamily: "-apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif"
+		},
+		children: [
+			"⚠ The \"",
+			featureName,
+			"\" feature requires a CopilotKit license.",
+			" ",
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
+				href: "https://copilotkit.ai/pricing",
+				target: "_blank",
+				rel: "noopener noreferrer",
+				style: {
+					color: "#b45309",
+					textDecoration: "underline"
+				},
+				children: "Get one at copilotkit.ai/pricing"
+			})
+		]
+	});
+}
+
+//#endregion
+//#region src/v2/components/MCPAppsActivityRenderer.tsx
+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:*";
+	const extra = extraCspDomains?.length ? " " + extraCspDomains.join(" ") : "";
+	return `<!doctype html>
+<html>
+<head>
+<meta charset="utf-8" />
+<meta http-equiv="Content-Security-Policy" content="default-src 'self'; img-src * data: blob: 'unsafe-inline'; media-src * blob: data:; font-src * blob: data:; script-src ${baseScriptSrc + extra}; style-src * blob: data: 'unsafe-inline'; connect-src *; frame-src ${baseFrameSrc + extra}; base-uri 'self';" />
+<style>html,body{margin:0;padding:0;height:100%;width:100%;overflow:hidden}*{box-sizing:border-box}iframe{background-color:transparent;border:none;padding:0;overflow:hidden;width:100%;height:100%}</style>
+</head>
+<body>
+<script>
+if(window.self===window.top){throw new Error("This file must be used in an iframe.")}
+const inner=document.createElement("iframe");
+inner.style="width:100%;height:100%;border:none;";
+inner.setAttribute("sandbox","allow-scripts allow-same-origin allow-forms");
+document.body.appendChild(inner);
+window.addEventListener("message",async(event)=>{
+if(event.source===window.parent){
+if(event.data&&event.data.method==="ui/notifications/sandbox-resource-ready"){
+const{html,sandbox}=event.data.params;
+if(typeof sandbox==="string")inner.setAttribute("sandbox",sandbox);
+if(typeof html==="string")inner.srcdoc=html;
+}else if(inner&&inner.contentWindow){
+inner.contentWindow.postMessage(event.data,"*");
+}
+}else if(event.source===inner.contentWindow){
+window.parent.postMessage(event.data,"*");
+}
+});
+window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-ready",params:{}},"*");
+<\/script>
+</body>
+</html>`;
+}
+/**
+* Queue for serializing MCP app requests to an agent.
+* Ensures requests wait for the agent to stop running and are processed one at a time.
+*/
+var MCPAppsRequestQueue = class {
+	constructor() {
+		this.queues = /* @__PURE__ */ new Map();
+		this.processing = /* @__PURE__ */ new Map();
+	}
+	/**
+	* Add a request to the queue for a specific agent thread.
+	* Returns a promise that resolves when the request completes.
+	*/
+	async enqueue(agent, request) {
+		const threadId = agent.threadId || "default";
+		return new Promise((resolve, reject) => {
+			let queue = this.queues.get(threadId);
+			if (!queue) {
+				queue = [];
+				this.queues.set(threadId, queue);
+			}
+			queue.push({
+				execute: request,
+				resolve,
+				reject
+			});
+			this.processQueue(threadId, agent);
+		});
+	}
+	async processQueue(threadId, agent) {
+		if (this.processing.get(threadId)) return;
+		this.processing.set(threadId, true);
+		try {
+			const queue = this.queues.get(threadId);
+			if (!queue) return;
+			while (queue.length > 0) {
+				const item = queue[0];
+				try {
+					await this.waitForAgentIdle(agent);
+					const result = await item.execute();
+					item.resolve(result);
+				} catch (error) {
+					item.reject(error instanceof Error ? error : new Error(String(error)));
+				}
+				queue.shift();
+			}
+		} finally {
+			this.processing.set(threadId, false);
+		}
+	}
+	waitForAgentIdle(agent) {
+		return new Promise((resolve) => {
+			if (!agent.isRunning) {
+				resolve();
+				return;
+			}
+			let done = false;
+			const finish = () => {
+				if (done) return;
+				done = true;
+				clearInterval(checkInterval);
+				sub.unsubscribe();
+				resolve();
+			};
+			const sub = agent.subscribe({
+				onRunFinalized: finish,
+				onRunFailed: finish
+			});
+			const checkInterval = setInterval(() => {
+				if (!agent.isRunning) finish();
+			}, 500);
+		});
+	}
+};
+const mcpAppsRequestQueue = new MCPAppsRequestQueue();
+/**
+* Activity type for MCP Apps events - must match the middleware's MCPAppsActivityType
+*/
+const MCPAppsActivityType = "mcp-apps";
+const MCPAppsActivityContentSchema = zod.z.object({
+	result: zod.z.object({
+		content: zod.z.array(zod.z.any()).optional(),
+		structuredContent: zod.z.any().optional(),
+		isError: zod.z.boolean().optional()
+	}),
+	resourceUri: zod.z.string(),
+	serverHash: zod.z.string(),
+	serverId: zod.z.string().optional(),
+	toolInput: zod.z.record(zod.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.
+*/
+const MCPAppsActivityRenderer = function MCPAppsActivityRenderer({ content, agent }) {
+	const { copilotkit } = useCopilotKit();
+	const containerRef = (0, react.useRef)(null);
+	const iframeRef = (0, react.useRef)(null);
+	const [iframeReady, setIframeReady] = (0, react.useState)(false);
+	const [error, setError] = (0, react.useState)(null);
+	const [isLoading, setIsLoading] = (0, react.useState)(true);
+	const [iframeSize, setIframeSize] = (0, react.useState)({});
+	const [fetchedResource, setFetchedResource] = (0, react.useState)(null);
+	const contentRef = (0, react.useRef)(content);
+	contentRef.current = content;
+	const agentRef = (0, react.useRef)(agent);
+	agentRef.current = agent;
+	const fetchStateRef = (0, react.useRef)({
+		inProgress: false,
+		promise: null,
+		resourceUri: null
+	});
+	const sendToIframe = (0, react.useCallback)((msg) => {
+		if (iframeRef.current?.contentWindow) {
 			console.log("[MCPAppsRenderer] Sending to iframe:", msg);
 			iframeRef.current.contentWindow.postMessage(msg, "*");
 		}
@@ -2562,18 +3053,6 @@ function getOperationSurfaceId(operation) {
 	return operation?.createSurface?.surfaceId ?? operation?.updateComponents?.surfaceId ?? operation?.updateDataModel?.surfaceId ?? operation?.deleteSurface?.surfaceId ?? null;
 }
 
-//#endregion
-//#region src/v2/types/defineToolCallRenderer.ts
-function defineToolCallRenderer(def) {
-	const argsSchema = def.name === "*" && !def.args ? zod.z.any() : def.args;
-	return {
-		name: def.name,
-		args: argsSchema,
-		render: def.render,
-		...def.agentId ? { agentId: def.agentId } : {}
-	};
-}
-
 //#endregion
 //#region src/v2/a2ui/A2UIToolCallRenderer.tsx
 /**
@@ -2944,124 +3423,28 @@ function A2UICatalogContext({ catalog, includeSchema }) {
 		value: (0, _copilotkit_a2ui_renderer.buildCatalogContextValue)(catalog)
 	});
 	const { copilotkit } = useCopilotKit();
-	const schemaValue = (0, react.useMemo)(() => includeSchema !== false ? JSON.stringify((0, _copilotkit_a2ui_renderer.extractCatalogComponentSchemas)(catalog)) : null, [catalog, includeSchema]);
-	(0, react.useLayoutEffect)(() => {
-		if (!copilotkit || !schemaValue) return;
-		const ids = [];
-		ids.push(copilotkit.addContext({
-			description: _copilotkit_a2ui_renderer.A2UI_SCHEMA_CONTEXT_DESCRIPTION,
-			value: schemaValue
-		}));
-		ids.push(copilotkit.addContext({
-			description: "A2UI generation guidelines — protocol rules, tool arguments, path rules, data model format, and form/two-way-binding instructions.",
-			value: _copilotkit_shared.A2UI_DEFAULT_GENERATION_GUIDELINES
-		}));
-		ids.push(copilotkit.addContext({
-			description: "A2UI design guidelines — visual design rules, component hierarchy tips, and action handler patterns.",
-			value: _copilotkit_shared.A2UI_DEFAULT_DESIGN_GUIDELINES
-		}));
-		return () => {
-			for (const id of ids) copilotkit.removeContext(id);
-		};
-	}, [copilotkit, schemaValue]);
-	return null;
-}
-
-//#endregion
-//#region src/v2/lib/react-core.ts
-var CopilotKitCoreReact = class extends _copilotkit_core.CopilotKitCore {
-	constructor(config) {
-		super(config);
-		this._renderToolCalls = [];
-		this._hookRenderToolCalls = /* @__PURE__ */ new Map();
-		this._cachedMergedRenderToolCalls = null;
-		this._renderCustomMessages = [];
-		this._renderActivityMessages = [];
-		this._interruptElement = null;
-		this._renderToolCalls = config.renderToolCalls ?? [];
-		this._renderCustomMessages = config.renderCustomMessages ?? [];
-		this._renderActivityMessages = config.renderActivityMessages ?? [];
-	}
-	get renderCustomMessages() {
-		return this._renderCustomMessages;
-	}
-	get renderActivityMessages() {
-		return this._renderActivityMessages;
-	}
-	get renderToolCalls() {
-		if (this._hookRenderToolCalls.size === 0) return this._renderToolCalls;
-		if (this._cachedMergedRenderToolCalls) return this._cachedMergedRenderToolCalls;
-		const merged = /* @__PURE__ */ new Map();
-		for (const rc of this._renderToolCalls) merged.set(`${rc.agentId ?? ""}:${rc.name}`, rc);
-		for (const [key, rc] of this._hookRenderToolCalls) merged.set(key, rc);
-		this._cachedMergedRenderToolCalls = Array.from(merged.values());
-		return this._cachedMergedRenderToolCalls;
-	}
-	setRenderActivityMessages(renderers) {
-		this._renderActivityMessages = renderers;
-	}
-	setRenderCustomMessages(renderers) {
-		this._renderCustomMessages = renderers;
-	}
-	setRenderToolCalls(renderToolCalls) {
-		this._renderToolCalls = renderToolCalls;
-		this._cachedMergedRenderToolCalls = null;
-		this._notifyRenderToolCallsChanged();
-	}
-	addHookRenderToolCall(entry) {
-		const key = `${entry.agentId ?? ""}:${entry.name}`;
-		this._hookRenderToolCalls.set(key, entry);
-		this._cachedMergedRenderToolCalls = null;
-		this._notifyRenderToolCallsChanged();
-	}
-	removeHookRenderToolCall(name, agentId) {
-		const key = `${agentId ?? ""}:${name}`;
-		if (this._hookRenderToolCalls.delete(key)) {
-			this._cachedMergedRenderToolCalls = null;
-			this._notifyRenderToolCallsChanged();
-		}
-	}
-	_notifyRenderToolCallsChanged() {
-		this.notifySubscribers((subscriber) => {
-			const reactSubscriber = subscriber;
-			if (reactSubscriber.onRenderToolCallsChanged) reactSubscriber.onRenderToolCallsChanged({
-				copilotkit: this,
-				renderToolCalls: this.renderToolCalls
-			});
-		}, "Subscriber onRenderToolCallsChanged error:");
-	}
-	get interruptElement() {
-		return this._interruptElement;
-	}
-	setInterruptElement(element) {
-		this._interruptElement = element;
-		this.notifySubscribers((subscriber) => {
-			subscriber.onInterruptElementChanged?.({
-				copilotkit: this,
-				interruptElement: this._interruptElement
-			});
-		}, "Subscriber onInterruptElementChanged error:");
-	}
-	subscribe(subscriber) {
-		return super.subscribe(subscriber);
-	}
-	/**
-	* Wait for pending React state updates before the follow-up agent run.
-	*
-	* When a frontend tool handler calls setState(), React 18 batches the update
-	* and schedules a commit via its internal scheduler (MessageChannel). The
-	* useAgentContext hook registers context via useLayoutEffect, which runs
-	* synchronously after React commits that batch.
-	*
-	* Awaiting a zero-delay timeout yields to the macrotask queue. React's
-	* MessageChannel task runs first, committing the pending state and running
-	* useLayoutEffect (which updates the context store). The follow-up runAgent
-	* call then reads fresh context.
-	*/
-	async waitForPendingFrameworkUpdates() {
-		await new Promise((resolve) => setTimeout(resolve, 0));
-	}
-};
+	const schemaValue = (0, react.useMemo)(() => includeSchema !== false ? JSON.stringify((0, _copilotkit_a2ui_renderer.extractCatalogComponentSchemas)(catalog)) : null, [catalog, includeSchema]);
+	(0, react.useLayoutEffect)(() => {
+		if (!copilotkit || !schemaValue) return;
+		const ids = [];
+		ids.push(copilotkit.addContext({
+			description: _copilotkit_a2ui_renderer.A2UI_SCHEMA_CONTEXT_DESCRIPTION,
+			value: schemaValue
+		}));
+		ids.push(copilotkit.addContext({
+			description: "A2UI generation guidelines — protocol rules, tool arguments, path rules, data model format, and form/two-way-binding instructions.",
+			value: _copilotkit_shared.A2UI_DEFAULT_GENERATION_GUIDELINES
+		}));
+		ids.push(copilotkit.addContext({
+			description: "A2UI design guidelines — visual design rules, component hierarchy tips, and action handler patterns.",
+			value: _copilotkit_shared.A2UI_DEFAULT_DESIGN_GUIDELINES
+		}));
+		return () => {
+			for (const id of ids) copilotkit.removeContext(id);
+		};
+	}, [copilotkit, schemaValue]);
+	return null;
+}
 
 //#endregion
 //#region src/v2/providers/CopilotKitProvider.tsx
@@ -3078,12 +3461,6 @@ const DEFAULT_DESIGN_SKILL = `When generating UI with generateSandboxedUi, follo
 - Minimal transitions (150ms) for hover/focus states only. No decorative animations.
 - Keep the UI focused and dense — avoid excessive padding. Use compact spacing (8–12px gaps, 10–14px padding in controls).`;
 const GENERATE_SANDBOXED_UI_DESCRIPTION = "Generate sandboxed UI. IMPORTANT: The generated code runs in a sandboxed iframe WITHOUT same-origin access. Do NOT use localStorage, sessionStorage, document.cookie, IndexedDB, or fetch/XMLHttpRequest to same-origin URLs. To communicate with the host application, use Websandbox.connection.remote.<functionName>(args) which returns a Promise.\n\nYou CAN use external libraries from CDNs by including <script> or <link> tags in the HTML <head> (e.g., Chart.js, D3, Three.js, x-data-spreadsheet, etc.). CDN resources load normally inside the sandbox.\n\nPARAMETER ORDER IS CRITICAL — generate parameters in exactly this order:\n1. initialHeight + placeholderMessages (shown to user while generating)\n2. css (all styles FIRST — the user sees a placeholder until CSS is complete)\n3. html (streams in live — the user watches the UI build as HTML is generated)\n4. jsFunctions (reusable helper functions)\n5. jsExpressions (applied one-by-one — the user sees each expression take effect)";
-const CopilotKitContext = (0, react.createContext)({
-	copilotkit: null,
-	executingToolCallIds: /* @__PURE__ */ new Set()
-});
-const LicenseContext = (0, react.createContext)((0, _copilotkit_shared.createLicenseContextValue)(null));
-const useLicenseContext = () => (0, react.useContext)(LicenseContext);
 function useStableArrayProp(prop, warningMessage, isMeaningfulChange) {
 	const empty = (0, react.useMemo)(() => [], []);
 	const value = prop ?? empty;
@@ -3305,13 +3682,9 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = {}, c
 		onErrorRef.current = onError;
 	}, [onError]);
 	(0, react.useEffect)(() => {
-		if (!onErrorRef.current) return;
 		const subscription = copilotkit.subscribe({ onError: (event) => {
-			onErrorRef.current?.({
-				error: event.error,
-				code: event.code,
-				context: event.context
-			});
+			if (onErrorRef.current) onErrorRef.current(event);
+			else console.error(`[CopilotKit] Error (${event.code}):`, event.error, event.context ?? {});
 		} });
 		return () => {
 			subscription.unsubscribe();
@@ -3379,299 +3752,53 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = {}, c
 			name: fn.name,
 			description: fn.description,
 			parameters: (0, _copilotkit_shared.schemaToJsonSchema)(fn.parameters, { zodToJsonSchema: zod_to_json_schema.zodToJsonSchema })
-		})));
-	}, [sandboxFunctionsList]);
-	(0, react.useLayoutEffect)(() => {
-		if (!copilotkit || !sandboxFunctionsDescriptors || !openGenUIActive) return;
-		const id = copilotkit.addContext({
-			description: "Sandbox functions available in generated sandboxed UI code. Call via: await Websandbox.connection.remote.<functionName>(args)",
-			value: sandboxFunctionsDescriptors
-		});
-		return () => {
-			copilotkit.removeContext(id);
-		};
-	}, [
-		copilotkit,
-		sandboxFunctionsDescriptors,
-		openGenUIActive
-	]);
-	const contextValue = (0, react.useMemo)(() => ({
-		copilotkit,
-		executingToolCallIds
-	}), [copilotkit, executingToolCallIds]);
-	const licenseContextValue = (0, react.useMemo)(() => (0, _copilotkit_shared.createLicenseContextValue)(null), []);
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SandboxFunctionsContext.Provider, {
-		value: sandboxFunctionsList,
-		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotKitContext.Provider, {
-			value: contextValue,
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(LicenseContext.Provider, {
-				value: licenseContextValue,
-				children: [
-					runtimeA2UIEnabled && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(A2UIBuiltInToolCallRenderer, {}),
-					runtimeA2UIEnabled && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(A2UICatalogContext, {
-						catalog: a2ui?.catalog,
-						includeSchema: a2ui?.includeSchema
-					}),
-					children,
-					shouldRenderInspector ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotKitInspector, {
-						core: copilotkit,
-						defaultAnchor: inspectorDefaultAnchor
-					}) : null,
-					runtimeLicenseStatus === "none" && !resolvedPublicKey && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LicenseWarningBanner, { type: "no_license" }),
-					runtimeLicenseStatus === "expired" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LicenseWarningBanner, { type: "expired" }),
-					runtimeLicenseStatus === "invalid" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LicenseWarningBanner, { type: "invalid" }),
-					runtimeLicenseStatus === "expiring" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LicenseWarningBanner, { type: "expiring" })
-				]
-			})
-		})
-	});
-};
-const useCopilotKit = () => {
-	const context = (0, react.useContext)(CopilotKitContext);
-	const [, forceUpdate] = (0, react.useReducer)((x) => x + 1, 0);
-	if (!context) throw new Error("useCopilotKit must be used within CopilotKitProvider");
-	(0, react.useEffect)(() => {
-		const subscription = context.copilotkit.subscribe({ onRuntimeConnectionStatusChanged: () => {
-			forceUpdate();
-		} });
-		return () => {
-			subscription.unsubscribe();
-		};
-	}, []);
-	return context;
-};
-
-//#endregion
-//#region src/v2/hooks/use-render-tool-call.tsx
-/**
-* Memoized component that renders a single tool call.
-* This prevents unnecessary re-renders when parent components update
-* but the tool call data hasn't changed.
-*/
-const ToolCallRenderer = react.default.memo(function ToolCallRenderer({ toolCall, toolMessage, RenderComponent, isExecuting }) {
-	const args = (0, react.useMemo)(() => (0, _copilotkit_shared.partialJSONParse)(toolCall.function.arguments), [toolCall.function.arguments]);
-	const toolName = toolCall.function.name;
-	if (toolMessage) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderComponent, {
-		name: toolName,
-		toolCallId: toolCall.id,
-		args,
-		status: _copilotkit_core.ToolCallStatus.Complete,
-		result: toolMessage.content
-	});
-	else if (isExecuting) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderComponent, {
-		name: toolName,
-		toolCallId: toolCall.id,
-		args,
-		status: _copilotkit_core.ToolCallStatus.Executing,
-		result: void 0
-	});
-	else return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderComponent, {
-		name: toolName,
-		toolCallId: toolCall.id,
-		args,
-		status: _copilotkit_core.ToolCallStatus.InProgress,
-		result: void 0
-	});
-}, (prevProps, nextProps) => {
-	if (prevProps.toolCall.id !== nextProps.toolCall.id) return false;
-	if (prevProps.toolCall.function.name !== nextProps.toolCall.function.name) return false;
-	if (prevProps.toolCall.function.arguments !== nextProps.toolCall.function.arguments) return false;
-	if (prevProps.toolMessage?.content !== nextProps.toolMessage?.content) return false;
-	if (prevProps.isExecuting !== nextProps.isExecuting) return false;
-	if (prevProps.RenderComponent !== nextProps.RenderComponent) return false;
-	return true;
-});
-/**
-* Hook that returns a function to render tool calls based on the render functions
-* defined in CopilotKitProvider.
-*
-* @returns A function that takes a tool call and optional tool message and returns the rendered component
-*/
-function useRenderToolCall() {
-	const { copilotkit, executingToolCallIds } = useCopilotKit();
-	const agentId = useCopilotChatConfiguration()?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
-	const renderToolCalls = (0, react.useSyncExternalStore)((callback) => {
-		return copilotkit.subscribe({ onRenderToolCallsChanged: callback }).unsubscribe;
-	}, () => copilotkit.renderToolCalls, () => copilotkit.renderToolCalls);
-	return (0, react.useCallback)(({ toolCall, toolMessage }) => {
-		const exactMatches = renderToolCalls.filter((rc) => rc.name === toolCall.function.name);
-		const renderConfig = exactMatches.find((rc) => rc.agentId === agentId) || exactMatches.find((rc) => !rc.agentId) || exactMatches[0] || renderToolCalls.find((rc) => rc.name === "*");
-		if (!renderConfig) return null;
-		const RenderComponent = renderConfig.render;
-		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCallRenderer, {
-			toolCall,
-			toolMessage,
-			RenderComponent,
-			isExecuting: executingToolCallIds.has(toolCall.id)
-		}, toolCall.id);
-	}, [
-		renderToolCalls,
-		executingToolCallIds,
-		agentId
-	]);
-}
-
-//#endregion
-//#region src/v2/hooks/use-agent.tsx
-let UseAgentUpdate = /* @__PURE__ */ function(UseAgentUpdate) {
-	UseAgentUpdate["OnMessagesChanged"] = "OnMessagesChanged";
-	UseAgentUpdate["OnStateChanged"] = "OnStateChanged";
-	UseAgentUpdate["OnRunStatusChanged"] = "OnRunStatusChanged";
-	return UseAgentUpdate;
-}({});
-const ALL_UPDATES = [
-	UseAgentUpdate.OnMessagesChanged,
-	UseAgentUpdate.OnStateChanged,
-	UseAgentUpdate.OnRunStatusChanged
-];
-/**
-* Clone a registry agent for per-thread isolation.
-* Copies agent configuration (transport, headers, etc.) but resets conversation
-* state (messages, threadId, state) so each thread starts fresh.
-*/
-function cloneForThread(source, threadId, headers) {
-	const clone = source.clone();
-	if (clone === source) throw new Error(`useAgent: ${source.constructor.name}.clone() returned the same instance. clone() must return a new, independent object.`);
-	clone.threadId = threadId;
-	clone.setMessages([]);
-	clone.setState({});
-	if (clone instanceof _ag_ui_client.HttpAgent) clone.headers = { ...headers };
-	return clone;
-}
-/**
-* Module-level WeakMap: registryAgent → (threadId → clone).
-* Shared across all useAgent() calls so that every component using the same
-* (agentId, threadId) pair receives the same agent instance. Using WeakMap
-* ensures the clone map is garbage-collected when the registry agent is
-* replaced (e.g. after reconnect or hot-reload).
-*/
-const globalThreadCloneMap = /* @__PURE__ */ new WeakMap();
-/**
-* Look up an existing per-thread clone without creating one.
-* Returns undefined when no clone has been created yet for this pair.
-*/
-function getThreadClone(registryAgent, threadId) {
-	if (!registryAgent || !threadId) return void 0;
-	return globalThreadCloneMap.get(registryAgent)?.get(threadId);
-}
-function getOrCreateThreadClone(existing, threadId, headers) {
-	let byThread = globalThreadCloneMap.get(existing);
-	if (!byThread) {
-		byThread = /* @__PURE__ */ new Map();
-		globalThreadCloneMap.set(existing, byThread);
-	}
-	const cached = byThread.get(threadId);
-	if (cached) return cached;
-	const clone = cloneForThread(existing, threadId, headers);
-	byThread.set(threadId, clone);
-	return clone;
-}
-function useAgent({ agentId, threadId, updates, throttleMs } = {}) {
-	agentId ??= _copilotkit_shared.DEFAULT_AGENT_ID;
-	const { copilotkit } = useCopilotKit();
-	const providerThrottleMs = copilotkit.defaultThrottleMs;
-	const chatConfig = useCopilotChatConfiguration();
-	threadId ??= chatConfig?.threadId;
-	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 cacheKey = threadId ? `${agentId}:${threadId}` : agentId;
-		const existing = copilotkit.getAgent(agentId);
-		if (existing) {
-			provisionalAgentCache.current.delete(cacheKey);
-			provisionalAgentCache.current.delete(agentId);
-			if (!threadId) return existing;
-			return getOrCreateThreadClone(existing, threadId, copilotkit.headers);
-		}
-		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(cacheKey);
-			if (cached) {
-				cached.headers = { ...copilotkit.headers };
-				return cached;
-			}
-			const provisional = new _copilotkit_core.ProxiedCopilotRuntimeAgent({
-				runtimeUrl: copilotkit.runtimeUrl,
-				agentId,
-				transport: copilotkit.runtimeTransport,
-				runtimeMode: "pending"
-			});
-			provisional.headers = { ...copilotkit.headers };
-			if (threadId) provisional.threadId = threadId;
-			provisionalAgentCache.current.set(cacheKey, provisional);
-			return provisional;
-		}
-		if (isRuntimeConfigured && status === _copilotkit_core.CopilotKitCoreRuntimeConnectionStatus.Error) {
-			const cached = provisionalAgentCache.current.get(cacheKey);
-			if (cached) {
-				cached.headers = { ...copilotkit.headers };
-				return cached;
-			}
-			const provisional = new _copilotkit_core.ProxiedCopilotRuntimeAgent({
-				runtimeUrl: copilotkit.runtimeUrl,
-				agentId,
-				transport: copilotkit.runtimeTransport,
-				runtimeMode: "pending"
-			});
-			provisional.headers = { ...copilotkit.headers };
-			if (threadId) provisional.threadId = threadId;
-			provisionalAgentCache.current.set(cacheKey, 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.");
-	}, [
-		agentId,
-		threadId,
-		copilotkit.agents,
-		copilotkit.runtimeConnectionStatus,
-		copilotkit.runtimeUrl,
-		copilotkit.runtimeTransport,
-		JSON.stringify(copilotkit.headers)
-	]);
-	(0, react.useEffect)(() => {
-		if (updateFlags.length === 0) return;
-		let active = true;
-		const handlers = {};
-		let batchScheduled = false;
-		const batchedForceUpdate = () => {
-			if (!active) return;
-			if (!batchScheduled) {
-				batchScheduled = true;
-				queueMicrotask(() => {
-					batchScheduled = false;
-					if (active) forceUpdate();
-				});
-			}
-		};
-		if (updateFlags.includes(UseAgentUpdate.OnMessagesChanged)) handlers.onMessagesChanged = forceUpdate;
-		if (updateFlags.includes(UseAgentUpdate.OnStateChanged)) handlers.onStateChanged = batchedForceUpdate;
-		if (updateFlags.includes(UseAgentUpdate.OnRunStatusChanged)) {
-			handlers.onRunInitialized = batchedForceUpdate;
-			handlers.onRunFinalized = batchedForceUpdate;
-			handlers.onRunFailed = batchedForceUpdate;
-			handlers.onRunErrorEvent = batchedForceUpdate;
-		}
-		const subscription = copilotkit.subscribeToAgentWithOptions(agent, handlers, { throttleMs });
+		})));
+	}, [sandboxFunctionsList]);
+	(0, react.useLayoutEffect)(() => {
+		if (!copilotkit || !sandboxFunctionsDescriptors || !openGenUIActive) return;
+		const id = copilotkit.addContext({
+			description: "Sandbox functions available in generated sandboxed UI code. Call via: await Websandbox.connection.remote.<functionName>(args)",
+			value: sandboxFunctionsDescriptors
+		});
 		return () => {
-			active = false;
-			subscription.unsubscribe();
+			copilotkit.removeContext(id);
 		};
 	}, [
-		agent,
-		forceUpdate,
-		throttleMs,
-		providerThrottleMs,
-		updateFlags
+		copilotkit,
+		sandboxFunctionsDescriptors,
+		openGenUIActive
 	]);
-	(0, react.useEffect)(() => {
-		if (agent instanceof _ag_ui_client.HttpAgent) agent.headers = { ...copilotkit.headers };
-	}, [agent, JSON.stringify(copilotkit.headers)]);
-	return { agent };
-}
+	const contextValue = (0, react.useMemo)(() => ({
+		copilotkit,
+		executingToolCallIds
+	}), [copilotkit, executingToolCallIds]);
+	const licenseContextValue = (0, react.useMemo)(() => (0, _copilotkit_shared.createLicenseContextValue)(null), []);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SandboxFunctionsContext.Provider, {
+		value: sandboxFunctionsList,
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotKitContext.Provider, {
+			value: contextValue,
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(LicenseContext.Provider, {
+				value: licenseContextValue,
+				children: [
+					runtimeA2UIEnabled && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(A2UIBuiltInToolCallRenderer, {}),
+					runtimeA2UIEnabled && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(A2UICatalogContext, {
+						catalog: a2ui?.catalog,
+						includeSchema: a2ui?.includeSchema
+					}),
+					children,
+					shouldRenderInspector ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotKitInspector, {
+						core: copilotkit,
+						defaultAnchor: inspectorDefaultAnchor
+					}) : null,
+					runtimeLicenseStatus === "none" && !resolvedPublicKey && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LicenseWarningBanner, { type: "no_license" }),
+					runtimeLicenseStatus === "expired" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LicenseWarningBanner, { type: "expired" }),
+					runtimeLicenseStatus === "invalid" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LicenseWarningBanner, { type: "invalid" }),
+					runtimeLicenseStatus === "expiring" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LicenseWarningBanner, { type: "expiring" })
+				]
+			})
+		})
+	});
+};
 
 //#endregion
 //#region src/v2/hooks/use-render-custom-messages.tsx
@@ -3690,8 +3817,7 @@ function useRenderCustomMessages() {
 		const { message, position } = params;
 		const resolvedRunId = copilotkit.getRunIdForMessage(agentId, threadId, message.id) ?? copilotkit.getRunIdsForThread(agentId, threadId).slice(-1)[0];
 		const runId = resolvedRunId ?? `missing-run-id:${message.id}`;
-		const registryAgent = copilotkit.getAgent(agentId);
-		const agent = getThreadClone(registryAgent, threadId) ?? registryAgent;
+		const agent = copilotkit.getAgent(agentId);
 		if (!agent) return null;
 		const messagesIdsInRun = resolvedRunId ? agent.messages.filter((msg) => copilotkit.getRunIdForMessage(agentId, threadId, msg.id) === resolvedRunId).map((msg) => msg.id) : [message.id];
 		const rawMessageIndex = agent.messages.findIndex((msg) => msg.id === message.id);
@@ -3701,427 +3827,160 @@ function useRenderCustomMessages() {
 		const stateSnapshot = resolvedRunId ? copilotkit.getStateByRun(agentId, threadId, resolvedRunId) : void 0;
 		let result = null;
 		for (const renderer of customMessageRenderers) {
-			if (!renderer.render) continue;
-			const Component = renderer.render;
-			result = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Component, {
-				message,
-				position,
-				runId,
-				messageIndex,
-				messageIndexInRun,
-				numberOfMessagesInRun,
-				agentId,
-				stateSnapshot
-			}, `${runId}-${message.id}-${position}`);
-			if (result) break;
-		}
-		return result;
-	};
-}
-
-//#endregion
-//#region src/v2/hooks/use-render-activity-message.tsx
-function useRenderActivityMessage() {
-	const { copilotkit } = useCopilotKit();
-	const config = useCopilotChatConfiguration();
-	const agentId = config?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
-	const renderers = copilotkit.renderActivityMessages;
-	const findRenderer = (0, react.useCallback)((activityType) => {
-		if (!renderers.length) return null;
-		const matches = renderers.filter((renderer) => renderer.activityType === activityType);
-		return matches.find((candidate) => candidate.agentId === agentId) ?? matches.find((candidate) => candidate.agentId === void 0) ?? renderers.find((candidate) => candidate.activityType === "*") ?? null;
-	}, [agentId, renderers]);
-	const renderActivityMessage = (0, react.useCallback)((message) => {
-		const renderer = findRenderer(message.activityType);
-		if (!renderer) return null;
-		const parseResult = renderer.content.safeParse(message.content);
-		if (!parseResult.success) {
-			console.warn(`Failed to parse content for activity message '${message.activityType}':`, parseResult.error);
-			return null;
-		}
-		const Component = renderer.render;
-		const registryAgent = copilotkit.getAgent(agentId);
-		const agent = getThreadClone(registryAgent, config?.threadId) ?? registryAgent;
-		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Component, {
-			activityType: message.activityType,
-			content: parseResult.data,
-			message,
-			agent
-		}, message.id);
-	}, [
-		agentId,
-		config?.threadId,
-		copilotkit,
-		findRenderer
-	]);
-	return (0, react.useMemo)(() => ({
-		renderActivityMessage,
-		findRenderer
-	}), [renderActivityMessage, findRenderer]);
-}
-
-//#endregion
-//#region src/v2/hooks/use-frontend-tool.tsx
-const EMPTY_DEPS$1 = [];
-function useFrontendTool(tool, deps) {
-	const { copilotkit } = useCopilotKit();
-	const extraDeps = deps ?? EMPTY_DEPS$1;
-	(0, react.useEffect)(() => {
-		const name = tool.name;
-		if (copilotkit.getTool({
-			toolName: name,
-			agentId: tool.agentId
-		})) {
-			console.warn(`Tool '${name}' already exists for agent '${tool.agentId || "global"}'. Overriding with latest registration.`);
-			copilotkit.removeTool(name, tool.agentId);
-		}
-		copilotkit.addTool(tool);
-		if (tool.render) copilotkit.addHookRenderToolCall({
-			name,
-			args: tool.parameters,
-			agentId: tool.agentId,
-			render: tool.render
-		});
-		return () => {
-			copilotkit.removeTool(name, tool.agentId);
-		};
-	}, [
-		tool.name,
-		tool.available,
-		copilotkit,
-		extraDeps.length,
-		...extraDeps
-	]);
-}
-
-//#endregion
-//#region src/v2/hooks/use-component.tsx
-/**
-* Registers a React component as a frontend tool renderer in chat.
-*
-* This hook is a convenience wrapper around `useFrontendTool` that:
-* - builds a model-facing tool description,
-* - forwards optional schema parameters (any Standard Schema V1 compatible library),
-* - renders your component with tool call parameters.
-*
-* Use this when you want to display a typed visual component for a tool call
-* without manually wiring a full frontend tool object.
-*
-* When `parameters` is provided, render props are inferred from the schema.
-* When omitted, the render component may accept any props.
-*
-* @typeParam TSchema - Schema describing tool parameters, or `undefined` when no schema is given.
-* @param config - Tool registration config.
-* @param deps - Optional dependencies to refresh registration (same semantics as `useEffect`).
-*
-* @example
-* ```tsx
-* // Without parameters — render accepts any props
-* useComponent({
-*   name: "showGreeting",
-*   render: ({ message }: { message: string }) => <div>{message}</div>,
-* });
-* ```
-*
-* @example
-* ```tsx
-* // With parameters — render props inferred from schema
-* useComponent({
-*   name: "showWeatherCard",
-*   parameters: z.object({ city: z.string() }),
-*   render: ({ city }) => <div>{city}</div>,
-* });
-* ```
-*
-* @example
-* ```tsx
-* useComponent(
-*   {
-*     name: "renderProfile",
-*     parameters: z.object({ userId: z.string() }),
-*     render: ProfileCard,
-*     agentId: "support-agent",
-*   },
-*   [selectedAgentId],
-* );
-* ```
-*/
-function useComponent(config, deps) {
-	const prefix = `Use this tool to display the "${config.name}" component in the chat. This tool renders a visual UI component for the user.`;
-	const fullDescription = config.description ? `${prefix}\n\n${config.description}` : prefix;
-	useFrontendTool({
-		name: config.name,
-		description: fullDescription,
-		parameters: config.parameters,
-		render: ({ args }) => {
-			const Component = config.render;
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Component, { ...args });
-		},
-		agentId: config.agentId
-	}, deps);
-}
-
-//#endregion
-//#region src/v2/hooks/use-render-tool.tsx
-const EMPTY_DEPS = [];
-/**
-* Registers a renderer entry in CopilotKit's `renderToolCalls` registry.
-*
-* Key behavior:
-* - deduplicates by `agentId:name` (latest registration wins),
-* - keeps renderer entries on cleanup so historical chat tool calls can still render,
-* - refreshes registration when `deps` change.
-*
-* @typeParam S - Schema type describing tool call parameters.
-* @param config - Renderer config for wildcard or named tools.
-* @param deps - Optional dependencies to refresh registration.
-*
-* @example
-* ```tsx
-* useRenderTool(
-*   {
-*     name: "searchDocs",
-*     parameters: z.object({ query: z.string() }),
-*     render: ({ status, parameters, result }) => {
-*       if (status === "executing") return <div>Searching {parameters.query}</div>;
-*       if (status === "complete") return <div>{result}</div>;
-*       return <div>Preparing...</div>;
-*     },
-*   },
-*   [],
-* );
-* ```
-*
-* @example
-* ```tsx
-* useRenderTool(
-*   {
-*     name: "summarize",
-*     parameters: z.object({ text: z.string() }),
-*     agentId: "research-agent",
-*     render: ({ name, status }) => <div>{name}: {status}</div>,
-*   },
-*   [selectedAgentId],
-* );
-* ```
-*/
-function useRenderTool(config, deps) {
+			if (!renderer.render) continue;
+			const Component = renderer.render;
+			result = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Component, {
+				message,
+				position,
+				runId,
+				messageIndex,
+				messageIndexInRun,
+				numberOfMessagesInRun,
+				agentId,
+				stateSnapshot
+			}, `${runId}-${message.id}-${position}`);
+			if (result) break;
+		}
+		return result;
+	};
+}
+
+//#endregion
+//#region src/v2/hooks/use-render-activity-message.tsx
+function useRenderActivityMessage() {
 	const { copilotkit } = useCopilotKit();
-	const extraDeps = deps ?? EMPTY_DEPS;
-	(0, react.useEffect)(() => {
-		const renderer = config.name === "*" && !config.parameters ? defineToolCallRenderer({
-			name: "*",
-			render: (props) => config.render({
-				...props,
-				parameters: props.args
-			}),
-			...config.agentId ? { agentId: config.agentId } : {}
-		}) : defineToolCallRenderer({
-			name: config.name,
-			args: config.parameters,
-			render: (props) => config.render({
-				...props,
-				parameters: props.args
-			}),
-			...config.agentId ? { agentId: config.agentId } : {}
-		});
-		copilotkit.addHookRenderToolCall(renderer);
+	const agentId = useCopilotChatConfiguration()?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
+	const renderers = copilotkit.renderActivityMessages;
+	const findRenderer = (0, react.useCallback)((activityType) => {
+		if (!renderers.length) return null;
+		const matches = renderers.filter((renderer) => renderer.activityType === activityType);
+		return matches.find((candidate) => candidate.agentId === agentId) ?? matches.find((candidate) => candidate.agentId === void 0) ?? renderers.find((candidate) => candidate.activityType === "*") ?? null;
+	}, [agentId, renderers]);
+	const renderActivityMessage = (0, react.useCallback)((message) => {
+		const renderer = findRenderer(message.activityType);
+		if (!renderer) return null;
+		const parseResult = renderer.content.safeParse(message.content);
+		if (!parseResult.success) {
+			console.warn(`Failed to parse content for activity message '${message.activityType}':`, parseResult.error);
+			return null;
+		}
+		const Component = renderer.render;
+		const agent = copilotkit.getAgent(agentId);
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Component, {
+			activityType: message.activityType,
+			content: parseResult.data,
+			message,
+			agent
+		}, message.id);
 	}, [
-		config.name,
+		agentId,
 		copilotkit,
-		extraDeps.length,
-		...extraDeps
+		findRenderer
 	]);
+	return (0, react.useMemo)(() => ({
+		renderActivityMessage,
+		findRenderer
+	}), [renderActivityMessage, findRenderer]);
 }
-
-//#endregion
-//#region src/v2/hooks/use-default-render-tool.tsx
-/**
-* Registers a wildcard (`"*"`) tool-call renderer via `useRenderTool`.
-*
-* - Call with no config to use CopilotKit's built-in default tool-call card.
-* - Pass `config.render` to replace the default UI with your own fallback renderer.
-*
-* This is useful when you want a generic renderer for tools that do not have a
-* dedicated `useRenderTool({ name: "..." })` registration.
-*
-* @param config - Optional custom wildcard render function.
-* @param deps - Optional dependencies to refresh registration.
-*
-* @example
-* ```tsx
-* useDefaultRenderTool();
-* ```
-*
-* @example
-* ```tsx
-* useDefaultRenderTool({
-*   render: ({ name, status }) => <div>{name}: {status}</div>,
-* });
-* ```
-*
-* @example
-* ```tsx
-* useDefaultRenderTool(
-*   {
-*     render: ({ name, result }) => (
-*       <ToolEventRow title={name} payload={result} compact={compactMode} />
-*     ),
-*   },
-*   [compactMode],
-* );
-* ```
-*/
-function useDefaultRenderTool(config, deps) {
-	useRenderTool({
-		name: "*",
-		render: config?.render ?? DefaultToolCallRenderer
-	}, deps);
-}
-function DefaultToolCallRenderer({ name, parameters, status, result }) {
-	const [isExpanded, setIsExpanded] = (0, react.useState)(false);
-	const statusString = String(status);
-	const isActive = statusString === "inProgress" || statusString === "executing";
-	const isComplete = statusString === "complete";
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-		style: {
-			marginTop: "8px",
-			paddingBottom: "8px"
-		},
-		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-			style: {
-				borderRadius: "12px",
-				border: "1px solid #e4e4e7",
-				backgroundColor: "#fafafa",
-				padding: "14px 16px"
-			},
-			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-				onClick: () => setIsExpanded(!isExpanded),
-				style: {
-					display: "flex",
-					alignItems: "center",
-					justifyContent: "space-between",
-					gap: "10px",
-					cursor: "pointer",
-					userSelect: "none"
-				},
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-					style: {
-						display: "flex",
-						alignItems: "center",
-						gap: "8px",
-						minWidth: 0
-					},
-					children: [
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
-							style: {
-								height: "14px",
-								width: "14px",
-								color: "#71717a",
-								transition: "transform 0.15s",
-								transform: isExpanded ? "rotate(90deg)" : "rotate(0deg)",
-								flexShrink: 0
-							},
-							fill: "none",
-							viewBox: "0 0 24 24",
-							strokeWidth: 2,
-							stroke: "currentColor",
-							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
-								strokeLinecap: "round",
-								strokeLinejoin: "round",
-								d: "M8.25 4.5l7.5 7.5-7.5 7.5"
-							})
-						}),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { style: {
-							display: "inline-block",
-							height: "8px",
-							width: "8px",
-							borderRadius: "50%",
-							backgroundColor: isActive ? "#f59e0b" : isComplete ? "#10b981" : "#a1a1aa",
-							flexShrink: 0
-						} }),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-							style: {
-								fontSize: "13px",
-								fontWeight: 600,
-								color: "#18181b",
-								overflow: "hidden",
-								textOverflow: "ellipsis",
-								whiteSpace: "nowrap"
-							},
-							children: name
-						})
-					]
-				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-					style: {
-						display: "inline-flex",
-						alignItems: "center",
-						borderRadius: "9999px",
-						padding: "2px 8px",
-						fontSize: "11px",
-						fontWeight: 500,
-						backgroundColor: isActive ? "#fef3c7" : isComplete ? "#d1fae5" : "#f4f4f5",
-						color: isActive ? "#92400e" : isComplete ? "#065f46" : "#3f3f46",
-						flexShrink: 0
-					},
-					children: isActive ? "Running" : isComplete ? "Done" : status
-				})]
-			}), isExpanded && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-				style: {
-					marginTop: "12px",
-					display: "grid",
-					gap: "12px"
-				},
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-					style: {
-						fontSize: "10px",
-						textTransform: "uppercase",
-						letterSpacing: "0.05em",
-						color: "#71717a"
-					},
-					children: "Arguments"
-				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
-					style: {
-						marginTop: "6px",
-						maxHeight: "200px",
-						overflow: "auto",
-						borderRadius: "6px",
-						backgroundColor: "#f4f4f5",
-						padding: "10px",
-						fontSize: "11px",
-						lineHeight: 1.6,
-						color: "#27272a",
-						whiteSpace: "pre-wrap",
-						wordBreak: "break-word"
-					},
-					children: JSON.stringify(parameters ?? {}, null, 2)
-				})] }), result !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-					style: {
-						fontSize: "10px",
-						textTransform: "uppercase",
-						letterSpacing: "0.05em",
-						color: "#71717a"
-					},
-					children: "Result"
-				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
-					style: {
-						marginTop: "6px",
-						maxHeight: "200px",
-						overflow: "auto",
-						borderRadius: "6px",
-						backgroundColor: "#f4f4f5",
-						padding: "10px",
-						fontSize: "11px",
-						lineHeight: 1.6,
-						color: "#27272a",
-						whiteSpace: "pre-wrap",
-						wordBreak: "break-word"
-					},
-					children: typeof result === "string" ? result : JSON.stringify(result, null, 2)
-				})] })]
-			})]
-		})
-	});
+
+//#endregion
+//#region src/v2/hooks/use-frontend-tool.tsx
+const EMPTY_DEPS = [];
+function useFrontendTool(tool, deps) {
+	const { copilotkit } = useCopilotKit();
+	const extraDeps = deps ?? EMPTY_DEPS;
+	(0, react.useEffect)(() => {
+		const name = tool.name;
+		if (copilotkit.getTool({
+			toolName: name,
+			agentId: tool.agentId
+		})) {
+			console.warn(`Tool '${name}' already exists for agent '${tool.agentId || "global"}'. Overriding with latest registration.`);
+			copilotkit.removeTool(name, tool.agentId);
+		}
+		copilotkit.addTool(tool);
+		if (tool.render) copilotkit.addHookRenderToolCall({
+			name,
+			args: tool.parameters,
+			agentId: tool.agentId,
+			render: tool.render
+		});
+		return () => {
+			copilotkit.removeTool(name, tool.agentId);
+		};
+	}, [
+		tool.name,
+		tool.available,
+		copilotkit,
+		JSON.stringify(extraDeps)
+	]);
+}
+
+//#endregion
+//#region src/v2/hooks/use-component.tsx
+/**
+* Registers a React component as a frontend tool renderer in chat.
+*
+* This hook is a convenience wrapper around `useFrontendTool` that:
+* - builds a model-facing tool description,
+* - forwards optional schema parameters (any Standard Schema V1 compatible library),
+* - renders your component with tool call parameters.
+*
+* Use this when you want to display a typed visual component for a tool call
+* without manually wiring a full frontend tool object.
+*
+* When `parameters` is provided, render props are inferred from the schema.
+* When omitted, the render component may accept any props.
+*
+* @typeParam TSchema - Schema describing tool parameters, or `undefined` when no schema is given.
+* @param config - Tool registration config.
+* @param deps - Optional dependencies to refresh registration (same semantics as `useEffect`).
+*
+* @example
+* ```tsx
+* // Without parameters — render accepts any props
+* useComponent({
+*   name: "showGreeting",
+*   render: ({ message }: { message: string }) => <div>{message}</div>,
+* });
+* ```
+*
+* @example
+* ```tsx
+* // With parameters — render props inferred from schema
+* useComponent({
+*   name: "showWeatherCard",
+*   parameters: z.object({ city: z.string() }),
+*   render: ({ city }) => <div>{city}</div>,
+* });
+* ```
+*
+* @example
+* ```tsx
+* useComponent(
+*   {
+*     name: "renderProfile",
+*     parameters: z.object({ userId: z.string() }),
+*     render: ProfileCard,
+*     agentId: "support-agent",
+*   },
+*   [selectedAgentId],
+* );
+* ```
+*/
+function useComponent(config, deps) {
+	const prefix = `Use this tool to display the "${config.name}" component in the chat. This tool renders a visual UI component for the user.`;
+	const fullDescription = config.description ? `${prefix}\n\n${config.description}` : prefix;
+	useFrontendTool({
+		name: config.name,
+		description: fullDescription,
+		parameters: config.parameters,
+		render: ({ args }) => {
+			const Component = config.render;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Component, { ...args });
+		},
+		agentId: config.agentId
+	}, deps);
 }
 
 //#endregion
@@ -4190,6 +4049,118 @@ function useHumanInTheLoop(tool, deps) {
 	]);
 }
 
+//#endregion
+//#region src/v2/hooks/use-agent.tsx
+let UseAgentUpdate = /* @__PURE__ */ function(UseAgentUpdate) {
+	UseAgentUpdate["OnMessagesChanged"] = "OnMessagesChanged";
+	UseAgentUpdate["OnStateChanged"] = "OnStateChanged";
+	UseAgentUpdate["OnRunStatusChanged"] = "OnRunStatusChanged";
+	return UseAgentUpdate;
+}({});
+const ALL_UPDATES = [
+	UseAgentUpdate.OnMessagesChanged,
+	UseAgentUpdate.OnStateChanged,
+	UseAgentUpdate.OnRunStatusChanged
+];
+function useAgent({ agentId, updates, throttleMs } = {}) {
+	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);
+		if (existing) {
+			provisionalAgentCache.current.delete(agentId);
+			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);
+			if (cached) {
+				cached.headers = { ...copilotkit.headers };
+				return cached;
+			}
+			const provisional = new _copilotkit_core.ProxiedCopilotRuntimeAgent({
+				runtimeUrl: copilotkit.runtimeUrl,
+				agentId,
+				transport: copilotkit.runtimeTransport,
+				runtimeMode: "pending"
+			});
+			provisional.headers = { ...copilotkit.headers };
+			provisionalAgentCache.current.set(agentId, provisional);
+			return provisional;
+		}
+		if (isRuntimeConfigured && status === _copilotkit_core.CopilotKitCoreRuntimeConnectionStatus.Error) {
+			const cached = provisionalAgentCache.current.get(agentId);
+			if (cached) {
+				cached.headers = { ...copilotkit.headers };
+				return cached;
+			}
+			const provisional = new _copilotkit_core.ProxiedCopilotRuntimeAgent({
+				runtimeUrl: copilotkit.runtimeUrl,
+				agentId,
+				transport: copilotkit.runtimeTransport,
+				runtimeMode: "pending"
+			});
+			provisional.headers = { ...copilotkit.headers };
+			provisionalAgentCache.current.set(agentId, 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.");
+	}, [
+		agentId,
+		copilotkit.agents,
+		copilotkit.runtimeConnectionStatus,
+		copilotkit.runtimeUrl,
+		copilotkit.runtimeTransport,
+		JSON.stringify(copilotkit.headers)
+	]);
+	(0, react.useEffect)(() => {
+		if (updateFlags.length === 0) return;
+		let active = true;
+		const handlers = {};
+		let batchScheduled = false;
+		const batchedForceUpdate = () => {
+			if (!active) return;
+			if (!batchScheduled) {
+				batchScheduled = true;
+				queueMicrotask(() => {
+					batchScheduled = false;
+					if (active) forceUpdate();
+				});
+			}
+		};
+		if (updateFlags.includes(UseAgentUpdate.OnMessagesChanged)) handlers.onMessagesChanged = batchedForceUpdate;
+		if (updateFlags.includes(UseAgentUpdate.OnStateChanged)) handlers.onStateChanged = batchedForceUpdate;
+		if (updateFlags.includes(UseAgentUpdate.OnRunStatusChanged)) {
+			handlers.onRunInitialized = batchedForceUpdate;
+			handlers.onRunFinalized = batchedForceUpdate;
+			handlers.onRunFailed = batchedForceUpdate;
+			handlers.onRunErrorEvent = batchedForceUpdate;
+		}
+		const subscription = copilotkit.subscribeToAgentWithOptions(agent, handlers, { throttleMs });
+		return () => {
+			active = false;
+			subscription.unsubscribe();
+		};
+	}, [
+		agent,
+		forceUpdate,
+		throttleMs,
+		providerThrottleMs,
+		updateFlags
+	]);
+	(0, react.useEffect)(() => {
+		if (agent instanceof _ag_ui_client.HttpAgent) agent.headers = { ...copilotkit.headers };
+	}, [agent, JSON.stringify(copilotkit.headers)]);
+	return { agent };
+}
+
 //#endregion
 //#region src/v2/hooks/use-capabilities.tsx
 /**
@@ -5655,6 +5626,190 @@ CopilotChatSuggestionView.displayName = "CopilotChatSuggestionView";
 */
 const ScrollElementContext = react.default.createContext(null);
 
+//#endregion
+//#region src/v2/components/intelligence-indicator/IntelligenceIndicator.tsx
+/**
+* Grace window before showing the spinner. A matching tool call must
+* remain unresolved (no `tool`-role result message in `agent.messages`)
+* for at least this long before the pill appears. This filters out
+* history-replay flashes — during `connectAgent` replay, tool calls and
+* their results arrive back-to-back in sub-millisecond bursts, so the
+* timer is cancelled before it fires. Live runs cross the threshold
+* easily because the tool actually has to execute.
+*/
+const PENDING_THRESHOLD_MS = 100;
+/** Hold the checkmark briefly before fading out. */
+const CHECK_HOLD_MS = 800;
+/**
+* Duration of the fade-out animation. Must match
+* `cpk-intelligence-pill-fade-out` keyframes in `v2/styles/globals.css`.
+*/
+const FADE_OUT_ANIMATION_MS = 480;
+/**
+* Tool-name regex patterns that trigger the indicator. Currently
+* hardcoded to the Intelligence MCP server's canonical tool name. If
+* we add per-instance customization later (e.g. a `CopilotKitProvider`
+* prop or a runtime-info field), this constant becomes the fallback.
+*/
+const DEFAULT_TOOL_PATTERNS = [/^copilotkit_knowledge_base_shell$/];
+const isMatchingToolCallName = (name) => typeof name === "string" && DEFAULT_TOOL_PATTERNS.some((p) => p.test(name));
+/**
+* "Tool-call-like" messages do NOT count as a real follow-up: tool
+* result messages, assistant messages that carry tool calls, and
+* empty-content assistant messages (which some providers emit as a
+* standalone wrapper around a batch of tool calls). A real follow-up
+* is anything else — most importantly an assistant message with prose
+* content, or a fresh user message.
+*/
+const isToolCallLikeMessage = (m) => {
+	if (m.role === "tool") return true;
+	if (m.role === "assistant") {
+		if ((Array.isArray(m.toolCalls) ? m.toolCalls : []).length > 0) return true;
+		const content = m.content;
+		return typeof content !== "string" || content.trim().length === 0;
+	}
+	return false;
+};
+/**
+* The "Using CopilotKit Intelligence" pill. Auto-mounted by
+* `CopilotChatMessageView` for every message slot when
+* `copilotkit.intelligence` is configured — callers do not register
+* this themselves. Self-gates so only the canonical message renders a
+* pill.
+*
+* Render gates (all must hold):
+*   1. `copilotkit.intelligence !== undefined`
+*   2. The message is an assistant message with at least one tool call
+*      whose name matches {@link DEFAULT_TOOL_PATTERNS}
+*   3. The message is the *latest* such matching-assistant message in
+*      `agent.messages` — tool-result messages and prose-only assistant
+*      messages don't invalidate the slot, so the pill stays
+*      continuously through a multi-step tool chain.
+*   4. The phase machine is past `idle` (the pending-grace timer fired)
+*      and not yet `hidden`.
+*
+* Phase machine (per-instance, all timers local):
+*   - Starts in `idle` — nothing rendered.
+*   - `idle → spinner` once a matching tool call has been pending
+*     (no `tool`-role result with a matching `toolCallId`) for
+*     {@link PENDING_THRESHOLD_MS}. Replay flashes (tool call + result
+*     in the same tick) never cross this threshold.
+*   - `spinner → check` as soon as EITHER `agent.isRunning` flips
+*     false OR a non-tool-call-like message appears later in
+*     `agent.messages` (i.e. the agent has produced a "real"
+*     follow-up — prose answer or a new user turn).
+*   - `check → fading` after {@link CHECK_HOLD_MS}.
+*   - `fading → hidden` after {@link FADE_OUT_ANIMATION_MS}.
+*
+* Once `hidden`, the phase is sticky — a finished pill never re-spawns
+* on the same message. New runs mount fresh indicator instances on
+* their own assistant messages.
+*
+* The "exactly one pill at a time" guarantee is structural: only one
+* message satisfies the latest-matching-assistant gate at any moment.
+*/
+function IntelligenceIndicator(props) {
+	const { message, agentId, label = "Using CopilotKit Intelligence" } = props;
+	const { copilotkit } = useCopilotKit();
+	const config = useCopilotChatConfiguration();
+	const { agent } = useAgent({
+		agentId,
+		updates: [UseAgentUpdate.OnRunStatusChanged, UseAgentUpdate.OnMessagesChanged]
+	});
+	const matchingToolCallIds = (0, react.useMemo)(() => {
+		if (message.role !== "assistant") return [];
+		const tcs = Array.isArray(message.toolCalls) ? message.toolCalls : [];
+		const ids = [];
+		for (const tc of tcs) if (isMatchingToolCallName(tc?.function?.name) && tc?.id) ids.push(tc.id);
+		return ids;
+	}, [message]);
+	const hasPending = (0, react.useMemo)(() => {
+		if (matchingToolCallIds.length === 0) return false;
+		const resolved = /* @__PURE__ */ new Set();
+		for (const m of agent.messages) if (m.role === "tool" && m.toolCallId) resolved.add(m.toolCallId);
+		return matchingToolCallIds.some((id) => !resolved.has(id));
+	}, [matchingToolCallIds, agent.messages]);
+	const sawRealFollowup = (0, react.useMemo)(() => {
+		const idx = agent.messages.findIndex((m) => m.id === message.id);
+		if (idx < 0) return false;
+		for (let i = idx + 1; i < agent.messages.length; i += 1) if (!isToolCallLikeMessage(agent.messages[i])) return true;
+		return false;
+	}, [agent.messages, message.id]);
+	const [phase, setPhase] = (0, react.useState)("idle");
+	(0, react.useEffect)(() => {
+		if (phase !== "idle") return void 0;
+		if (!hasPending) return void 0;
+		const t = setTimeout(() => setPhase("spinner"), PENDING_THRESHOLD_MS);
+		return () => clearTimeout(t);
+	}, [phase, hasPending]);
+	(0, react.useEffect)(() => {
+		if (phase !== "spinner") return void 0;
+		if (!agent.isRunning || sawRealFollowup) setPhase("check");
+	}, [
+		phase,
+		agent.isRunning,
+		sawRealFollowup
+	]);
+	(0, react.useEffect)(() => {
+		if (phase !== "check") return void 0;
+		const t = setTimeout(() => setPhase("fading"), CHECK_HOLD_MS);
+		return () => clearTimeout(t);
+	}, [phase]);
+	(0, react.useEffect)(() => {
+		if (phase !== "fading") return void 0;
+		const t = setTimeout(() => setPhase("hidden"), FADE_OUT_ANIMATION_MS);
+		return () => clearTimeout(t);
+	}, [phase]);
+	if (copilotkit.intelligence === void 0) return null;
+	if (!config) return null;
+	if (phase === "idle" || phase === "hidden") return null;
+	if (message.role !== "assistant") return null;
+	if (!(Array.isArray(message.toolCalls) ? message.toolCalls : []).some((tc) => isMatchingToolCallName(tc?.function?.name))) return null;
+	let latestMatchingAssistantId;
+	for (let i = agent.messages.length - 1; i >= 0; i -= 1) {
+		const m = agent.messages[i];
+		if (m.role !== "assistant") continue;
+		if ((Array.isArray(m.toolCalls) ? m.toolCalls : []).some((tc) => isMatchingToolCallName(tc?.function?.name))) {
+			latestMatchingAssistantId = m.id;
+			break;
+		}
+	}
+	if (latestMatchingAssistantId !== message.id) return null;
+	const showSpinner = phase === "spinner";
+	const isFading = phase === "fading";
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+		className: "cpk-intelligence-pill" + (isFading ? " cpk-intelligence-pill--fading" : ""),
+		role: "status",
+		"aria-live": "polite",
+		"aria-hidden": isFading || void 0,
+		"data-testid": `cpk-intelligence-pill-${message.id}`,
+		title: label,
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
+			className: "cpk-intelligence-pill__icon",
+			viewBox: "0 0 24 24",
+			width: "14",
+			height: "14",
+			"aria-hidden": "true",
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
+				cx: "12",
+				cy: "12",
+				r: "9",
+				fill: "none",
+				strokeWidth: "2.5",
+				strokeLinecap: "round",
+				className: "cpk-intelligence-pill__ring" + (showSpinner ? "" : " cpk-intelligence-pill__ring--done")
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
+				d: "M8 12.5l3 3 5-6",
+				fill: "none",
+				strokeWidth: "2.5",
+				strokeLinecap: "round",
+				strokeLinejoin: "round",
+				className: "cpk-intelligence-pill__check" + (showSpinner ? "" : " cpk-intelligence-pill__check--shown")
+			})]
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: label })]
+	});
+}
+
 //#endregion
 //#region src/v2/components/chat/CopilotChatMessageView.tsx
 /**
@@ -5812,14 +5967,12 @@ function CopilotChatMessageView({ messages = [], assistantMessage, userMessage,
 	const [, forceUpdate] = (0, react.useReducer)((x) => x + 1, 0);
 	(0, react.useEffect)(() => {
 		if (!config?.agentId) return;
-		const registryAgent = copilotkit.getAgent(config.agentId);
-		const agent = getThreadClone(registryAgent, config.threadId) ?? registryAgent;
+		const agent = copilotkit.getAgent(config.agentId);
 		if (!agent) return;
 		const subscription = agent.subscribe({ onStateChanged: forceUpdate });
 		return () => subscription.unsubscribe();
 	}, [
 		config?.agentId,
-		config?.threadId,
 		copilotkit,
 		forceUpdate
 	]);
@@ -5902,6 +6055,10 @@ function CopilotChatMessageView({ messages = [], assistantMessage, userMessage,
 			renderCustomMessage,
 			stateSnapshot
 		}, `${message.id}-custom-after`));
+		if (copilotkit.intelligence !== void 0 && message.role === "assistant") elements.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(IntelligenceIndicator, {
+			message,
+			agentId: config?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID
+		}, `${message.id}-intelligence`));
 		return elements.filter(Boolean);
 	};
 	const messageElements = shouldVirtualize ? [] : deduplicatedMessages.flatMap(renderMessageBlock);
@@ -6850,7 +7007,6 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 	const hasExplicitThreadId = !!threadId || !!existingConfig?.hasExplicitThreadId;
 	const { agent } = useAgent({
 		agentId: resolvedAgentId,
-		threadId: resolvedThreadId,
 		throttleMs
 	});
 	const { copilotkit } = useCopilotKit();
@@ -6892,6 +7048,7 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 		let detached = false;
 		const connectAbortController = new AbortController();
 		if (agent instanceof _ag_ui_client.HttpAgent) agent.abortController = connectAbortController;
+		agent.threadId = resolvedThreadId;
 		const connect = async (agent) => {
 			try {
 				await copilotkit.connectAgent({ agent });
@@ -7300,18 +7457,19 @@ CopilotModalHeader.CloseButton.displayName = "CopilotModalHeader.CloseButton";
 //#region src/v2/components/chat/CopilotSidebarView.tsx
 const DEFAULT_SIDEBAR_WIDTH = 480;
 const SIDEBAR_TRANSITION_MS = 260;
-function CopilotSidebarView({ header, toggleButton, width, defaultOpen = true, ...props }) {
+function CopilotSidebarView({ header, toggleButton, width, defaultOpen = true, position = "right", ...props }) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotChatConfigurationProvider, {
 		isModalDefaultOpen: defaultOpen,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotSidebarViewInternal, {
 			header,
 			toggleButton,
 			width,
+			position,
 			...props
 		})
 	});
 }
-function CopilotSidebarViewInternal({ header, toggleButton, width, ...props }) {
+function CopilotSidebarViewInternal({ header, toggleButton, width, position = "right", ...props }) {
 	const isSidebarOpen = useCopilotChatConfiguration()?.isModalOpen ?? false;
 	const sidebarRef = (0, react.useRef)(null);
 	const [sidebarWidth, setSidebarWidth] = (0, react.useState)(width ?? DEFAULT_SIDEBAR_WIDTH);
@@ -7344,26 +7502,33 @@ function CopilotSidebarViewInternal({ header, toggleButton, width, ...props }) {
 	(0, react.useLayoutEffect)(() => {
 		if (typeof window === "undefined" || typeof window.matchMedia !== "function") return;
 		if (!window.matchMedia("(min-width: 768px)").matches) return;
+		const marginStyleProp = position === "left" ? "marginInlineStart" : "marginInlineEnd";
+		const transitionCssProp = position === "left" ? "margin-inline-start" : "margin-inline-end";
 		if (isSidebarOpen) {
-			if (hasMounted.current) document.body.style.transition = `margin-inline-end ${SIDEBAR_TRANSITION_MS}ms ease`;
-			document.body.style.marginInlineEnd = widthToMargin(sidebarWidth);
+			if (hasMounted.current) document.body.style.transition = `${transitionCssProp} ${SIDEBAR_TRANSITION_MS}ms ease`;
+			document.body.style[marginStyleProp] = widthToMargin(sidebarWidth);
 		} else if (hasMounted.current) {
-			document.body.style.transition = `margin-inline-end ${SIDEBAR_TRANSITION_MS}ms ease`;
-			document.body.style.marginInlineEnd = "";
+			document.body.style.transition = `${transitionCssProp} ${SIDEBAR_TRANSITION_MS}ms ease`;
+			document.body.style[marginStyleProp] = "";
 		}
 		hasMounted.current = true;
 		return () => {
-			document.body.style.marginInlineEnd = "";
+			document.body.style[marginStyleProp] = "";
 			document.body.style.transition = "";
 		};
-	}, [isSidebarOpen, sidebarWidth]);
+	}, [
+		isSidebarOpen,
+		sidebarWidth,
+		position
+	]);
 	const headerElement = renderSlot(header, CopilotModalHeader, {});
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [renderSlot(toggleButton, CopilotChatToggleButton, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("aside", {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [renderSlot(toggleButton, CopilotChatToggleButton, position === "left" ? { className: "cpk:left-6 cpk:right-auto" } : {}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("aside", {
 		ref: sidebarRef,
 		"data-copilotkit": true,
 		"data-testid": "copilot-sidebar",
 		"data-copilot-sidebar": true,
-		className: cn("copilotKitSidebar copilotKitWindow", "cpk:fixed cpk:right-0 cpk:top-0 cpk:z-[1200] cpk:flex", "cpk:h-[100vh] cpk:h-[100dvh] cpk:max-h-screen", "cpk:w-full", "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" : "cpk:translate-x-full cpk:pointer-events-none"),
+		"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),
 			paddingTop: "env(safe-area-inset-top)",
@@ -7570,7 +7735,7 @@ var CopilotPopupView_default = CopilotPopupView;
 
 //#endregion
 //#region src/v2/components/chat/CopilotSidebar.tsx
-function CopilotSidebar({ header, toggleButton, defaultOpen, width, ...chatProps }) {
+function CopilotSidebar({ header, toggleButton, defaultOpen, width, position, ...chatProps }) {
 	const { checkFeature } = useLicenseContext();
 	const isSidebarLicensed = checkFeature("sidebar");
 	(0, react.useEffect)(() => {
@@ -7578,13 +7743,14 @@ function CopilotSidebar({ header, toggleButton, defaultOpen, width, ...chatProps
 	}, [isSidebarLicensed]);
 	const SidebarViewOverride = (0, react.useMemo)(() => {
 		const Component = (viewProps) => {
-			const { header: viewHeader, toggleButton: viewToggleButton, width: viewWidth, defaultOpen: viewDefaultOpen, ...restProps } = viewProps;
+			const { header: viewHeader, toggleButton: viewToggleButton, width: viewWidth, defaultOpen: viewDefaultOpen, position: viewPosition, ...restProps } = viewProps;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotSidebarView, {
 				...restProps,
 				header: header ?? viewHeader,
 				toggleButton: toggleButton ?? viewToggleButton,
 				width: width ?? viewWidth,
-				defaultOpen: defaultOpen ?? viewDefaultOpen
+				defaultOpen: defaultOpen ?? viewDefaultOpen,
+				position: position ?? viewPosition
 			});
 		};
 		return Object.assign(Component, CopilotChatView_default);
@@ -7592,7 +7758,8 @@ function CopilotSidebar({ header, toggleButton, defaultOpen, width, ...chatProps
 		header,
 		toggleButton,
 		width,
-		defaultOpen
+		defaultOpen,
+		position
 	]);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [!isSidebarLicensed && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(InlineFeatureWarning, { featureName: "Sidebar" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopilotChat, {
 		welcomeScreen: CopilotSidebarView.WelcomeScreen,
@@ -10024,6 +10191,12 @@ Object.defineProperty(exports, 'DefaultOpenIcon', {
     return DefaultOpenIcon;
   }
 });
+Object.defineProperty(exports, 'IntelligenceIndicator', {
+  enumerable: true,
+  get: function () {
+    return IntelligenceIndicator;
+  }
+});
 Object.defineProperty(exports, 'MCPAppsActivityContentSchema', {
   enumerable: true,
   get: function () {
@@ -10252,4 +10425,4 @@ Object.defineProperty(exports, 'useToast', {
     return useToast;
   }
 });
-//# sourceMappingURL=copilotkit-DGbvw8n2.cjs.map
+//# sourceMappingURL=copilotkit-Dnj9pi4m.cjs.map