@copilotkit/react-core 1.63.0 → 1.63.2-canary.1784918757

package/dist/v2/headless.cjs

@@ -30,13 +30,12 @@ let _copilotkit_react_core_v2_context = require("@copilotkit/react-core/v2/conte
 let react = require("react");
 react = __toESM(react);
 let _copilotkit_shared = require("@copilotkit/shared");
-let tailwind_merge = require("tailwind-merge");
 let react_jsx_runtime = require("react/jsx-runtime");
 let _ag_ui_client = require("@ag-ui/client");
 let _copilotkit_core = require("@copilotkit/core");
 let zod = require("zod");
 
-//#region src/v2/lib/slots.tsx
+//#region src/v2/lib/shallow-stable-ref.ts
 /**
 * Shallow equality comparison for objects.
 */
@@ -76,49 +75,6 @@ function useShallowStableRef(value) {
 	ref.current = value;
 	return ref.current;
 }
-/**
-* Check if a value is a React component type (function, class, forwardRef, memo, etc.)
-*/
-function isReactComponentType(value) {
-	if (typeof value === "function") return true;
-	if (value && typeof value === "object" && "$$typeof" in value && !react.default.isValidElement(value)) return true;
-	return false;
-}
-/**
-* Internal function to render a slot value as a React element (non-memoized).
-*/
-function renderSlotElement(slot, DefaultComponent, props) {
-	if (typeof slot === "string") {
-		const existingClassName = props.className;
-		return react.default.createElement(DefaultComponent, {
-			...props,
-			className: (0, tailwind_merge.twMerge)(existingClassName, slot)
-		});
-	}
-	if (isReactComponentType(slot)) return react.default.createElement(slot, props);
-	if (slot && typeof slot === "object" && !react.default.isValidElement(slot)) return react.default.createElement(DefaultComponent, {
-		...props,
-		...slot
-	});
-	return react.default.createElement(DefaultComponent, props);
-}
-/**
-* Internal memoized wrapper component for renderSlot.
-* Uses forwardRef to support ref forwarding.
-*/
-const MemoizedSlotWrapper = react.default.memo(react.default.forwardRef(function MemoizedSlotWrapper(props, ref) {
-	const { $slot, $component, ...rest } = props;
-	return renderSlotElement($slot, $component, ref !== null ? {
-		...rest,
-		ref
-	} : rest);
-}), (prev, next) => {
-	if (prev.$slot !== next.$slot) return false;
-	if (prev.$component !== next.$component) return false;
-	const { $slot: _ps, $component: _pc, ...prevRest } = prev;
-	const { $slot: _ns, $component: _nc, ...nextRest } = next;
-	return shallowEqual(prevRest, nextRest);
-});
 
 //#endregion
 //#region src/v2/providers/CopilotChatConfigurationProvider.tsx
@@ -345,11 +301,14 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 	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 { agent, isReady } = (0, react.useMemo)(() => {
 		const existing = copilotkit.getAgent(resolvedAgentId);
 		if (existing) {
 			provisionalAgentCache.current.delete(resolvedAgentId);
-			return existing;
+			return {
+				agent: existing,
+				isReady: true
+			};
 		}
 		const isRuntimeConfigured = copilotkit.runtimeUrl !== void 0;
 		const status = copilotkit.runtimeConnectionStatus;
@@ -357,7 +316,10 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 			const cached = provisionalAgentCache.current.get(resolvedAgentId);
 			if (cached) {
 				copilotkit.applyHeadersToAgent(cached);
-				return cached;
+				return {
+					agent: cached,
+					isReady: false
+				};
 			}
 			const provisional = new _copilotkit_core.ProxiedCopilotRuntimeAgent({
 				runtimeUrl: copilotkit.runtimeUrl,
@@ -367,13 +329,19 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 			});
 			copilotkit.applyHeadersToAgent(provisional);
 			provisionalAgentCache.current.set(resolvedAgentId, provisional);
-			return provisional;
+			return {
+				agent: provisional,
+				isReady: false
+			};
 		}
 		if (isRuntimeConfigured && status === _copilotkit_core.CopilotKitCoreRuntimeConnectionStatus.Error) {
 			const cached = provisionalAgentCache.current.get(resolvedAgentId);
 			if (cached) {
 				copilotkit.applyHeadersToAgent(cached);
-				return cached;
+				return {
+					agent: cached,
+					isReady: false
+				};
 			}
 			const provisional = new _copilotkit_core.ProxiedCopilotRuntimeAgent({
 				runtimeUrl: copilotkit.runtimeUrl,
@@ -383,7 +351,10 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 			});
 			copilotkit.applyHeadersToAgent(provisional);
 			provisionalAgentCache.current.set(resolvedAgentId, provisional);
-			return provisional;
+			return {
+				agent: provisional,
+				isReady: false
+			};
 		}
 		const knownAgents = Object.keys(copilotkit.agents ?? {});
 		const runtimePart = isRuntimeConfigured ? `runtimeUrl=${copilotkit.runtimeUrl}` : "no runtimeUrl";
@@ -444,7 +415,10 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 		configThreadId,
 		configHasExplicitThreadId
 	]);
