@copilotkit/react-core 1.61.0 → 1.61.2

package/dist/{copilotkit-BCxdKlMw.mjs → copilotkit-Be-o2UaU.mjs}

@@ -1,10 +1,10 @@
 import * as React$1 from "react";
 import React, { createContext, forwardRef, memo, useCallback, useContext, useEffect, useId, useImperativeHandle, useLayoutEffect, useMemo, useReducer, useRef, useState, useSyncExternalStore } from "react";
 import { CopilotKitCore, CopilotKitCoreRuntimeConnectionStatus, ProxiedCopilotRuntimeAgent, ToolCallStatus, isRunCompletionAware, ɵcreateThreadStore, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading } from "@copilotkit/core";
-import { HttpAgent } from "@ag-ui/client";
+import { HttpAgent, buildResumeArray, isInterruptExpired, randomUUID } from "@ag-ui/client";
 import { extendTailwindMerge, twMerge } from "tailwind-merge";
 import { ArrowUp, Check, ChevronDown, ChevronLeft, ChevronRight, ChevronRightIcon, Copy, Edit, Loader2, MessageCircle, Mic, Play, Plus, RefreshCw, Square, ThumbsDown, ThumbsUp, Upload, Volume2, X } from "lucide-react";
-import { A2UI_DEFAULT_DESIGN_GUIDELINES, A2UI_DEFAULT_GENERATION_GUIDELINES, COPILOT_CLOUD_API_URL, COPILOT_CLOUD_CHAT_URL, COPILOT_CLOUD_PUBLIC_API_KEY_HEADER, ConfigurationError, CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitRemoteEndpointDiscoveryError, DEFAULT_AGENT_ID, ErrorVisibility, MissingPublicApiKeyError, Severity, TranscriptionErrorCode, TranscriptionErrorCode as TranscriptionErrorCode$1, copyToClipboard, createLicenseContextValue, dataToUUID, exceedsMaxSize, formatFileSize, generateVideoThumbnail, getDocumentIcon, getModalityFromMimeType, getSourceUrl, matchesAcceptFilter, parseJson, partialJSONParse, randomId, randomUUID, readFileAsBase64, schemaToJsonSchema } from "@copilotkit/shared";
+import { A2UI_DEFAULT_DESIGN_GUIDELINES, A2UI_DEFAULT_GENERATION_GUIDELINES, COPILOT_CLOUD_API_URL, COPILOT_CLOUD_CHAT_URL, COPILOT_CLOUD_PUBLIC_API_KEY_HEADER, ConfigurationError, CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitRemoteEndpointDiscoveryError, DEFAULT_AGENT_ID, ErrorVisibility, MissingPublicApiKeyError, Severity, TranscriptionErrorCode, TranscriptionErrorCode as TranscriptionErrorCode$1, copyToClipboard, createLicenseContextValue, dataToUUID, exceedsMaxSize, formatFileSize, generateVideoThumbnail, getDocumentIcon, getModalityFromMimeType, getSourceUrl, matchesAcceptFilter, parseJson, partialJSONParse, randomId, randomUUID as randomUUID$1, readFileAsBase64, schemaToJsonSchema } from "@copilotkit/shared";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { Slot } from "@radix-ui/react-slot";
 import { cva } from "class-variance-authority";
