@copilotkit/react-core 1.63.1 → 1.63.2

package/dist/v2/headless.cjs

@@ -345,11 +345,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 +360,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 +373,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 +395,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 +459,10 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 		configThreadId,
 		configHasExplicitThreadId
 	]);
-	return { agent };
+	return {
+		agent,
+		isReady
+	};
 }
 
 //#endregion
@@ -685,8 +703,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 +721,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 +867,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 +896,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