-	return { agent };
+	return {
+		agent,
+		isReady
+	};
 }
 
 //#endregion
@@ -685,8 +659,9 @@ function useInterrupt(config) {
 	const pendingRef = (0, react.useRef)(pending);
 	pendingRef.current = pending;
 	const [handlerResult, setHandlerResult] = (0, react.useState)(null);
-	const responsesRef = (0, react.useRef)({});
+	const interruptStateRef = (0, react.useRef)(new _copilotkit_core.ɵInterruptState());
 	(0, react.useEffect)(() => {
+		const interruptState = interruptStateRef.current;
 		let localLegacy = null;
 		let localStandard = null;
 		const subscription = agent.subscribe({
@@ -702,106 +677,111 @@ function useInterrupt(config) {
 			onRunStartedEvent: () => {
 				localLegacy = null;
 				localStandard = null;
-				responsesRef.current = {};
+				interruptState.clear();
 				setPending(null);
 			},
 			onRunFinalized: () => {
-				if (localStandard && localStandard.length > 0) setPending({
-					kind: "standard",
-					interrupts: localStandard
-				});
-				else if (localLegacy) setPending({
-					kind: "legacy",
-					event: localLegacy
-				});
+				if (localStandard && localStandard.length > 0) {
+					interruptState.setStandard(localStandard);
+					setPending(interruptState.pending);
+				} else if (localLegacy) {
+					interruptState.setLegacy(localLegacy);
+					setPending(interruptState.pending);
+				}
 				localLegacy = null;
 				localStandard = null;
 			},
 			onRunFailed: () => {
 				localLegacy = null;
 				localStandard = null;
-				responsesRef.current = {};
+				interruptState.clear();
 				setPending(null);
 			}
 		});
-		return () => subscription.unsubscribe();
+		return () => {
+			subscription.unsubscribe();
+			interruptState.clear();
+		};
 	}, [agent]);
-	const submitStandardIfComplete = (0, react.useCallback)(async (interrupts) => {
-		if (!interrupts.every((i) => responsesRef.current[i.id])) return;
-		const expired = interrupts.find((i) => (0, _ag_ui_client.isInterruptExpired)(i));
-		if (expired) {
-			console.error(`[CopilotKit] useInterrupt: interrupt ${expired.id} expired at ${expired.expiresAt}; not resuming.`);
-			responsesRef.current = {};
-			setPending(null);
-			return;
-		}
-		const resume = (0, _ag_ui_client.buildResumeArray)(interrupts, responsesRef.current);
-		for (const i of interrupts) {
-			if (!i.toolCallId) continue;
-			const response = responsesRef.current[i.id];
-			const content = response.status === "cancelled" ? { status: "cancelled" } : response.payload ?? { status: "resolved" };
-			agent.addMessage({
-				id: (0, _ag_ui_client.randomUUID)(),
-				role: "tool",
-				toolCallId: i.toolCallId,
-				content: JSON.stringify(content)
-			});
-		}
-		responsesRef.current = {};
-		try {
+	const resolve = (0, react.useCallback)(async (payload, interruptId) => {
+		const current = pendingRef.current;
+		if (!current) return;
+		if (current.kind === "standard" && current.interrupts.length > 1 && interruptId === void 0) console.warn(`[CopilotKit] useInterrupt: resolve()/cancel() called without an interruptId while ${current.interrupts.length} interrupts are open; defaulting to the first. Pass an interruptId to address a specific interrupt.`);
+		const decision = interruptStateRef.current.resolve(payload, interruptId);
+		if (decision.kind === "legacy-resume") try {
 			return await copilotkit.runAgent({
 				agent,
-				resume
+				forwardedProps: { command: {
+					resume: decision.payload,
+					interruptEvent: decision.interruptValue
+				} }
 			});
 		} catch (err) {
 			console.error("[CopilotKit] useInterrupt resolve: runAgent rejected; clearing pending + rethrowing", err);
 			setPending(null);
 			throw err;
 		}
-	}, [agent, copilotkit]);
-	const resolve = (0, react.useCallback)(async (payload, interruptId) => {
-		const current = pendingRef.current;
-		if (!current) return;
-		if (current.kind === "legacy") try {
+		if (decision.kind === "expired") {
+			console.error(`[CopilotKit] useInterrupt: interrupt ${decision.interrupt.id} expired at ${decision.interrupt.expiresAt}; not resuming.`);
+			interruptStateRef.current.clear();
+			setPending(null);
+			return;
+		}
+		if (decision.kind !== "resume") return;
+		for (const toolResult of decision.toolResults) agent.addMessage({
+			id: (0, _ag_ui_client.randomUUID)(),
+			role: "tool",
+			toolCallId: toolResult.toolCallId,
+			content: toolResult.content
+		});
+		try {
 			return await copilotkit.runAgent({
 				agent,
-				forwardedProps: { command: {
-					resume: payload,
-					interruptEvent: current.event.value
-				} }
+				resume: decision.resume
 			});
 		} catch (err) {
 			console.error("[CopilotKit] useInterrupt resolve: runAgent rejected; clearing pending + rethrowing", err);
+			interruptStateRef.current.clear();
 			setPending(null);
 			throw err;
 		}
-		if (current.interrupts.length > 1 && interruptId === void 0) console.warn(`[CopilotKit] useInterrupt: resolve()/cancel() called without an interruptId while ${current.interrupts.length} interrupts are open; defaulting to the first. Pass an interruptId to address a specific interrupt.`);
-		const id = interruptId ?? current.interrupts[0]?.id;
-		if (!id) return;
-		responsesRef.current[id] = {
-			status: "resolved",
-			payload
-		};
-		return submitStandardIfComplete(current.interrupts);
-	}, [
-		agent,
-		copilotkit,
-		submitStandardIfComplete
-	]);
+	}, [agent, copilotkit]);
 	const cancel = (0, react.useCallback)(async (interruptId) => {
 		const current = pendingRef.current;
 		if (!current) return;
-		if (current.kind === "legacy") {
+		if (current.kind === "standard" && current.interrupts.length > 1 && interruptId === void 0) console.warn(`[CopilotKit] useInterrupt: resolve()/cancel() called without an interruptId while ${current.interrupts.length} interrupts are open; defaulting to the first. Pass an interruptId to address a specific interrupt.`);
+		const decision = interruptStateRef.current.cancel(interruptId);
+		if (decision.kind === "dismiss") {
 			console.warn("[CopilotKit] useInterrupt: cancel() is not supported for legacy on_interrupt interrupts; dismissing.");
+			interruptStateRef.current.clear();
 			setPending(null);
 			return;
 		}
-		if (current.interrupts.length > 1 && interruptId === void 0) console.warn(`[CopilotKit] useInterrupt: resolve()/cancel() called without an interruptId while ${current.interrupts.length} interrupts are open; defaulting to the first. Pass an interruptId to address a specific interrupt.`);
-		const id = interruptId ?? current.interrupts[0]?.id;
-		if (!id) return;
-		responsesRef.current[id] = { status: "cancelled" };
-		return submitStandardIfComplete(current.interrupts);
-	}, [submitStandardIfComplete]);
+		if (decision.kind === "expired") {
+			console.error(`[CopilotKit] useInterrupt: interrupt ${decision.interrupt.id} expired at ${decision.interrupt.expiresAt}; not resuming.`);
+			interruptStateRef.current.clear();
+			setPending(null);
+			return;
+		}
+		if (decision.kind !== "resume") return;
+		for (const toolResult of decision.toolResults) agent.addMessage({
+			id: (0, _ag_ui_client.randomUUID)(),
+			role: "tool",
+			toolCallId: toolResult.toolCallId,
+			content: toolResult.content
+		});
+		try {
+			return await copilotkit.runAgent({
+				agent,
+				resume: decision.resume
+			});
+		} catch (err) {
+			console.error("[CopilotKit] useInterrupt resolve: runAgent rejected; clearing pending + rethrowing", err);
+			interruptStateRef.current.clear();
+			setPending(null);
+			throw err;
+		}
+	}, [agent, copilotkit]);
 	const renderRef = (0, react.useRef)(config.render);
 	renderRef.current = config.render;
 	const enabledRef = (0, react.useRef)(config.enabled);
@@ -843,7 +823,7 @@ function useInterrupt(config) {
 			maybePromise = handler({
 				event: legacyEvent,
 				interrupt: pending.kind === "standard" ? pending.interrupts[0] : null,
-				interrupts: pending.kind === "standard" ? pending.interrupts : [],
+				interrupts: pending.kind === "standard" ? [...pending.interrupts] : [],
 				resolve: resolveRef.current,
 				cancel: cancelRef.current
 			});
@@ -872,7 +852,7 @@ function useInterrupt(config) {
 		return renderRef.current({
 			event: legacyEvent,
 			interrupt: pending.kind === "standard" ? pending.interrupts[0] : null,
-			interrupts: pending.kind === "standard" ? pending.interrupts : [],
+			interrupts: pending.kind === "standard" ? [...pending.interrupts] : [],
 			result: handlerResult,
 			resolve,
 			cancel
@@ -1418,6 +1398,76 @@ function useRenderTool(config, deps) {
 	]);
 }
 
+//#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 } = (0, _copilotkit_react_core_v2_context.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-capabilities.tsx
 /**
@@ -1447,6 +1497,7 @@ Object.defineProperty(exports, 'CopilotKitCoreReact', {
     return _copilotkit_react_core_v2_context.CopilotKitCoreReact;
   }
 });
+exports.UseAgentUpdate = UseAgentUpdate;
 exports.defineToolCallRenderer = defineToolCallRenderer;
 exports.useAgent = useAgent;
 exports.useAgentContext = useAgentContext;
@@ -1454,10 +1505,17 @@ exports.useCapabilities = useCapabilities;
 exports.useComponent = useComponent;
 exports.useConfigureSuggestions = useConfigureSuggestions;
 exports.useCopilotChatConfiguration = useCopilotChatConfiguration;
+Object.defineProperty(exports, 'useCopilotKit', {
+  enumerable: true,
+  get: function () {
+    return _copilotkit_react_core_v2_context.useCopilotKit;
+  }
+});
 exports.useFrontendTool = useFrontendTool;
 exports.useHumanInTheLoop = useHumanInTheLoop;
 exports.useInterrupt = useInterrupt;
 exports.useRenderTool = useRenderTool;
+exports.useRenderToolCall = useRenderToolCall;
 exports.useSuggestions = useSuggestions;
 exports.useThreads = useThreads;
 //# sourceMappingURL=headless.cjs.map