@@ -157,7 +157,7 @@ const CopilotChatConfigurationProvider = ({ children, labels, agentId, threadId,
 	const resolvedThreadId = useMemo(() => {
 		if (threadId) return threadId;
 		if (parentConfig?.threadId) return parentConfig.threadId;
-		return randomUUID();
+		return randomUUID$1();
 	}, [threadId, parentConfig?.threadId]);
 	const resolvedHasExplicitThreadId = (hasExplicitThreadId !== void 0 ? hasExplicitThreadId : !!threadId) || !!parentConfig?.hasExplicitThreadId;
 	const [internalModalOpen, setInternalModalOpen] = useState(isModalDefaultOpen ?? true);
@@ -1490,10 +1490,20 @@ function useRenderTool(config, deps) {
 		}) : defineToolCallRenderer({
 			name: config.name,
 			args: config.parameters,
-			render: (props) => config.render({
-				...props,
-				parameters: props.args
-			}),
+			render: (props) => {
+				if (props.status === ToolCallStatus.InProgress) return config.render({
+					...props,
+					parameters: props.args
+				});
+				if (props.status === ToolCallStatus.Executing) return config.render({
+					...props,
+					parameters: props.args
+				});
+				return config.render({
+					...props,
+					parameters: props.args
+				});
+			},
 			...config.agentId ? { agentId: config.agentId } : {}
 		});
 		copilotkit.addHookRenderToolCall(renderer);
@@ -3531,6 +3541,10 @@ function A2UICatalogContext({ catalog, includeSchema }) {
 
 //#endregion
 //#region src/v2/providers/CopilotKitProvider.tsx
+const zodToJsonSchemaAdapter = (schema, options) => {
+	const refStrategy = options?.$refStrategy;
+	return zodToJsonSchema(schema, refStrategy === "root" || refStrategy === "relative" || refStrategy === "none" || refStrategy === "seen" ? { $refStrategy: refStrategy } : {});
+};
 const HEADER_NAME = "X-CopilotCloud-Public-Api-Key";
 const COPILOT_CLOUD_CHAT_URL$1 = "https://api.cloud.copilotkit.ai/copilotkit/v1";
 const EMPTY_HEADERS = Object.freeze({});
@@ -3561,6 +3575,8 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 	const [runtimeA2UIEnabled, setRuntimeA2UIEnabled] = useState(false);
 	const [runtimeOpenGenUIEnabled, setRuntimeOpenGenUIEnabled] = useState(false);
 	const openGenUIActive = runtimeOpenGenUIEnabled || !!openGenerativeUI;
+	const a2uiCatalogProvided = !!a2ui?.catalog;
+	const a2uiActive = runtimeA2UIEnabled || a2uiCatalogProvided;
 	const [runtimeLicenseStatus, setRuntimeLicenseStatus] = useState(void 0);
 	useEffect(() => {
 		if (typeof window === "undefined") return;
@@ -3591,7 +3607,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 			content: OpenGenerativeUIContentSchema,
 			render: OpenGenerativeUIActivityRenderer
 		});
-		if (runtimeA2UIEnabled) renderers.unshift(createA2UIMessageRenderer({
+		if (a2uiActive) renderers.unshift(createA2UIMessageRenderer({
 			theme: a2ui?.theme ?? viewerTheme,
 			catalog: a2ui?.catalog,
 			loadingComponent: a2ui?.loadingComponent,
@@ -3599,7 +3615,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 		}));
 		return renderers;
 	}, [
-		runtimeA2UIEnabled,
+		a2uiActive,
 		openGenUIActive,
 		a2ui
 	]);
@@ -3786,7 +3802,10 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 		copilotkit.setRuntimeTransport(useSingleEndpoint === true ? "single" : useSingleEndpoint === false ? "rest" : "auto");
 		copilotkit.setHeaders(mergedHeaders);
 		copilotkit.setCredentials(credentials);
-		copilotkit.setProperties(properties);
+		copilotkit.setProperties(a2uiCatalogProvided ? {
+			...properties,
+			a2uiCatalogAvailable: true
+		} : properties);
 		copilotkit.setAgents__unsafe_dev_only(mergedAgents);
 		copilotkit.setDebug(debug);
 	}, [
@@ -3795,6 +3814,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 		mergedHeaders,
 		credentials,
 		properties,
+		a2uiCatalogProvided,
 		mergedAgents,
 		useSingleEndpoint,
 		debug
@@ -3842,7 +3862,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 		return JSON.stringify(sandboxFunctionsList.map((fn) => ({
 			name: fn.name,
 			description: fn.description,
-			parameters: schemaToJsonSchema(fn.parameters, { zodToJsonSchema })
+			parameters: schemaToJsonSchema(fn.parameters, { zodToJsonSchema: zodToJsonSchemaAdapter })
 		})));
 	}, [sandboxFunctionsList]);
 	useLayoutEffect(() => {
@@ -3863,7 +3883,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 		copilotkit,
 		executingToolCallIds
 	}), [copilotkit, executingToolCallIds]);
