@copilotkit/react-core 1.57.0-canary.1778146769 → 1.57.0-canary.1778229181

package/dist/{copilotkit-B_k0HSNz.cjs → copilotkit-BLlkMAjx.cjs}

@@ -1324,6 +1324,197 @@ function useKatexStyles() {
 	}, []);
 }
 
+//#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));
+	}
+};
+
+//#endregion
+//#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)(() => {
+		const subscription = context.copilotkit.subscribe({ onRuntimeConnectionStatusChanged: () => {
+			forceUpdate();
+		} });
+		return () => {
+			subscription.unsubscribe();
+		};
+	}, []);
+	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/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/components/CopilotKitInspector.tsx
 const CopilotKitInspector = ({ core, ...rest }) => {
@@ -1668,6 +1859,7 @@ const MCPAppsActivityRenderer = function MCPAppsActivityRenderer({ content, agen
 		promise: null,
 		resourceUri: null
 	});
+	const { resourceUri, serverHash, serverId } = content;
 	const sendToIframe = (0, react.useCallback)((msg) => {
 		if (iframeRef.current?.contentWindow) {
 			console.log("[MCPAppsRenderer] Sending to iframe:", msg);
@@ -1699,7 +1891,6 @@ const MCPAppsActivityRenderer = function MCPAppsActivityRenderer({ content, agen
 		});
 	}, [sendToIframe]);
 	(0, react.useEffect)(() => {
-		const { resourceUri, serverHash, serverId } = content;
 		if (fetchStateRef.current.inProgress && fetchStateRef.current.resourceUri === resourceUri) {
 			fetchStateRef.current.promise?.then((resource) => {
 				if (resource) {
@@ -1746,7 +1937,12 @@ const MCPAppsActivityRenderer = function MCPAppsActivityRenderer({ content, agen
 			setError(err instanceof Error ? err : new Error(String(err)));
 			setIsLoading(false);
 		});
-	}, [agent, content]);
+	}, [
+		agent,
+		resourceUri,
+		serverHash,
+		serverId
+	]);
 	(0, react.useEffect)(() => {
 		if (isLoading || !fetchedResource) return;
 		const container = containerRef.current;
@@ -2967,102 +3163,6 @@ function A2UICatalogContext({ catalog, includeSchema }) {
 	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));
-	}
-};
-
 //#endregion
 //#region src/v2/providers/CopilotKitProvider.tsx
 const HEADER_NAME = "X-CopilotCloud-Public-Api-Key";
@@ -3078,12 +3178,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 +3399,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();
@@ -3426,89 +3516,167 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = {}, c
 		})
 	});
 };
-const useCopilotKit = () => {
-	const context = (0, react.useContext)(CopilotKitContext);
+
+//#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);
-	if (!context) throw new Error("useCopilotKit must be used within CopilotKitProvider");
+	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)(() => {
-		const subscription = context.copilotkit.subscribe({ onRuntimeConnectionStatusChanged: () => {
-			forceUpdate();
-		} });
+		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();
 		};
-	}, []);
-	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
+		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
@@ -3528,7 +3696,8 @@ 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 agent = copilotkit.getAgent(agentId);
+		const registryAgent = copilotkit.getAgent(agentId);
+		const agent = getThreadClone(registryAgent, threadId) ?? registryAgent;
 		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);
@@ -3560,7 +3729,8 @@ function useRenderCustomMessages() {
 //#region src/v2/hooks/use-render-activity-message.tsx
 function useRenderActivityMessage() {
 	const { copilotkit } = useCopilotKit();
-	const agentId = useCopilotChatConfiguration()?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
+	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;
@@ -3576,7 +3746,8 @@ function useRenderActivityMessage() {
 			return null;
 		}
 		const Component = renderer.render;
-		const agent = copilotkit.getAgent(agentId);
+		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,
@@ -3585,6 +3756,7 @@ function useRenderActivityMessage() {
 		}, message.id);
 	}, [
 		agentId,
+		config?.threadId,
 		copilotkit,
 		findRenderer
 	]);
@@ -3623,8 +3795,7 @@ function useFrontendTool(tool, deps) {
 		tool.name,
 		tool.available,
 		copilotkit,
-		extraDeps.length,
-		...extraDeps
+		JSON.stringify(extraDeps)
 	]);
 }
 
@@ -3763,8 +3934,7 @@ function useRenderTool(config, deps) {
 	}, [
 		config.name,
 		copilotkit,
-		extraDeps.length,
-		...extraDeps
+		JSON.stringify(extraDeps)
 	]);
 }
 
@@ -4024,118 +4194,6 @@ 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 = 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 });
-		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
 /**
@@ -5601,190 +5659,6 @@ 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
 /**
@@ -5942,12 +5816,14 @@ function CopilotChatMessageView({ messages = [], assistantMessage, userMessage,
 	const [, forceUpdate] = (0, react.useReducer)((x) => x + 1, 0);
 	(0, react.useEffect)(() => {
 		if (!config?.agentId) return;
-		const agent = copilotkit.getAgent(config.agentId);
+		const registryAgent = copilotkit.getAgent(config.agentId);
+		const agent = getThreadClone(registryAgent, config.threadId) ?? registryAgent;
 		if (!agent) return;
 		const subscription = agent.subscribe({ onStateChanged: forceUpdate });
 		return () => subscription.unsubscribe();
 	}, [
 		config?.agentId,
+		config?.threadId,
 		copilotkit,
 		forceUpdate
 	]);
@@ -6030,10 +5906,6 @@ 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);
@@ -6982,6 +6854,7 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 	const hasExplicitThreadId = !!threadId || !!existingConfig?.hasExplicitThreadId;
 	const { agent } = useAgent({
 		agentId: resolvedAgentId,
+		threadId: resolvedThreadId,
 		throttleMs
 	});
 	const { copilotkit } = useCopilotKit();
@@ -7023,7 +6896,6 @@ 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 });
@@ -10156,12 +10028,6 @@ Object.defineProperty(exports, 'DefaultOpenIcon', {
     return DefaultOpenIcon;
   }
 });
-Object.defineProperty(exports, 'IntelligenceIndicator', {
-  enumerable: true,
-  get: function () {
-    return IntelligenceIndicator;
-  }
-});
 Object.defineProperty(exports, 'MCPAppsActivityContentSchema', {
   enumerable: true,
   get: function () {
@@ -10390,4 +10256,4 @@ Object.defineProperty(exports, 'useToast', {
     return useToast;
   }
 });
-//# sourceMappingURL=copilotkit-B_k0HSNz.cjs.map
+//# sourceMappingURL=copilotkit-BLlkMAjx.cjs.map