-	const licenseContextValue = useMemo(() => createLicenseContextValue(null), []);
+	const licenseContextValue = useMemo(() => createLicenseContextValue(runtimeLicenseStatus), [runtimeLicenseStatus]);
 	return /* @__PURE__ */ jsx(SandboxFunctionsContext.Provider, {
 		value: sandboxFunctionsList,
 		children: /* @__PURE__ */ jsx(CopilotKitContext.Provider, {
@@ -3871,8 +3891,8 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 			children: /* @__PURE__ */ jsxs(LicenseContext.Provider, {
 				value: licenseContextValue,
 				children: [
-					runtimeA2UIEnabled && /* @__PURE__ */ jsx(A2UIBuiltInToolCallRenderer, {}),
-					runtimeA2UIEnabled && /* @__PURE__ */ jsx(A2UICatalogContext, {
+					a2uiActive && /* @__PURE__ */ jsx(A2UIBuiltInToolCallRenderer, {}),
+					a2uiActive && /* @__PURE__ */ jsx(A2UICatalogContext, {
 						catalog: a2ui?.catalog,
 						includeSchema: a2ui?.includeSchema
 					}),
@@ -3950,16 +3970,20 @@ function useRenderActivityMessage() {
 	const renderActivityMessage = 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);
+		const parseResult = renderer.content["~standard"].validate(message.content);
+		if (parseResult instanceof Promise) {
+			console.warn(`Async content validation is not supported for activity message '${message.activityType}'`);
+			return null;
+		}
+		if (parseResult.issues) {
+			console.warn(`Failed to parse content for activity message '${message.activityType}':`, parseResult.issues);
 			return null;
 		}
 		const Component = renderer.render;
 		const agent = copilotkit.getAgent(agentId);
 		return /* @__PURE__ */ jsx(Component, {
 			activityType: message.activityType,
-			content: parseResult.data,
+			content: parseResult.value,
 			message,
 			agent
 		}, message.id);
@@ -4080,15 +4104,34 @@ function useComponent(config, deps) {
 function useHumanInTheLoop(tool, deps) {
 	const { copilotkit } = useCopilotKit();
 	const resolvePromiseRef = useRef(null);
+	const cleanupAbortRef = useRef(null);
 	const respond = useCallback(async (result) => {
 		if (resolvePromiseRef.current) {
+			cleanupAbortRef.current?.();
+			cleanupAbortRef.current = null;
 			resolvePromiseRef.current(result);
 			resolvePromiseRef.current = null;
 		}
 	}, []);
-	const handler = useCallback(async () => {
-		return new Promise((resolve) => {
+	const handler = useCallback(async (_args, context) => {
+		const signal = context?.signal;
+		return new Promise((resolve, reject) => {
+			if (signal?.aborted) {
+				reject(/* @__PURE__ */ new Error("Human-in-the-loop interaction aborted"));
+				return;
+			}
 			resolvePromiseRef.current = resolve;
+			if (signal) {
+				const onAbort = () => {
+					cleanupAbortRef.current = null;
+					resolvePromiseRef.current = null;
+					reject(/* @__PURE__ */ new Error("Human-in-the-loop interaction aborted"));
+				};
+				signal.addEventListener("abort", onAbort, { once: true });
+				cleanupAbortRef.current = () => {
+					signal.removeEventListener("abort", onAbort);
+				};
+			}
 		});
 	}, []);
 	const RenderComponent = useCallback((props) => {
@@ -4176,7 +4219,7 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 		if (isRuntimeConfigured && (status === CopilotKitCoreRuntimeConnectionStatus.Disconnected || status === CopilotKitCoreRuntimeConnectionStatus.Connecting)) {
 			const cached = provisionalAgentCache.current.get(agentId);
 			if (cached) {
-				cached.headers = { ...copilotkit.headers };
+				copilotkit.applyHeadersToAgent(cached);
 				return cached;
 			}
 			const provisional = new ProxiedCopilotRuntimeAgent({
@@ -4185,14 +4228,14 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 				transport: copilotkit.runtimeTransport,
 				runtimeMode: "pending"
 			});
-			provisional.headers = { ...copilotkit.headers };
+			copilotkit.applyHeadersToAgent(provisional);
 			provisionalAgentCache.current.set(agentId, provisional);
 			return provisional;
 		}
 		if (isRuntimeConfigured && status === CopilotKitCoreRuntimeConnectionStatus.Error) {
 			const cached = provisionalAgentCache.current.get(agentId);
 			if (cached) {
-				cached.headers = { ...copilotkit.headers };
+				copilotkit.applyHeadersToAgent(cached);
 				return cached;
 			}
 			const provisional = new ProxiedCopilotRuntimeAgent({
@@ -4201,7 +4244,7 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 				transport: copilotkit.runtimeTransport,
 				runtimeMode: "pending"
 			});
-			provisional.headers = { ...copilotkit.headers };
+			copilotkit.applyHeadersToAgent(provisional);
 			provisionalAgentCache.current.set(agentId, provisional);
 			return provisional;
 		}
@@ -4252,7 +4295,7 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 		updateFlags
 	]);
 	useEffect(() => {
-		if (agent instanceof HttpAgent) agent.headers = { ...copilotkit.headers };
+		if (agent instanceof HttpAgent) copilotkit.applyHeadersToAgent(agent);
 	}, [agent, JSON.stringify(copilotkit.headers)]);
 	const chatConfig = useCopilotChatConfiguration();
 	const configThreadId = chatConfig?.threadId;
@@ -4529,114 +4572,165 @@ const INTERRUPT_EVENT_NAME = "on_interrupt";
 function isPromiseLike(value) {
 	return (typeof value === "object" || typeof value === "function") && value !== null && typeof Reflect.get(value, "then") === "function";
 }
+/** Derive the legacy-compatible `event` for any pending interrupt. */
+function toLegacyEvent(pending) {
+	if (pending.kind === "legacy") return pending.event;
+	return {
+		name: INTERRUPT_EVENT_NAME,
+		value: pending.interrupts[0]
+	};
+}
 /**
-* Handles agent interrupts (`on_interrupt`) with optional filtering, preprocessing, and resume behavior.
-*
-* The hook listens to custom events on the active agent, stores interrupt payloads per run,
-* and surfaces a render callback once the run finalizes. Call `resolve` from your UI to resume
-* execution with user-provided data.
+* Handles agent interrupts with optional filtering, preprocessing, and resume behavior.
 *
-* - `renderInChat: true` (default): the element is published into `<CopilotChat>` and this hook returns `void`.
-* - `renderInChat: false`: the hook returns the interrupt element so you can place it anywhere in your component tree.
+* Supports both the AG-UI standard interrupt flow (`RUN_FINISHED` with
+* `outcome.type === "interrupt"`) and the legacy custom-event flow
+* (`on_interrupt`). For standard interrupts, `render` receives `interrupt`
+* (the primary one) and `interrupts` (the full open set); call `resolve(payload)`
+* to resume or `cancel()` to cancel. Resuming addresses the targeted interrupt
+* and, once every open interrupt is addressed, submits a single spec `resume`
+* array via `copilotkit.runAgent`.
 *
-* `event.value` is typed as `any` since the interrupt payload shape depends on your agent.
-* Type-narrow it in your callbacks (e.g. `handler`, `enabled`, `render`) as needed.
-*
-* @typeParam TResult - Inferred from `handler` return type. Exposed as `result` in `render`.
-* @param config - Interrupt configuration (renderer, optional handler/filter, and render mode).
-* @returns When `renderInChat` is `false`, returns the interrupt element (or `null` when idle).
-* Otherwise returns `void` and publishes the element into chat. In `render`, `result` is always
-* either the handler's resolved return value or `null` (including when no handler is provided,
-* when filtering skips the interrupt, or when handler execution fails).
+* - `renderInChat: true` (default): the element is published into `<CopilotChat>`; returns `void`.
+* - `renderInChat: false`: the hook returns the interrupt element for manual placement.
 *
 * @example
 * ```tsx
-* import { useInterrupt } from "@copilotkit/react-core/v2";
-*
-* function InterruptUI() {
-*   useInterrupt({
-*     render: ({ event, resolve }) => (
-*       <div>
-*         <p>{event.value.question}</p>
-*         <button onClick={() => resolve({ approved: true })}>Approve</button>
-*         <button onClick={() => resolve({ approved: false })}>Reject</button>
-*       </div>
-*     ),
-*   });
-*
-*   return null;
-* }
-* ```
-*
-* @example
-* ```tsx
-* import { useInterrupt } from "@copilotkit/react-core/v2";
-*
-* function CustomPanel() {
-*   const interruptElement = useInterrupt({
-*     renderInChat: false,
-*     enabled: (event) => event.value.startsWith("approval:"),
-*     handler: async ({ event }) => ({ label: event.value.toUpperCase() }),
-*     render: ({ event, result, resolve }) => (
-*       <aside>
-*         <strong>{result?.label ?? ""}</strong>
-*         <button onClick={() => resolve({ value: event.value })}>Continue</button>
-*       </aside>
-*     ),
-*   });
-*
-*   return <>{interruptElement}</>;
-* }
+* useInterrupt({
+*   render: ({ interrupt, resolve, cancel }) => (
+*     <div>
+*       <p>{interrupt?.message}</p>
+*       <button onClick={() => resolve({ approved: true })}>Approve</button>
+*       <button onClick={() => cancel()}>Cancel</button>
+*     </div>
+*   ),
+* });
 * ```
 */
 function useInterrupt(config) {
 	const { copilotkit } = useCopilotKit();
 	const { agent } = useAgent({ agentId: config.agentId });
-	const [pendingEvent, setPendingEvent] = useState(null);
-	const pendingEventRef = useRef(pendingEvent);
-	pendingEventRef.current = pendingEvent;
+	const [pending, setPending] = useState(null);
+	const pendingRef = useRef(pending);
+	pendingRef.current = pending;
 	const [handlerResult, setHandlerResult] = useState(null);
+	const responsesRef = useRef({});
 	useEffect(() => {
-		let localInterrupt = null;
+		let localLegacy = null;
+		let localStandard = null;
 		const subscription = agent.subscribe({
 			onCustomEvent: ({ event }) => {
-				if (event.name === INTERRUPT_EVENT_NAME) localInterrupt = {
+				if (event.name === INTERRUPT_EVENT_NAME) localLegacy = {
 					name: event.name,
 					value: event.value
 				};
 			},
+			onRunFinishedEvent: (params) => {
+				if (params.outcome === "interrupt") localStandard = params.interrupts;
+			},
 			onRunStartedEvent: () => {
-				localInterrupt = null;
-				setPendingEvent(null);
+				localLegacy = null;
+				localStandard = null;
+				responsesRef.current = {};
+				setPending(null);
 			},
 			onRunFinalized: () => {
-				if (localInterrupt) {
-					setPendingEvent(localInterrupt);
-					localInterrupt = null;
-				}
+				if (localStandard && localStandard.length > 0) setPending({
+					kind: "standard",
+					interrupts: localStandard
+				});
+				else if (localLegacy) setPending({
+					kind: "legacy",
+					event: localLegacy
+				});
+				localLegacy = null;
+				localStandard = null;
 			},
 			onRunFailed: () => {
-				localInterrupt = null;
-				setPendingEvent(null);
+				localLegacy = null;
+				localStandard = null;
+				responsesRef.current = {};
+				setPending(null);
 			}
 		});
 		return () => subscription.unsubscribe();
 	}, [agent]);
-	const resolve = useCallback(async (response) => {
+	const submitStandardIfComplete = useCallback(async (interrupts) => {
+		if (!interrupts.every((i) => responsesRef.current[i.id])) return;
+		const expired = interrupts.find((i) => isInterruptExpired(i));
+		if (expired) {
+			console.error(`[CopilotKit] useInterrupt: interrupt ${expired.id} expired at ${expired.expiresAt}; not resuming.`);
+			responsesRef.current = {};
+			setPending(null);
+			return;
+		}
+		const resume = 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: randomUUID(),
+				role: "tool",
+				toolCallId: i.toolCallId,
+				content: JSON.stringify(content)
+			});
+		}
+		responsesRef.current = {};
 		try {
+			return await copilotkit.runAgent({
+				agent,
+				resume
+			});
+		} catch (err) {
+			console.error("[CopilotKit] useInterrupt resolve: runAgent rejected; clearing pending + rethrowing", err);
+			setPending(null);
+			throw err;
+		}
+	}, [agent, copilotkit]);
+	const resolve = useCallback(async (payload, interruptId) => {
+		const current = pendingRef.current;
+		if (!current) return;
+		if (current.kind === "legacy") try {
 			return await copilotkit.runAgent({
 				agent,
 				forwardedProps: { command: {
-					resume: response,
-					interruptEvent: pendingEventRef.current?.value
+					resume: payload,
+					interruptEvent: current.event.value
 				} }
 			});
 		} catch (err) {
 			console.error("[CopilotKit] useInterrupt resolve: runAgent rejected; clearing pending + rethrowing", err);
-			setPendingEvent(null);
+			setPending(null);
 			throw err;
 		}
-	}, [agent, copilotkit]);
+		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
+	]);
+	const cancel = useCallback(async (interruptId) => {
+		const current = pendingRef.current;
+		if (!current) return;
+		if (current.kind === "legacy") {
+			console.warn("[CopilotKit] useInterrupt: cancel() is not supported for legacy on_interrupt interrupts; dismissing.");
+			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]);
 	const renderRef = useRef(config.render);
 	renderRef.current = config.render;
 	const enabledRef = useRef(config.enabled);
@@ -4645,6 +4739,8 @@ function useInterrupt(config) {
 	handlerRef.current = config.handler;
 	const resolveRef = useRef(resolve);
 	resolveRef.current = resolve;
+	const cancelRef = useRef(cancel);
+	cancelRef.current = cancel;
 	const isEnabled = (event) => {
 		const predicate = enabledRef.current;
 		if (!predicate) return true;
@@ -4656,11 +4752,12 @@ function useInterrupt(config) {
 		}
 	};
 	useEffect(() => {
-		if (!pendingEvent) {
+		if (!pending) {
 			setHandlerResult(null);
 			return;
 		}
-		if (!isEnabled(pendingEvent)) {
+		const legacyEvent = toLegacyEvent(pending);
+		if (!isEnabled(legacyEvent)) {
 			setHandlerResult(null);
 			return;
 		}
@@ -4673,8 +4770,11 @@ function useInterrupt(config) {
 		let maybePromise;
 		try {
 			maybePromise = handler({
-				event: pendingEvent,
-				resolve: resolveRef.current
+				event: legacyEvent,
+				interrupt: pending.kind === "standard" ? pending.interrupts[0] : null,
+				interrupts: pending.kind === "standard" ? pending.interrupts : [],
+				resolve: resolveRef.current,
+				cancel: cancelRef.current
 			});
 		} catch (err) {
 			console.error("[CopilotKit] useInterrupt handler threw; result will be null:", err);
@@ -4693,19 +4793,24 @@ function useInterrupt(config) {
 		return () => {
 			cancelled = true;
 		};
-	}, [pendingEvent]);
+	}, [pending]);
 	const element = useMemo(() => {
-		if (!pendingEvent) return null;
-		if (!isEnabled(pendingEvent)) return null;
+		if (!pending) return null;
+		const legacyEvent = toLegacyEvent(pending);
+		if (!isEnabled(legacyEvent)) return null;
 		return renderRef.current({
-			event: pendingEvent,
+			event: legacyEvent,
+			interrupt: pending.kind === "standard" ? pending.interrupts[0] : null,
+			interrupts: pending.kind === "standard" ? pending.interrupts : [],
 			result: handlerResult,
-			resolve
+			resolve,
+			cancel
 		});
 	}, [
-		pendingEvent,
+		pending,
 		handlerResult,
-		resolve
+		resolve,
+		cancel
 	]);
 	useEffect(() => {
 		if (config.renderInChat === false) return;
@@ -4741,9 +4846,9 @@ function useThreadStoreSelector(store, selector) {
 * current without polling — thread creates, renames, archives, and deletes
 * from any client are reflected immediately.
 *
-* Mutation methods (`renameThread`, `archiveThread`, `deleteThread`) return
-* promises that resolve once the platform confirms the operation and reject
-* with an `Error` on failure.
+* Mutation methods (`renameThread`, `archiveThread`, `unarchiveThread`,
+* `deleteThread`) return promises that resolve once the platform confirms the
+* operation and reject with an `Error` on failure.
 *
 * @param input - Agent identifier and optional list controls.
 * @returns Thread list state and stable mutation callbacks.
@@ -4793,21 +4898,32 @@ function useThreads$1({ agentId, includeArchived, limit }) {
 	const headersKey = useMemo(() => {
 		return JSON.stringify(Object.entries(copilotkit.headers ?? {}).sort(([left], [right]) => left.localeCompare(right)));
 	}, [copilotkit.headers]);
+	const runtimeStatus = copilotkit.runtimeConnectionStatus;
+	const threadListEndpointSupported = copilotkit.threadEndpoints?.list !== false;
+	const threadMutationsSupported = copilotkit.threadEndpoints?.mutations !== false;
+	const threadEndpointsUnavailable = !!copilotkit.runtimeUrl && runtimeStatus === CopilotKitCoreRuntimeConnectionStatus.Connected && !threadListEndpointSupported;
 	const runtimeError = useMemo(() => {
 		if (copilotkit.runtimeUrl) return null;
 		return /* @__PURE__ */ new Error("Runtime URL is not configured");
 	}, [copilotkit.runtimeUrl]);
+	const threadEndpointsError = useMemo(() => {
+		if (!threadEndpointsUnavailable) return null;
+		return /* @__PURE__ */ new Error("Thread endpoints are not available on this CopilotKit runtime");
+	}, [threadEndpointsUnavailable]);
+	const threadMutationsError = useMemo(() => {
+		if (threadMutationsSupported) return null;
+		return /* @__PURE__ */ new Error("Thread mutations are not available on this CopilotKit runtime");
+	}, [threadMutationsSupported]);
 	const [hasDispatchedContext, setHasDispatchedContext] = useState(false);
-	const preConnectLoading = !!copilotkit.runtimeUrl && !hasDispatchedContext;
-	const isLoading = runtimeError ? false : preConnectLoading || storeIsLoading;
-	const error = runtimeError ?? storeError;
+	const preConnectLoading = !!copilotkit.runtimeUrl && !threadEndpointsUnavailable && !hasDispatchedContext;
+	const isLoading = runtimeError || threadEndpointsError ? false : preConnectLoading || storeIsLoading;
+	const error = runtimeError ?? threadEndpointsError ?? storeError;
 	useEffect(() => {
 		store.start();
 		return () => {
 			store.stop();
 		};
 	}, [store]);
-	const runtimeStatus = copilotkit.runtimeConnectionStatus;
 	useEffect(() => {
 		copilotkit.registerThreadStore(agentId, store);
 		return () => {
@@ -4821,9 +4937,15 @@ function useThreads$1({ agentId, includeArchived, limit }) {
 	useEffect(() => {
 		if (!copilotkit.runtimeUrl) {
 			store.setContext(null);
+			setHasDispatchedContext(false);
 			return;
 		}
 		if (runtimeStatus !== CopilotKitCoreRuntimeConnectionStatus.Connected) return;
+		if (!threadListEndpointSupported) {
+			store.setContext(null);
+			setHasDispatchedContext(false);
+			return;
+		}
 		const context = {
 			runtimeUrl: copilotkit.runtimeUrl,
 			headers: { ...copilotkit.headers },
@@ -4840,13 +4962,21 @@ function useThreads$1({ agentId, includeArchived, limit }) {
 		runtimeStatus,
 		headersKey,
 		copilotkit.intelligence?.wsUrl,
+		threadListEndpointSupported,
 		agentId,
 		includeArchived,
 		limit
 	]);
-	const renameThread = useCallback((threadId, name) => store.renameThread(threadId, name), [store]);
-	const archiveThread = useCallback((threadId) => store.archiveThread(threadId), [store]);
-	const deleteThread = useCallback((threadId) => store.deleteThread(threadId), [store]);
+	const guardMutation = useCallback((mutation) => {
+		return (...args) => {
+			if (threadMutationsError) return Promise.reject(threadMutationsError);
+			return mutation(...args);
+		};
+	}, [threadMutationsError]);
+	const renameThread = useMemo(() => guardMutation((threadId, name) => store.renameThread(threadId, name)), [store, guardMutation]);
+	const archiveThread = useMemo(() => guardMutation((threadId) => store.archiveThread(threadId)), [store, guardMutation]);
+	const unarchiveThread = useMemo(() => guardMutation((threadId) => store.unarchiveThread(threadId)), [store, guardMutation]);
+	const deleteThread = useMemo(() => guardMutation((threadId) => store.deleteThread(threadId)), [store, guardMutation]);
 	return {
 		threads,
 		isLoading,
@@ -4856,6 +4986,7 @@ function useThreads$1({ agentId, includeArchived, limit }) {
 		fetchMoreThreads: useCallback(() => store.fetchNextPage(), [store]),
 		renameThread,
 		archiveThread,
+		unarchiveThread,
 		deleteThread
 	};
 }
@@ -4889,7 +5020,7 @@ async function recordAnnotation(args) {
 	const body = {
 		type,
 		threadId,
-		clientEventId: args.clientEventId ?? randomUUID(),
+		clientEventId: args.clientEventId ?? randomUUID$1(),
 		...payload !== void 0 ? { payload } : {},
 		...occurredAt !== void 0 ? { occurredAt } : {}
 	};
@@ -5067,7 +5198,7 @@ function useAttachments({ config }) {
 				continue;
 			}
 			const modality = getModalityFromMimeType(file.type);
-			const placeholderId = randomUUID();
+			const placeholderId = randomUUID$1();
 			const placeholder = {
 				id: placeholderId,
 				type: modality,
@@ -7578,7 +7709,7 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 	const existingConfig = useCopilotChatConfiguration();
 	const resolvedAgentId = agentId ?? existingConfig?.agentId ?? DEFAULT_AGENT_ID;
 	const providedThreadId = threadId ?? existingConfig?.threadId;
-	const resolvedThreadId = useMemo(() => providedThreadId ?? randomUUID(), [providedThreadId]);
+	const resolvedThreadId = useMemo(() => providedThreadId ?? randomUUID$1(), [providedThreadId]);
 	const hasExplicitThreadId = !!threadId || !!existingConfig?.hasExplicitThreadId;
 	const { agent } = useAgent({
 		agentId: resolvedAgentId,
@@ -7653,8 +7784,10 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 		hasExplicitThreadId
 	]);
 	const waitForActiveRunToSettle = useCallback(async () => {
-		if (agent.isRunning && isRunCompletionAware(agent) && agent.activeRunCompletionPromise) try {
-			await agent.activeRunCompletionPromise;
+		const maybeAware = agent;
+		const activeRunCompletionPromise = isRunCompletionAware(maybeAware) ? maybeAware.activeRunCompletionPromise : void 0;
+		if (agent.isRunning && activeRunCompletionPromise) try {
+			await activeRunCompletionPromise;
 		} catch (error) {
 			console.error("CopilotChat: in-flight run rejected while queuing send", error);
 		}
@@ -7689,12 +7822,12 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 				}
 			});
 			agent.addMessage({
-				id: randomUUID(),
+				id: randomUUID$1(),
 				role: "user",
 				content: contentParts
 			});
 		} else agent.addMessage({
-			id: randomUUID(),
+			id: randomUUID$1(),
 			role: "user",
 			content: value
 		});
@@ -7711,7 +7844,7 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 	const handleSelectSuggestion = useCallback(async (suggestion) => {
 		await waitForActiveRunToSettle();
 		agent.addMessage({
-			id: randomUUID(),
+			id: randomUUID$1(),
 			role: "user",
 			content: suggestion.message
 		});
@@ -9632,7 +9765,7 @@ function useCoAgentStateRenders() {
 //#region src/context/threads-context.tsx
 const ThreadsContext = createContext(void 0);
 function ThreadsProvider({ children, threadId: explicitThreadId }) {
-	const [internalThreadId, setInternalThreadId] = useState(() => randomUUID());
+	const [internalThreadId, setInternalThreadId] = useState(() => randomUUID$1());
 	const [internalIsExplicit, setInternalIsExplicit] = useState(false);
 	const threadId = explicitThreadId ?? internalThreadId;
 	const isThreadIdExplicit = explicitThreadId != null || internalIsExplicit;
@@ -10093,6 +10226,7 @@ function CopilotKit({ children, ...props }) {
 	const showInspector = shouldShowDevConsole(props.enableInspector);
 	const publicApiKey = props.publicApiKey || props.publicLicenseKey;
 	const renderArr = useMemo(() => [{ render: CoAgentStateRenderBridge }], []);
+	const { onError: _onError, ...v2Props } = props;
 	return /* @__PURE__ */ jsx(ToastProvider, {
 		enabled,
 		children: /* @__PURE__ */ jsx(CopilotErrorBoundary, {
@@ -10101,7 +10235,7 @@ function CopilotKit({ children, ...props }) {
 			children: /* @__PURE__ */ jsx(ThreadsProvider, {
 				threadId: props.threadId,
 				children: /* @__PURE__ */ jsx(CopilotKitProvider, {
-					...props,
+					...v2Props,
 					showDevConsole: showInspector,
 					renderCustomMessages: renderArr,
 					useSingleEndpoint: props.useSingleEndpoint ?? true,
@@ -10400,7 +10534,7 @@ function CopilotKitInternal(cpkProps) {
 		});
 	}, [setAuthStates]);
 	const handleSetRegisteredActions = useCallback((actionConfig) => {
-		const key = actionConfig.action.name || randomUUID();
+		const key = actionConfig.action.name || randomUUID$1();
 		setRegisteredActionConfigs((prev) => {
 			const newMap = new Map(prev);
 			newMap.set(key, actionConfig);
@@ -10586,4 +10720,4 @@ function validateProps(props) {
 
 //#endregion
 export { useAgent as $, INTELLIGENCE_TURN_HEAD as A, CopilotChatToolCallsView as B, CopilotChatToggleButton as C, useCopilotChatConfiguration as Ct, CopilotChatView_default as D, CopilotChat as E, CopilotChatSuggestionPill as F, useLearnFromUserAction as G, useLearningContainers as H, CopilotChatReasoningMessage_default as I, useConfigureSuggestions as J, useThreads$1 as K, CopilotChatUserMessage_default as L, getIntelligenceTurnAnchors as M, IntelligenceIndicatorView as N, CopilotChatAttachmentQueue as O, CopilotChatSuggestionView as P, UseAgentUpdate as Q, CopilotChatAttachmentRenderer as R, CopilotModalHeader as S, CopilotChatConfigurationProvider as St, DefaultOpenIcon as T, useAttachments as U, useLearningContainersInCurrentThread as V, useLearnFromUserActionInCurrentThread as W, useAgentContext as X, useSuggestions as Y, useCapabilities as Z, WildcardToolCallRender as _, useCopilotKit as _t, ThreadsProvider as a, CopilotKitProvider as at, CopilotPopupView as b, AudioRecorderError as bt, CoAgentStateRendersProvider as c, useSandboxFunctions as ct, shouldShowDevConsole as d, MCPAppsActivityType as dt, useHumanInTheLoop as et, useToast as f, CopilotKitInspector as ft, useCopilotContext as g, defineToolCallRenderer as gt, CopilotContext as h, useRenderTool as ht, ThreadsContext as i, useRenderCustomMessages as it, IntelligenceIndicator as j, CopilotChatMessageView as k, useCoAgentStateRenders as l, MCPAppsActivityContentSchema as lt, useCopilotMessagesContext as m, useDefaultRenderTool as mt, defaultCopilotContextCategories as n, useFrontendTool as nt, useThreads as o, createA2UIMessageRenderer as ot, CopilotMessagesContext as p, useRenderToolCall as pt, useInterrupt as q, CoAgentStateRenderBridge as r, useRenderActivityMessage as rt, CoAgentStateRendersContext as s, SandboxFunctionsContext as st, CopilotKit as t, useComponent as tt, useAsyncCallback as u, MCPAppsActivityRenderer as ut, CopilotPopup as v, CopilotKitCoreReact as vt, DefaultCloseIcon as w, CopilotSidebarView as x, CopilotChatAudioRecorder as xt, CopilotSidebar as y, CopilotChatInput_default as yt, CopilotChatAssistantMessage_default as z };
-//# sourceMappingURL=copilotkit-BCxdKlMw.mjs.map
+//# sourceMappingURL=copilotkit-Be-o2UaU.mjs.map